Required Shopify fields

Required Shopify fields

Before a product can go to Amazon, two fields must be filled in on the Shopify side: the product's Brand (vendor) and its Description. Until both are saved, the app will not let you select the product on the Product Sync list, and the product detail page stays locked.

This is deliberate, and it is one of the few places where the app is strict rather than helpful.

Why the app blocks you

Amazon rejects listings that arrive without a brand and without a description. If the app let the push through anyway, you would get a submission that failed several minutes later, an Issues badge, and no listing. Blocking early is a shorter path to a working listing than letting you push and then explaining the rejection.

The other reason is that Shopify stays the single source of truth. Your Shopify product page is where the content lives. Filling these fields in Shopify means they are correct everywhere: on your storefront, on Amazon, and in any future marketplace you add.

What the merchant sees

On the Product Sync list, a product missing either field shows a Required fields missing state. Its tick box is disabled, so it cannot be included in Push selected or Sync all, and the push action is replaced by a Set required fields button that takes you to the product.

On the product detail page, a banner at the top names exactly which fields are still missing. While that banner is showing, the page is hard-locked:

  • The AI tools (Translate, Spell-check, and the add-on tools) are disabled.
  • Apply and save is disabled.
  • Push is disabled.
  • The Amazon-side inputs in the attribute table are disabled.

Only the Shopify column and Save to Shopify stay active. That is intentional: the page gives you exactly one thing you can do, which is the thing that unblocks everything else. Hovering a disabled control shows a tooltip explaining that the required Shopify fields must be saved first.

Fixing them

You have two routes, and both write to the same place.

In Shopify

Open the product in your Shopify admin. Set the Vendor field, which is what Amazon calls the brand, and write a product Description. Save. Return to the app and refresh the product.

In the app, from the Shopify column

You do not have to leave the app. On the product detail page, the attribute table's Shopify column is editable for these fields. Type the brand and the description there, then click Save to Shopify. The app writes the values back into your Shopify product, exactly as if you had typed them in the Shopify admin. The lock lifts and the AI tools, Apply and save and Push all become available.

Note

Save to Shopify is not the same as Apply and save. Save to Shopify changes your actual Shopify product. Apply and save stores an Amazon-only override that does not touch Shopify. See Reviewing a product.

Tip

The brand you put in Vendor should be the real brand name of the product, not your shop name, unless you genuinely are the brand. Amazon compares it against its brand registry, and a mismatched brand is a common source of listing errors.

Amazon's own required attributes

Brand and Description are the app's gate. Amazon has a second, larger set of requirements that depends on the product type you mapped for the category. See Amazon product types.

Once a product type is set, the app fetches Amazon's schema for that type and checks your product data against it. If Amazon insists on an attribute that nothing in your Shopify data supplies, you will see a warning like:

{n} required attribute(s) missing

and, when you attempt a push:

Missing required attributes: {fields}. Provide them via Shopify data or Field mapping (Product Sync settings).

The list of missing attributes is shown against the product, so you can see exactly what Amazon wants. These are things like a material, a colour, a size, a department, a part number or an item type keyword, and which ones apply depends entirely on the product type and the marketplace.

Supplying them

There are three practical ways to satisfy a missing required attribute.

  1. Put the data in Shopify where the app already looks for it. If Amazon wants a colour and your variants have a Colour option, the data is already there.
  2. Point the attribute at a different source with Field mapping. You can map an Amazon attribute to a product field, a variant field, a Metafield such as custom.material, or a Static value. A static value is the fastest fix when the answer is the same for every product in the category, for instance a department of "unisex-adult".
  3. Enter it on the product on the detail page, then Apply and save so the value is stored as an override for that market.

Field mapping is usually the right answer, because it fixes the attribute for your whole catalogue rather than one product at a time.

Related articles

    • Related Articles

    • Mapping Shopify markets to Amazon marketplaces

      Shopify has markets. Amazon has marketplaces. Settings > Markets is where you tell Amazon Seller Sync how the two line up, so the app knows which Amazon price belongs to which of your shoppers. There are two separate things on this tab, and they do ...
    • Amazon product types

      If you have pushed products and nothing appeared on Amazon, this is almost certainly why. Amazon requires a product type on every listing, and the app will not guess one for you. A product type is Amazon's way of saying what kind of thing you are ...
    • Product Sync

      Product Sync takes the products that already exist in your Shopify store and publishes them to Amazon as real, live listings. You do not retype anything into Seller Central. Shopify stays the place where you write and maintain your product content, ...
    • Field mapping

      Field mapping is where you tell the app which piece of Shopify data feeds each Amazon attribute. It is opened from the Sync settings card on Product Sync, and it applies to your whole catalogue. Most merchants never need to touch it. The defaults are ...
    • Reviewing a product

      Clicking Review on a row in Product Sync opens the product detail page. This is where you look closely at one product before it goes to Amazon, or after Amazon has said something about it. Everything you need for that one listing is on this page: the ...