Skip to content
CatalogBadge

Setup guides

Set up CatalogBadge with Wix

The CatalogBadge app connects your Wix Stores products to CatalogBadge with nothing to copy or paste. It reads your products, variants, photos, prices and ribbons, and never changes anything on your site or in your ad accounts. The app is free to install; your CatalogBadge plan is billed on catalogbadge.com in US dollars.

1. Install the app

  1. Sign in to Wix as the site’s owner and open the Wix App Market. Search for CatalogBadge and choose Add to Site.
  2. Pick the site with your store. Wix lists what the app may do: read your products and see basic site details. Choose Agree & Add.
  3. Wix opens CatalogBadge in a new tab. Sign in, or create an account and start the free trial, then choose Connect the store.

The store is added as a draft and its first sync starts. Your dashboard shows your products as they will look, and the feed links once the images are ready. Later, open CatalogBadge from Apps in your Wix dashboard to go straight to your store.

What the app reads

  • Every visible product and variant. Each variant is its own item, and all variants of a product share one item_group_id, so Meta groups them. A variant with its own photo (a colour, for example) uses it.
  • Prices. When a product has a discount, the original price is the price and the discounted price the sale_price, so images show the discount badge.
  • Ribbons. A ribbon such as “Sale” or “New” comes through as custom_label_0, so you can use it in a rule or a Meta product set.
  • Hidden products, and products without a photo or a price, are left out. So is every product while the site is unpublished, because a product only has a page link once the site is published: publish your site before you connect it.

Only the site’s owner can connect it. If you work on the site as a collaborator, ask the owner to open CatalogBadge from Apps.

2. 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.

3. When a field is missing

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.

Uninstalling

Removing the app in Wix stops CatalogBadge reading your products. Your feeds stay online as they were, so your ads keep running, until you pause or delete the store in CatalogBadge. Adding the app again picks up the same store.

Until the app appears in the App Market, you can still connect a Wix store with a product feed URL from a feed app: see any other platform. Questions? Write to hello@catalogbadge.com.