> 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/storefront-integration.md).

# Storefront Integration

Blog content appears in four places in the shop:

1. **On a category of your choice** — create a category and assign the blog layout to it. That category becomes your magazine overview.
2. **On article detail pages** whose URL is derived from that category path.
3. **Inside Shopping Experiences** — with curated elements for the home page, landing pages and other categories.
4. **In SEO snippets and an RSS feed** — automatically, with no extra setup. See [SEO, RSS and Rich Snippets](/en/plugins/blog/seo-rss-and-rich-snippets.md).

## Where the blog lives in your shop

Unlike many blog plugins, there is **no fixed URL** like `/blog` — the path depends on the name of your magazine category:

* If the category is `Magazine` → URLs look like `/magazine/my-first-article`
* If it is `Guides` → `/guides/my-first-article`
* If it sits under `Service/Knowledge` → `/service/knowledge/my-first-article`

This applies to the article overview, every article detail page, the authors overview and the author detail pages. See [Quickstart](/en/plugins/blog/quickstart.md) for the category setup.

## Magazine overview

The main article listing renders on the category that uses the **Blog listing page (PremSoft)** layout. It shows:

* A card list of all active articles
* A filter form for category, tag and author
* Sort options: newest, oldest, title A–Z, title Z–A
* Pagination
* Automatic SEO snippets in the page source

Active filters appear as chips below the form and can be removed one by one. Filter changes update the listing without a full page reload.

## Article detail page

The default layout has two sections:

* **Top section:** title, preview image, short description and main content — plus a sidebar with author, categories and tags
* **Full-width section below:** linked products, review stars, review list and review form

You can use this layout as-is, duplicate it as a starting point, or assign a custom layout per article in the **Visibility** tab.

## Authors overview

The authors overview renders on the category that uses the **Blog authors listing page (PremSoft)** layout. It shows a card list of all profiles, sorted by last name. You can optionally add the **A–Z filter** element — letters with at least one match stay active, empty letters render disabled.

## Author detail page

Each author gets a dedicated detail page with profile, description and a list of all articles by that person. The URL automatically uses the path of the authors overview category, for example `/magazine/authors/anna-mueller`.

## Reviews

The default article layout includes a review area. On first load the input form stays collapsed — visitors see the average star rating and a **Write a review** button. Clicking it opens the form with an animated scroll into view. More details are in [Reviews](/en/plugins/blog/create-and-edit-blog-posts/reviews.md).

## Breadcrumb navigation

On all blog pages the plugin shows a breadcrumb that mirrors the category path. Example for an article in the `Magazine` category:

```
Home → Magazine → Article title
```

If your magazine category sits deeper in the navigation tree, for example `Service/Magazine`, the breadcrumb shows the full path.

## Multilingual

All texts are translatable — title, subtitle, short description, content, meta tags, SEO URL, author description, category names and tag names. Language selection works per sales channel, so the same article can appear with different content in German and English sales channels.

## Headless / external integration

If you do not want to render the blog in the standard Shopware storefront, but in a headless frontend such as Vue, React or a mobile app, you can fetch all data through the Store API. Details are in [Store API](/en/plugins/blog/store-api.md).


---

# 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/storefront-integration.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.