We sync our catalog with a json file using the web link in catalog. I have added a new additional field into our json file to sync with an existing catalog. The field isnt pulling into the Klaviyo catalog. I have tried syncing the catalog and ‘Update Field Mapping’ and neither seem to pull the field into the catalog field listing.
I have searched the klaviyo help but can’t see anything that would help troubleshoot this. Can you suggest anything for me to look at?
The catalog is a public, hosted feed of all the items in your catalog.
If you do not have your own feed hosting location, you can use a service such as Google Merchant feeds.
The feed is in JSON or XML. Check out an example feed in JSON and an example feed in XML.
The data in the feed is only one node deep, not nested JSON or XML (unless it is hosted on Google Merchant Feeds).
The size of any one feed file should not exceed 100 MB; for optimal performance, we recommend each feed file not exceed 50 MB. If your file exceeds this amount, please split the feed into multiple files. All files used as sources will feed into the same catalog in Klaviyo.
Required fields must not be left blank. For unavailable numeric fields, pass a zero (0), and for unavailable text fields, pass something indicating this such as “n/a” or “unavailable”.
If your feed is hosted with a caching layer, disable caching for the location where the feed is hosted or refresh this cache when the feed is updated. Otherwise, Klaviyo will only pull updated data for the feed items after the cache is refreshed.
If the above all looks correct with your feed, a few other things to consider:
Feed update time - I don’t remember how frequently the feed updates, but it may take time assuming you were checking right away.
Make sure your feed isn’t cached on your server or where the product feed is sourced - sometime that’s implicit on platforms (e.g. Shopify) or DNS proxies (Cloudflare) or web servers (Varnish, ElasticCache, etc).
Finally, if all else fails, if it’s possible, try deleting the source and re-adding it and re-mapping the fields (including the new ones).
The catalog is a public, hosted feed of all the items in your catalog.
If you do not have your own feed hosting location, you can use a service such as Google Merchant feeds.
The feed is in JSON or XML. Check out an example feed in JSON and an example feed in XML.
The data in the feed is only one node deep, not nested JSON or XML (unless it is hosted on Google Merchant Feeds).
The size of any one feed file should not exceed 100 MB; for optimal performance, we recommend each feed file not exceed 50 MB. If your file exceeds this amount, please split the feed into multiple files. All files used as sources will feed into the same catalog in Klaviyo.
Required fields must not be left blank. For unavailable numeric fields, pass a zero (0), and for unavailable text fields, pass something indicating this such as “n/a” or “unavailable”.
If your feed is hosted with a caching layer, disable caching for the location where the feed is hosted or refresh this cache when the feed is updated. Otherwise, Klaviyo will only pull updated data for the feed items after the cache is refreshed.
If the above all looks correct with your feed, a few other things to consider:
Feed update time - I don’t remember how frequently the feed updates, but it may take time assuming you were checking right away.
Make sure your feed isn’t cached on your server or where the product feed is sourced - sometime that’s implicit on platforms (e.g. Shopify) or DNS proxies (Cloudflare) or web servers (Varnish, ElasticCache, etc).
Finally, if all else fails, if it’s possible, try deleting the source and re-adding it and re-mapping the fields (including the new ones).
Hi @tessa - I would recommend checking out our new Catalog API (https://developers.klaviyo.com/en/v2022-09-07.pre/reference/get_catalog_items) which was meant to enable partners, customers, and freelance developers to easily manage custom catalogs as well as utilize the up-to-date data to populate product feeds, campaigns, and flow messages for enhanced targeting.
