> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/seo-ultimate/english-documentation/installation.md).

# Installation & configuration

## Installation

1. Upload the plugin via the Shopware Store or as a ZIP (**Extensions → My extensions → Upload extension**).
2. **Install** and **activate** the plugin.
3. Recompile the storefront theme if needed (only required when the color/footer options are used).

## Basic configuration

The basic settings are located under **Settings → Plugins → SEO Ultimate → Configuration**.

### Character counter

Defines the Google-compliant limits that are shown as a character counter in the bulk generator.

| Setting                         | Default | Description                                      |
| ------------------------------- | ------- | ------------------------------------------------ |
| **Meta title characters**       | 60      | Recommended maximum length for meta titles       |
| **Meta description characters** | 160     | Recommended maximum length for meta descriptions |

> The counter turns red as soon as the configured length is exceeded.

### Footer: Shopware logo

* **Remove Shopware logo in footer** – hides the "powered by Shopware" logo in the footer.

### Fontawesome

* **Fontawesome kit code** – paste the complete script tag of your Fontawesome kit here:

```html
<script src="https://kit.fontawesome.com/{kit-ID}.js" crossorigin="anonymous"></script>
```

The kit code is required for the icons in the **social media footer** and the **header banner** (Conversion & usability).

### Generator settings

* **Generator block size** (default: `100`) – block size for the save requests of the bulk generators. Higher values can speed up mass generation but require more server performance. **When in doubt, leave it at 100.**

## Automation (cron job)

For the daily automatic execution of templates, Shopware's **scheduled task system** is used. This requires the scheduler / message consumer to be running on the server (standard on production systems). See [Cron job / automation](/seo-ultimate/english-documentation/cronjob.md).
