Set up CatalogBadge with Ecwid

Ecwid (Lightspeed E-Series) connects with a custom app’s secret token that can only read your catalog. CatalogBadge sends it only to Ecwid’s own API (app.ecwid.com) and reads your products on every update. Nothing is installed in your store and we never write to it.

1. Create a custom app

1. In your Ecwid admin, open Apps, My Apps, then Develop apps and create a custom app named “CatalogBadge”.
2. Give it the access scopes read_catalog and read_store_profile only.
3. Open the app’s details and copy the Store ID (a number) and the Secret token (it starts with secret_). Never use the public token for this.

What we read

• One item per enabled product, with Ecwid’s product id as the id.
• The price a logged-out customer sees in your storefront, with taxes when you show them; your “compare to” price as the regular price when it is higher.
• Your main photo and up to three gallery photos, from Ecwid’s image servers.
• The name and description in your feed’s language when you have translated them, and the brand.

2. Connect the key in CatalogBadge

1. Create your account on app.catalogbadge.com and choose Onboard a store. Add the store with any product feed URL it already has (the wizard checks it and shows sample prices). If it has none yet, write to us and we add the store with you.
2. Open the store, then Connection. Under Connect with a key, pick Ecwid, enter your store address (the https address your shop opens on) and paste Store ID and Secret token.
3. Choose Test and connect. We make one read with the key before saving it; if the read fails, nothing is stored and the page says why.
4. The next update first checks that at least 95 % of the products your feeds already publish keep their ids in Ecwid. Then the store reads Ecwid directly and your feed URLs stay the same. If fewer ids match, the store keeps its feed and the Overview says how many matched.

The key is stored sealed, never shown again, never put in a URL and never logged. To stop, choose Disconnect on the same page, or delete the key in Ecwid: the next update then stops and your published feeds stay exactly as they were.

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.

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.

Questions? Write to hello@catalogbadge.com.