Skip to content

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:

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.

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 typeItem specific value
Single line text, multi-line text, rich textThe text
Integer, decimalThe number
True or falseYes or No
Date, date and timeThe date as Shopify stores it, e.g. 2026-10-20
Color, URL, IDThe value
LinkThe link’s text, or its URL without text
Weight, dimension, volumeThe value and unit, e.g. 2.5 kg
MoneyThe amount and currency, e.g. 5.99 USD
RatingThe rating, e.g. 4.5
Product, variant, collection referenceThe referenced item’s title
Metaobject referenceThe metaobject’s display name
Product category value referenceThe 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.

If the details you need aren’t in Shopify yet, add a metafield definition for products:

  1. In Shopify admin, go to Settings → Metafields and metaobjects → Products
  2. Click Add definition
  3. Name it, for example Model number, and choose a type, for example Single line text
  4. 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.

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.

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:

  1. The product’s mapped metafield or vendor
  2. The value set on the product
  3. The collection’s mapped metafield or vendor
  4. The value set on the collection
  5. 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.

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 specificValue on eBayWhy
ModelThe product’s model numberThe product maps it
TypeDSLRThe product’s own value comes before the collection’s
BrandThe product’s vendor, e.g. CanonThe product leaves it empty, so the collection’s mapping fills it

Check that:

  1. The metafield, or the vendor, has a value on that product in Shopify
  2. The value is one eBay allows for the item specific, and no longer than 65 characters
  3. For a metafield that references metaobjects, the store has approved the updated permissions
  4. For a collection’s mapping, the product is listed in the collection’s eBay category

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.