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

# Installation

Before you start, briefly check the [Pre Requisites](/en/plugins/blog/pre-requisites.md) — especially the supported environments and the Shopware minimum version.

## Install the plugin

1. Buy the plugin in the Shopware Store or install it via the Plugin Manager.
2. In the administration: **Extensions → My extensions → Blog System** → *Install*.
3. After install completes: *Activate*.

On install the plugin automatically creates four default layouts that you'll find in Shopping Experiences:

* **Blog detail page (PremSoft)** — layout for every article
* **Blog listing page (PremSoft)** — magazine overview with filter
* **Blog authors listing page (PremSoft)** — overview of all authors
* **Blog author detail page (PremSoft)** — profile page of one author

You can duplicate these layouts in Shopping Experiences and tailor them to your theme — the bundled originals stay untouched. Custom layouts can be promoted to a new default in the plugin configuration.

## First steps

Want to dive straight in? The [Quickstart](/en/plugins/blog/quickstart.md) walks you through eight steps from install to your first published post.

If you'd rather go through the topics step by step:

1. [Plugin configuration](/en/plugins/blog/create-and-edit-blog-posts/configuration.md) — magazine category, activate the sales channel, pick the default layouts.
2. [Managing articles](/en/plugins/blog/create-and-edit-blog-posts/posts.md) — create and edit articles.
3. [The content editor](/en/plugins/blog/create-and-edit-blog-posts/content-editor.md) — how the visual editor works.

## Update

Updates arrive through your Shopware Account or via the Plugin Manager. On every update the plugin verifies that its default layouts, the default media folder and the CMS page type are still in place, and re-creates anything that's missing. Your own layouts and content are never overwritten.

## Uninstall

* **Deactivate** simply turns the plugin off. Your data stays untouched and is available again the moment you re-activate.
* **Uninstall** with *"Delete data"* removes every blog item — articles, categories, tags, authors, reviews — and the bundled "Blog" media folder. Without this option your content stays in the database and is available again after a fresh install.

The bundled default layouts are removed on uninstall as well.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.premsoft.de/en/plugins/blog/installation.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.