Skip to main content

Assign Product Materials to Etsy Listings Transferred from Shopify

Shuttle can fill in the materials on the Etsy listings it creates from your Shopify products. It can read them from a Shopify metafield, use default materials you set once for every listing, or combine the two.

Where to find the Product Materials settings

  1. In Shuttle, go to Settings → Products → Shopify → Etsy.

  2. Open the Product Materials section. The side menu calls it Materials. You can also go there directly.

  3. Fill in Shopify metafield key for materials, Custom default materials, or both, then click Save.

Take materials from a Shopify metafield

The Shopify metafield key for materials setting suits shops that already store each product's materials in a Shopify metafield.

  1. In Shopify metafield key for materials, enter the metafield key exactly as it appears in Shopify, for example custom.materials. The key alone, such as materials, also works.

  2. In Shopify, list the materials in the metafield separated by commas, for example Cotton, Silk, Leather. A metafield that holds a list of single-line text also works.

If you don't use a metafield for materials, leave Shopify metafield key for materials empty.

Set default materials for every listing

The Custom default materials setting gives every transferred listing the same materials. Enter your materials in Custom default materials separated by commas, for example Cotton, Polyester, Silk.

Which materials Shuttle uses for a listing

A product's metafield takes priority over the default materials:

  • If a product's metafield has a value, Shuttle uses it and ignores the default materials.

  • If the metafield is empty for that product, or you didn't set a metafield key, Shuttle uses the default materials.

Why a material is missing from an Etsy listing

Shuttle tidies up your materials before sending them to Etsy, and some can be dropped along the way:

  • Symbols and punctuation are removed, so only letters, numbers and spaces stay.

  • A material with an accented or non-English letter, such as é or ü, is left off.

  • Each material must be under 45 characters. Longer ones are left off.

  • Duplicates are removed, even if their capital letters differ.

  • Only the first 13 materials are kept.

To get a missing material onto the listing, check it against these rules and change it in Shopify or in Custom default materials.

Did this answer your question?