Background

The Shopify Storefront API no longer supports retrieving all metafields in Version 2023-01 and later without sending additional filter arguments to specify metafields to return by namespace. To work around this and retrieve all metafields, Nacelle utilizes the Shopify Admin API (in addition to the Shopify Storefront API) for indexing products from Shopify.

Requirements

• Enter the Shopify Admin API Access Token in the Nacelle Shopify Connector Settings. The Admin API Access Token can be found in the Shopify Custom App settings in the 'API Credentials' tab but will only be revealed once when the app is initially installed in Shopify. If you do not have the Admin API Access Token saved, we recommend creating a new custom App in Shopify and updating the connector settings in Nacelle with the new Storefront Access Token and Admin Access Token. Generally the admin access token starts with shpat_
  
• Confirm that the Admin API Config for the app in Shopify has the following:
  • Admin API Access Scopes - read_products
  • Webhook version: 2023-01

Metafield Setup in Shopify

• Metafields in Shopify need to have definitions to be available in the Admin API. This is managed in Shopify Settings>> Custom data.
  • A definition is always required when creating a custom metafield the standard way (without an app such as Accentuate).  
    
• Metafields also need to have the 'Storefronts' option checked in the Access Options.
  
• If using an app such as Accentuate Custom Fields, then the metafields may be missing definitions initially. This can be identified in the 'Metafields without a definition' tab with a button to Add definition. Ensure that definitions are created and that the 'Storefronts' option is selected in the Access Options. Additionally be sure to follow any specific guidelines for keeping app data and metafields in sync (ie. same field type).