> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/permissions.md).

# Permissions

Which Shopware permissions users need to see the plugin dashboard, change settings and read the statistics.

The plugin has no permission group of its own. It uses the permissions that Shopware already knows. On this page you see which permission is needed for what, and how to adjust a role when someone cannot see or change something.

## Who sees and may do what?

| Task                                                                                                                                                                                                                                    | Required Shopware permission |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| Open the plugin dashboard, view settings and configuration                                                                                                                                                                              | Read system settings         |
| Everything that changes something: create, delete and re-import feeds, synonyms, filters, data attributes, language assignment, subtitle, save the shopping assistant, mark problems as resolved, vote and comment on the feature board | Edit system settings         |
| Statistics in the plugin dashboard, evaluation of the shopping assistant, tile on the Shopware dashboard                                                                                                                                | View orders                  |
| "Onboarding" card in the support dialog (book an appointment), counter for the news                                                                                                                                                     | Read plugins                 |
| Join the shopping assistant (beta)                                                                                                                                                                                                      | Edit settings                |

Anyone with an edit permission usually needs the read permission as well. Shopware mostly requires this itself when you maintain roles.

### What users without a permission see

* **Without "View orders":** The "Statistics" area says: "For the statistics you need the permission to view orders. Please contact an administrator." The tile on the Shopware dashboard is not shown at all.
* **Without "Read plugins":** The "Onboarding" card in the support dialog stays hidden. It only appears in the first 90 days after installation anyway.
* **Without "Edit system settings":** Users can view everything but cannot save anything.

## Example roles

Roles are named differently in every shop. The following examples show how you can sensibly distribute the permissions.

| Example role                       | Permissions                                 | Can                                                                                                                 |
| ---------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Administrator with all permissions | all                                         | Everything in the plugin.                                                                                           |
| Shop maintenance or agency         | Read and edit system settings, read plugins | Dashboard and configuration, maintain sources, synonyms, filters, data attributes, book the onboarding appointment. |
| Marketing                          | Read system settings, view orders           | View the dashboard, read statistics and tile. No changes.                                                           |
| Statistics only                    | Read system settings, view orders           | Same as marketing. Without the read permission for system settings the plugin pages cannot be loaded.               |

## How to adjust a role in Shopware

1. In the Shopware administration open **Settings → System → Users & permissions**.
2. Go to **Roles** and open the role you want (or create a new one).
3. In the permissions tab tick the permissions you want, for example for reading and editing system settings, viewing orders or reading plugins.
4. Save the role.
5. Assign the role to the user if it is not assigned yet. The user should then log in again once.

{% hint style="info" %}
The exact naming and grouping of the permissions can differ slightly depending on the Shopware version. The plugin itself has no "InsightSearch" group in the permission list.
{% endhint %}

## Further reading

{% content-ref url="/pages/S2jMVIq3kBLmDIkN6Atn" %}
[Settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/settings.md)
{% endcontent-ref %}

{% content-ref url="/pages/HsFAOG9ZITzp3esXXRtx" %}
[Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md)
{% endcontent-ref %}

{% content-ref url="/pages/EKzI7kx2ZAjSIJVZz2DI" %}
[Shopping assistant (beta)](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/shopping-assistant.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
