# SEO URL Manager

{% hint style="info" %}
**You want more organic traffic?**

Then be sure to check out our [SEO guide](https://www.atloss.de/ratgeber/shopware-6-seo/)! In this article you will find all the important Shopware 6 SEO measures for your store. (Only in German for now)
{% endhint %}

### Basic configuration

1. Go to "Extensions" > "My extensions" in your admin. 
2. Install and activate the app. 
3. Open the configuration and activate the desired functions. 
4. Clear the cache under "Settings" > "System" > "Caches & indexes" > "Clear caches"

### Generate variant URLs

1. Go to "Settings" > "Shop" > "SEO" 
2. Paste the following template into the "Product detail page" field and save your entries:

{% code title="Product detail page" fullWidth="false" %}

```twig
{{ product.translated.name|lower }}{% if product.variation is not empty and product.parentId is not empty %}{% for var in product.variation %}-{{ var.option|lower }}{% endfor %}{% endif %}/
```

{% endcode %}

{% hint style="success" %}
This template creates the URLs according to the following scheme:

*<https://www.shop.com/\\[product-name-in-_&#x6C;ower-cas&#x65;_]-\\[variant(s)-in-_&#x6C;ower-cas&#x65;_]/>*
{% endhint %}

You can of course adapt the template to your needs.

3. Update your index under "Settings" > "System" > "Caches & Indexes" > "Update indexes".

{% hint style="info" %}
You can track the current indexing status in the messages at the top right. The more products you have in your store, the longer this process can take.
{% endhint %}

### Sitemap URLs

{% hint style="info" %}
If you have already updated the index in the previous step, you do not need to do this again.
{% endhint %}

Update your index under "Settings" > "System" > "Caches & Indexes" > "Update indexes".

### Canonical URLs

No further configuration is required for this.

### Further options

Global settings from the app configuration such as the linking from product boxes and the canonical URL setting can be overwritten at product level under "Catalogues" > "Products" > "\[Product]" > "Specifications" > "Custom fields" > "Product (SEO URL Manager)".

### FAQ's

<details>

<summary>My listing URLs still do not point to the parent after installing the extension?</summary>

Since the extension accesses the listing template, it is possible that your theme overwrites our listing template. If this is the case for you, please contact us and we will solve the problem together.

</details>

<details>

<summary>Some variant URLs have a /detail/3d951aa1fa4549579670c84bb67e5f08 URL after index generation. What is the reason for this?</summary>

This cryptic URL is the Shopware 6 fallback for existing URLs. So make sure that your SEO URL template generates unique and unambiguous URLs. For example, if you have two products with exactly the same name, there is a very high probability that the same URL will be generated twice.

</details>

<details>

<summary>Why is the wrong variant selected on the product detail page when I link to the parent product globally from all product boxes via the app?</summary>

Linking to the parent from the product box is also possible in the Shopware standard. The variant that is to be selected when clicking on the main product can be defined in the product in the "Variants" tab via the storefront presentation in the product listings.

If this is not defined, the system acts at its own discretion and selects a variant itself, as Shopware always works with a preselection on product detail pages. After all, the main product cannot be purchased.

The SEO URL Manager therefore always links globally to the parent from product boxes via the active configuration, but it has never been defined at product level what should be selected when the parent URL is called.

Especially when products are broken down by colour in the listing, all products still link to the parent and a concrete preselection according to the corresponding colour can no longer be guaranteed due to this conflict. The decision between better usability or SEO basic structure must be made by each individual.

</details>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.atloss.de/en/seo-url-manager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.