Metafields
Metafields are custom extra fields that let you add your own information to products, categories, orders, customers, pages or variants that SELLERLOGIC Commerce Services doesn't offer by default — for example "Material", "Manufacturer warranty", or "Internal reference number".
What can I do here?
- Create new metafield definitions (e.g. a text field "Material" for products)
- Filter and search definitions by entity type
- Decide whether a field is required or pinned (always visible)
- Edit or delete existing definitions
Step by step
- Click "Create definition".
- Enter a namespace (e.g.
custom) and a key (e.g.material) — both may only contain lowercase letters, numbers and underscores. - Choose a descriptive name and, optionally, a description.
- Select the entity type (Product, Category, Order, Customer, Page, or Variant) and the value type (e.g. text, number, date, color, reference).
- Decide whether the field is required and/or pinned, and set the sort order.
- Click "Create definition" — the field then appears in the relevant forms for that entity.
Fields explained
| Field | Meaning | Notes/Impact |
|---|---|---|
| Namespace | Grouping of the field | Lowercase letters, numbers, underscores only; not editable after creation |
| Key | Technical identifier of the field | Also a–z, 0–9, _ only; not editable after creation |
| Name | Display name of the field | Freely editable |
| Description | Explanatory help text | Optional |
| Entity type | What the field attaches to (Product, Category, Order, Customer, Page, Variant) | Not editable after creation |
| Value type | Data type of the field value (Text, Number, Date, Boolean, Color, Reference, List, …) | Not editable after creation |
| Required | Field must be filled in when editing the entity | Enforces complete data |
| Pinned | Field is always shown prominently on the entity page | Makes important extra fields easier to find |
| Sort order | Order of display among multiple metafields | Lower number = shown higher up |
Values & statuses
Entity type
| Value | Plain meaning |
|---|---|
| Product | Field appears on the product |
| Category | Field appears on the category |
| Order | Field appears on the order |
| Customer | Field appears on the customer record |
| Page | Field appears on a CMS page |
| Variant | Field appears on a product variant |
Value type (selection)
| Value | Plain meaning |
|---|---|
| Single-line text / Multi-line text / Rich text | Text fields of different length/formatting |
| Integer / Decimal | Numeric fields |
| Boolean | Yes/No toggle |
| Date / Date & time | Time values |
| URL / Email / Phone | Formatted text fields with validation |
| Color | Color picker |
| JSON | Structured raw data |
| Rating | Star rating |
| Dimension / Weight / Volume / Money | Fields with a physical or monetary unit |
| Reference / File reference | Link to another object or file |
| Text list / Number list | Multiple values in a list |
Frequently asked questions
Can I change the namespace, key or entity type later?
No, these three settings are fixed once created, since they're technically tied to already-stored values. Name, description, required/pinned and sort order can be changed at any time.
What happens when I delete a definition?
Deleting a metafield definition also irreversibly removes all values already stored for that field.
What is "Pinned" good for?
Pinned fields are shown prominently and permanently on the entity page instead of in a collapsed list — useful for particularly important extra information.