Filling item specifics from Shopify metafields
eBay asks for item specifics, like Brand, Model or Color, when you list a product. They help buyers find your listing, and some categories require them. Most of these details already live in Shopify, as the product’s vendor or in its metafields.
Mapping an item specific to a metafield tells Inventoree where to find its value. When a product is imported to eBay, the value is read from that product in Shopify, so each product is listed with its own model number, color or brand.
You can map item specifics in two places:
- On a collection, for every product in it. See Grouping products with collections.
- On a single product, on the import page. See Importing Shopify products to eBay.
What can be mapped
Section titled “What can be mapped”The product’s vendor
Section titled “The product’s vendor”The Vendor of a Shopify product is listed under Shopify product. It suits item specifics like Brand or Manufacturer, and it needs no setup in Shopify.
Product metafields
Section titled “Product metafields”Metafields are custom fields you add to products in Shopify. Any product metafield definition in your connected Shopify stores can be mapped, as long as its type can be turned into text:
| Metafield type | Item specific value |
|---|---|
| Single line text, multi-line text, rich text | The text |
| Integer, decimal | The number |
| True or false | Yes or No |
| Date, date and time | The date as Shopify stores it, e.g. 2026-10-20 |
| Color, URL, ID | The value |
| Link | The link’s text, or its URL without text |
| Weight, dimension, volume | The value and unit, e.g. 2.5 kg |
| Money | The amount and currency, e.g. 5.99 USD |
| Rating | The rating, e.g. 4.5 |
| Product, variant, collection reference | The referenced item’s title |
| Metaobject reference | The metaobject’s display name |
| Product category value reference | The value’s name, e.g. Black |
List metafields of these types work too, each item in the list is one value. File, page, customer and other references can’t fill item specifics, so they aren’t offered.
Shopify’s own category metafields, like Color (shopify.color-pattern) or Material, are metaobject references. Shopify offers them for the product category you choose in Shopify, and you can map them as well.
Creating a metafield in Shopify
Section titled “Creating a metafield in Shopify”If the details you need aren’t in Shopify yet, add a metafield definition for products:
- In Shopify admin, go to Settings → Metafields and metaobjects → Products
- Click Add definition
- Name it, for example Model number, and choose a type, for example Single line text
- Save the definition
Each product page in Shopify now has the field in its Metafields section. Fill it in for your products, and map the item specific to it in Inventoree. Definitions you add show up in the Map metafields list within a few minutes.
A metafield is known by its namespace and key, like custom.model_number. If several of your stores have a definition with the same namespace and key, one mapping works for all of them. The list shows the stores that have a definition when not all of them do.
How mapped values become item specifics
Section titled “How mapped values become item specifics”When a product is imported, Inventoree loads its vendor and the metafields that are mapped, and then:
- One value or several: an item specific that takes one value gets the first value of a list metafield. One that takes several gets up to 30.
- eBay’s allowed values: when eBay only allows certain values for an item specific, the metafield’s value is used only if it’s one of them. Upper and lower case don’t matter.
- Length: eBay allows item specific values of up to 65 characters, and some item specifics allow fewer. Longer values are left out.
- Variations: when a product’s variants differ by an option with the same name as an item specific, for example Color, eBay takes that item specific from each variant instead.
A value that’s left out, or a metafield that’s empty on the product, falls back to the next value in the order below.
Which value is used
Section titled “Which value is used”Item specifics can be set or mapped on the product and on its collection. For each item specific, the first of these that has a value is used:
- The product’s mapped metafield or vendor
- The value set on the product
- The collection’s mapped metafield or vendor
- The value set on the collection
- A value eBay fills in from the product’s title and details
Steps 1 and 2 apply when you set the product’s eBay details on the import page. Steps 3 and 4 apply when the product is listed in its collection’s eBay category. If you choose a different category for the product, the collection’s item specifics don’t apply to it.
Example
Section titled “Example”The Cameras collection lists its products in Digital Cameras. It maps Brand to the vendor, and sets Type to Mirrorless.
On the import page, the Canon EOS R50 is also listed in Digital Cameras. It maps Model to its Model number metafield and sets Type to DSLR.
| Item specific | Value on eBay | Why |
|---|---|---|
| Model | The product’s model number | The product maps it |
| Type | DSLR | The product’s own value comes before the collection’s |
| Brand | The product’s vendor, e.g. Canon | The product leaves it empty, so the collection’s mapping fills it |
Troubleshooting
Section titled “Troubleshooting”A mapped value didn’t appear on eBay
Section titled “A mapped value didn’t appear on eBay”Check that:
- The metafield, or the vendor, has a value on that product in Shopify
- The value is one eBay allows for the item specific, and no longer than 65 characters
- For a metafield that references metaobjects, the store has approved the updated permissions
- For a collection’s mapping, the product is listed in the collection’s eBay category
A metafield isn’t in the list
Section titled “A metafield isn’t in the list”The list only has product metafield definitions with a type from the table above. Metafields without a definition in Shopify can’t be mapped, so create one for them first.
The import failed loading the product’s metafields
Section titled “The import failed loading the product’s metafields”If Shopify couldn’t be reached while the product was imported, the import stops with Couldn’t load the product’s metafields from Shopify. Import the product again.
Need help?
Section titled “Need help?”- Contact our support team at support@inventoree.io