How do I assign Metafields to products in Shopify?
Assigning Metafields to Products in Shopify
Metafields allow you to store additional structured data on your Shopify products (e.g., Platform, Sport, Player, Team, Size Type, etc.). When syncing products between Shopify and eBay, these metafields are used to map eBay item specifics. Missing or empty metafield values are a common cause of listing errors such as "The item specific [X] is missing."
Step 1: Create a Metafield Definition
Before assigning values, you need to define the metafield:
- Go to your Shopify Admin → Settings → Custom data (or "Metafields and metaobjects").
- Click on Products.
- Click Add definition.
- Fill in the details:
- Name: e.g.,
Video Game Platform,Size Type,Player, etc. - Namespace and key: e.g.,
custom.video-game-platform - Type: Choose the appropriate type (e.g., Single line text, List of values, etc.)
- Click Save.
Step 2: Assign a Value to the Metafield on a Product
Once the definition exists, you can assign values to individual products:
- Go to Shopify Admin → Products.
- Open the product you want to edit.
- Scroll to the bottom of the product page — you will find a Metafields section.
- Enter the appropriate value for each metafield (e.g.,
PS2,Regular,LeBron James). - Click Save.
Important: Every product that uses the metafield in an eBay profile must have a valid value assigned. A blank metafield will cause upload errors on eBay.
Step 3: Map the Metafield in Your eBay Profile
To use the metafield value when listing on eBay:
- Open the eBay Integration app and go to your Profile.
- Click Edit Profile.
- In the Attribute Mapping section, find the eBay attribute (e.g., Platform, Size Type).
- Set the source to Shopify Product Metafields and select the corresponding metafield (e.g.,
video-game-platform). - Save the profile and re-upload your products.
Notes
- Storefront visibility: Metafields are not displayed on your storefront by default. To show them on product pages, you need to customize your theme or use Shopify's dynamic source feature in the theme editor.
- Filtering & search: Metafields are not directly searchable or filterable on the storefront. To enable filters (e.g., by Player, Team, Brand), use the Shopify Search & Discovery app and configure filters using your metafields.
- Bulk assignments: For large catalogs, consider using Shopify's bulk editor or automation tools (e.g., Shopify Flow) to assign metafield values across many products at once.
Updated on: 22/05/2026
Thank you!
