Set up CatalogBadge with Shopware 6

Shopware 6 connects with an integration: an access key pair you create once with read access to your catalog. CatalogBadge then reads your storefront’s products directly on every update. Nothing is installed in your shop and we never write to it.

1. Create a read-only integration

1. In the Administration, open Settings, System, Users & permissions, tab Roles, and add a role “CatalogBadge read”. Give it Viewer on Products, Sales channels, Currencies and Languages, nothing else.
2. Open Settings, System, Integrations and choose Add integration. Name it “CatalogBadge”, leave Administrator off and assign the role from step 1.
3. Copy the Access key ID and the Secret access key before you save: Shopware shows the secret only once.

What we read

• The products visible in your storefront sales channel: the one whose domain is the store address you enter, else your first storefront.
• One item per variant (and per product without variants), with the product number as the id, as Shopware’s own Google Shopping export writes it, and the parent’s number as the group.
• The gross price in the channel’s currency; when a list price is higher, it is the regular price and the gross price is the sale price.
• The cover photo and up to three more, the manufacturer, availability, and the name in your feed’s language when the shop has it.

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 Shopware 6, enter your store address (the https address your shop opens on) and paste Access key ID and Secret access key.
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 Shopware 6. Then the store reads Shopware 6 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 Shopware 6: 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.