Metafields
The Metafields settings allow you to customize the data structure of your store. While Soppiya provides standard fields (like Price, Description, and SKU), most businesses require specific data points unique to their industry—such as "Expiration Date" for food, "Fabric Material" for clothing, or "ISBN" for books.
Metafields effectively act as custom form fields, allowing you to store, retrieve, and display this specialized information on your storefront.
Location: Content → Metafields
Metafields Overview
The Metafields landing screen is the control center for all custom data definitions.
-
Resource List: When you open Content → Metafields, you’ll see a list of supported resources. Metafields are resource‑scoped, meaning each metafield belongs to exactly one resource type and cannot be reused globally. Examples of resources include Product, Variant, Order, and Customer.
-
Definitions Table: Once you select a resource, the main area displays the current configuration.
- New Setup: If you have not created any fields yet, this list will be empty.
- Existing Fields: If fields exist, the table displays their Definition Name (internal label) and Content Type (data format). A search bar, filters, and sorting controls are available at the top to help manage larger sets of metafields.
Supported Resource Types
Before creating a field, you must select where that field should live. Click on one of the resources below to begin managing its fields.
| Resource | Best Used For... |
|---|---|
| Product | Technical specs, washing instructions, release dates. |
| Variant | Specific details for a size/color (e.g., distinct weight). |
| Collection | Promo text or banner images for specific categories. |
| Customer | Birthdays, loyalty tier, skin type preferences. |
| Order | Delivery instructions, gift wrap messages. |
| Article / Blog | Author profiles, "Reading Time" estimates. |
| Page | Custom SEO tags or team bios. |
| Location | Warehouse codes or manager contact info. |
| Market | Region-specific pricing notes or legal disclaimers. |
Creating a New Metafield Defination
To add a new data field to a resource:
- Select the Resource (e.g., Product).
- Click the button in the top right corner.
- Complete the configuration form detailed below.
Configuration Settings
These settings define how the system handles your data.
| Setting | Function & Rules |
|---|---|
| Name | The Display Label. This is what you see in the Admin panel. Keep it short and clear (e.g., Wash Instructions). |
| Namespace & Key | The System ID. Used by the API to find data. It auto-generates based on your Name, but you can manually edit it before saving. Limitation: Once saved, this ID is locked and cannot be changed. |
| Select Type | The Data Format. Defines what input is allowed. Examples: • Text (Words) • Integer (Whole numbers) • Date (Calendar picker) • Boolean (Yes/No switch) • Color (Color picker) |
| Value Type | The Quantity. • Single: Holds one value (e.g., "Cotton"). • Multiple: Holds a list of values (e.g., "Cotton", "Polyester"). |
| Public Access | The Visibility. • Enabled: Visible to the storefront/customers. • Disabled: Internal admin use only. |
Be careful when choosing between Text and Number. If you want to use the data for calculations (e.g., "Weight" or "Package Count"), you must use Number. You cannot perform math on a Text field, even if it only contains numbers.
Click button to create the definition.
Filtering and Viewing
As your store grows, you may manage dozens of fields. The Definitions Page includes filtering options to help you organize your view.
- Click and select Type.
- Choose one or more desired content types from the list (e.g., Date, Boolean, Reference).
- The list updates instantly.
Resetting: To see all fields again, click Clear all right side of the filter menu.
Managing Existing Metafields Definations
Editing a Metafield Defination
Click on any Metafield Defination Name in the list to open its details.
- Editable: You can update the Name and Public Access settings at any time.
- Locked: To ensure data integrity, you cannot change the Namespace, Content Type, or Value Type once created.
Deleting a Metafield Defination
To remove a field that is no longer needed:
- Open the metafield details page.
- Click the button.
- Confirm the action.
Deleting a metafield definition is permanent. It will immediately erase all data associated with that field across all your products, pages, or customers. This action cannot be undone.
How to Input Data
Creating the definition (Steps 1-2) only builds the form. To use it, you must navigate to the specific item you want to update.
Example: Adding data to a Product
- Navigate to Products in your admin menu.
- Click on a specific product (e.g., Blue T-Shirt).
- Scroll to the bottom of the page to find the Metafields section.
- Enter the specific value into your custom field (e.g., select a date or type text).
- Click button.
Simply entering the data here does not automatically show it on your website. To display this information to customers, you must go to the Theme Editor and connect a text or image block to this dynamic source.