Setup
One page that lists every place where a shop is set up, with its state and a direct link to the setting.
The setup page lists every place where a shop is set up: the connection, the AI key, the text style, the brand SKU codes, the feeds and more. Each place shows its state, so you see at a glance what is done and what is still open. The page changes nothing itself. It takes you to the place where the setting is.
Where to find it
- Help and administration > Setup in the sidebar.
- Account menu at the top right > Setup.
- Click the shop name at the top left > Set up this shop.
- In the search (Ctrl K), setup places appear in the group Setup. Type for example "ai key" or "text style".
What you need
- Access to the shop. Everybody with access sees the page and the states.
- To change a place you need the matching permission. Without it you see the state, but no detail line and no Open button.
| Setup place | Permission to change it |
|---|---|
| Shop connection, Sign-in plugin (SSO), Sales channel | Manage shops |
| AI key, AI features | Manage AI, in every shop of the company |
| Text style, AI prompts | Product settings |
| Brand SKU codes | Apply and edit brand data |
| Campaign categories | Change quality settings |
| Connect Merchant Center and feeds | Rules and settings (Feeds) |
How do I read the page?
- The header shows Everything to set up for this shop in one place and how many places are open, for example 3 open.
- The list on the left names every place. A tick means done, a circle means not done.
- The section Places and state shows one line per place: name, a short description and, if you may change it, a line with the current detail in bold.
- Each line carries a state:
| State | Meaning |
|---|---|
| done | The place is set up. |
| open | Something is missing. The Open button is highlighted. |
| default | Nothing was changed; the default values apply. This is fine if the defaults suit you. |
| check | The state could not be determined yet. Open the place and look. |
- Places marked (optional) are not needed for the shop to work.
A place that does not apply to this shop, for example because its area is not switched on, is not listed.
How do I finish an open place?
- Find a line with the state open.
- Click Open. You land directly at the setting, for example in the AI settings at the key, or in the wizard at the right step.
- Make the setting and save it there.
- Go back to Setup. The place now shows done.
What can be set up here?
| Setup place | What it is | More |
|---|---|---|
| Shop connection | Access to the Shopware Admin API (integration with keys). | Onboarding wizard |
| Sign-in plugin (SSO) | The Shopware plugin to sign in from the Shopware administration. Optional. | Onboarding wizard, Access |
| Sales channel | The storefront sales channel that products and checks use. | Onboarding wizard |
| AI key | The company's API key for every AI feature. Test it once after saving. Optional. | AI settings |
| AI features | Which AI features may run. Optional. | AI settings |
| Text style | Brief and examples for every AI text of the products. Optional. | Products |
| AI prompts | Extra instructions per AI feature. Optional. | Products |
| Brand SKU codes | Every brand needs a SKU code so that new product numbers can be proposed. Optional. | Brands |
| Campaign categories | Categories such as Sale or New that do not count as a real category. Optional. | Quality |
| Connect Merchant Center and feeds | API connection to Google Merchant Center and Meta. Optional. | Feeds |
Which of these lines you see depends on the areas that are switched on for the shop.
What do "state only" and "company-wide" mean?
- state only: you may not change this place. Only people with the matching permission can change it. Ask your team lead or an admin.
- company-wide: the setting applies to the whole company. You have the permission in this shop, but changing it needs the permission in every shop of the company. Ask a company admin.
Common errors and fixes
| What you see | Cause | Fix |
|---|---|---|
| Nothing to set up with the text The modules of this shop have no setup places. | None of the shop's areas has anything to set up. | Nothing to do. |
| A place shows state only instead of Open. | Your role lacks the permission for this place. | Ask a person with the permission from the table above. |
| A place shows company-wide. | The setting belongs to the company, and you do not have the permission in all its shops. | Ask a company admin. |
| A place stays on check. | The state was never determined, for example Not checked yet for the plugin or Not counted yet: open the brands page once for SKU codes. | Open the place once. |
| After saving, the place is still open. | The setting is incomplete, for example a key that was saved but whose test failed. | Read the detail line in bold. It says what is missing. |