---
url: https://docs.youcan.shop/store-admin/entities/metafield.md
---
# Metafield entity

The Metafield entity at YouCan.

Metafields allow storing custom key-value data on any resource (products, orders, customers, etc.).

| Attribute Name | Type | Description |
| --- | --- | --- |
| id | string | Identifier |
| namespace | string | Logical grouping for the metafield (e.g. `"reviews-app"`) |
| key | string | Key within the namespace (e.g. `"rating"`) |
| value | string | Stored value |
| type | string | Value type (e.g. `"number"`, `"string"`, `"json"`) — corresponds to the `value_type` input parameter |

## Notes

* When creating, the input parameter is named `value_type`; the response returns the same value under `type`.
* The namespace + key combination is unique per resource. See the [create endpoint](../metafields/crud.md) for upsert behavior.