Skip to content
CatalogBadge
Get started

Setup guides

Set up CatalogBadge with ExpandCart

ExpandCart does not yet open its product API to partners, so the way in is your store’s product feed: the link ExpandCart publishes for Google Shopping or for your Meta catalog. CatalogBadge reads it on every update and publishes copies of it in which only the image links change. Nothing is installed in your store and we never write to it. We will add a direct connection when ExpandCart opens its API.

1. Find your product feed link

  1. In your ExpandCart dashboard, open the apps or marketing section and look for the Google Merchant (Google Shopping) or the Facebook catalog app. Install it if it is not on yet.
  2. Copy the product feed link it shows: a URL that ends in an XML or CSV file of your products. If your Meta catalog already reads a link from ExpandCart, that same link works: in Commerce Manager open your catalog, then Data sources, and copy the URL of the scheduled feed.
  3. No link anywhere? Ask ExpandCart support for “the product feed URL of my store for Google Shopping or the Facebook catalog”. Their support answers in Arabic and English.
  4. Open the link in your browser: you should see your products.

ExpandCart is built on OpenCart, so its feeds share OpenCart’s habits. Check two things in the step below: that the sample prices are in your store’s currency, and that a product on offer shows both its regular and its sale price.

2. Add the feed to CatalogBadge

  1. Create your account on app.catalogbadge.com, then choose Onboard a store.
  2. Feed: paste the feed URL and choose Check feed. We read it and show three sample products with their prices, the platform we recognised, and anything Meta would reject. Nothing is saved yet.
  3. Compare the sample prices with your shop. If a price has no currency code in the feed, we use the currency under Prices read as; change it there if the samples look wrong.
  4. Store: confirm the store name, the platform (ExpandCart), country, currency, time zone and the language of the feed.
  5. Template, Brand and QA preview: pick your designs and check your products as finished images.
  6. Feed URLs: copy your feed URLs, then choose Go live.

3. Put your branded feed where your ads read it

Your feed URLs are on your store’s Overview page under Feed URLs, each with a copy button. Treat them like a password: anyone with the URL can read the feed.

Where your ads runFeedWhere to paste it
Meta (Facebook and Instagram)meta-full.xmlCommerce Manager, your catalog, Data sources. If the catalog already reads your store’s feed URL, edit that data source and replace the URL with ours, so your ad sets keep the same catalog. Otherwise add a scheduled data feed with our URL. Steps: Meta guide.
TikToktiktok-full.csvTikTok Ads Manager, Assets, Catalogs: add products with a data feed schedule, set it to hourly and the update method to Replace, so a product that leaves the feed leaves the catalog. Steps: TikTok guide.
Snapchatsnap-full.xmlSnapchat Ads Manager, Catalogs: add a product source with a scheduled feed URL and a daily schedule. Steps: Snapchat guide.
Pinterestpinterest-full.xmlFirst turn on the Pinterest 2:3 size in Rules, under Sizes and language. Then in Pinterest Ads, Catalogs, add a data source with our URL. Pinterest reads it once a day. Steps: Pinterest guide.

Each platform picks up the branded images on its next fetch; the first one can take a few hours. Never delete and re-create a catalog to switch: your ads keep pointing at the old one.

4. When your feed is missing a field

Your feed has no…What happensWhat to do
Sale price (sale_price)Images show the price without a discount badge. We never work out a discount the feed does not state.Use a feed or extension that writes the regular price in price and the offer in sale_price.
Currency code on the pricePrices are read in the currency you confirm in the wizard.Make sure the feed’s prices really are in your store’s currency: compare the sample prices with your shop.
ID, title, link, photo or a readable priceThat product keeps its original image in our feeds, so your catalog never loses it.Fill the field in your store; the next update picks it up.
Standard column namesWe do not guess which column is the price, because a wrong guess puts a wrong price on an image.Open the Column map on your store’s Overview page and say which column holds each field (input feeds).
AvailabilityProducts count as in stock.Add availability if you sell out often.
Brand, GTIN or MPNImages are made as usual; Meta warns that it needs one of them.Add a brand to your products; your store name works for your own goods.

Feed problems specific to OpenCart-based stores are in the OpenCart guide. Questions? Write to hello@catalogbadge.com.