TABLE OF CONTENTS

Shopify Metafields can be used in a number of different ways in Omnivore.  From populating eBay item specifics and Amazon bullet points through to having a different description that can be used on the marketplaces.


For Shopify/eBay AU sellers Metafields in Shopify can be used to allow Calculated Shipping which requires dimension data (width, height, length). 


You can also add additional images in Shopify using Metafields, Omnivore can pull in these images along side your product images.  With images, Omnivore also has a setting that allows you to ONLY use the metafield images from Shopify.  See the last section of this FAQ.


We have provided some Shopify 'How To' steps below, we do recommend also referring to the Shopify documentation as the best source of knowledge.  Regarding Shopify Metafields these two Shopify articles will also help:


  1. https://help.shopify.com/en/manual/custom-data/metafields/metafield-definitions/metafield-types
  2. https://help.shopify.com/en/manual/custom-data/metafields/metafield-definitions/metafield-lists



Creating Shopify Metafields

Metafields are created in Shopify under Settings - Metafields


You can create different types of metafields in Shopify.  The ones we use in Omnivore are 'Product' and 'Variant' metafields.


Click on either Products or Variants to create a new Metafield.  (If you are creating width, length, height dimensions to be used for shipping please use Products)


Click on 'Add Definition' to add a new metafield.


Enter a Name, Namespace and key and Description.  Namespace and key is what will be shown in Omnivore when mapping fields.  It is a good idea to have the first part of the name indicating the use for the metafield (in the example below the metafield is for use in the Iconic integration).


Click on Select content type.


For general Text fields select 'Text' for image urls select URL.  Please see the section below on using Shopify Metafields for Images with Omnivore.


NOTE: When adding metafields to be used for Amazon attributes ensure the case shown in the namespace and key field matches the case expected for Amazon attributes. For more information on using Metafields for Amazon attributes click here.


Dimension Metafields for Shipping


When you setup metafields for dimensions the content type must be 'Number' (integer).  See image below as a guide.

You can only add numbers so on the product in Shopify successfully added dimension data that can be used for Shipping will look like this:

After this is setup you will need to 'Enable Shopify Metafields' in Omnivore (scroll down in this article), then 'Map Shopify Metafields' in Omnivore (also see below).

Successfully mapped fields in Omnivore will look like this:



Continue to follow this FAQ to setup Calculated Shipping for eBay.


Adding values to Shopify Metafields on products


Once you have created your metafields you can then enter values into them on the product edit page in Shopify.  


'Product' Metafields are visible at the bottom of the Edit product page in Shopify.  Click on the 'View All' link if the metafields you want to use are not visible.


'Variant' metafields are visible when clicking on the 'Edit' button on a Variant.

Enabling Shopify Metafields in Omnivore


By default access to Shopify metafields in Omnivore is not enabled.  To enable this go to Settings - Shopify Feed - General and then check the 'Shopify Metafields' checkbox.





Mapping Shopify Metafields in Omnivore

Once Shopify metafields are enabled in Omnivore, go to your Omnivore Dashboard and click the Import from Shopify button.


Note: The dashboard's import and upload buttons should only be used in specific cases. For more details and the effects of creating manual import and upload jobs, refer to this support article.


Please keep in mind that full import and upload jobs can take several hours, days, or even weeks to complete if you have hundreds of thousands of products.


After the import is complete, you can map the metafields in Omnivore to pull this data in to your Omnivore products.


In Omnivore go to Settings - Shopify Feed - Map Fields


From left to right view the Omnivore Data Fields and Select your store data value from the field dropdown options.



Using Metafields in Product Actions


Metafields can be used in product actions to change listing details such as product titles and descriptions.  You will need to make sure that the metafields you want to use are mapped across to the product attributes box in the Map Fields screen in Omnivore.


When referring to metafield names in your product actions you only refer to 'key' part of the metafield name.  You also need to remove any of the '_' in the metafield name.  For example if your metafield name is Amazon.product_title, you would refer to this in the product actions as $producttitle.  Or in the case of a description and your metafield was custom: ebay_description in the product action you would use $ebaydescription


Go to Products - Product Actions and either edit or create a new Detailed Product Description Action applying your metafield tag based on the above suggestions.


Example


Using Shopify Metafields for Images


After you are setup to use Metafeilds in Shopify and Omnivore, with images you have the option to only use the Metafield Images and not your product images.  By default we will import your product images and metafield images.


If you want Omnivore to ONLY import Metafield Images navigate to Settings - Shopify Feed - General within Omnivore.

Scroll down under Product Import until you see Ignore Product Image.

If you tick this option we will only bring in your Metafield images, all other products images will be ignored.

Making a change like this requires an Import from Shopify, it is also good to monitor your products in Omnivore after this change to ensure the images have come in correctly.