# Setup

Blog posts are intentionally structured very similarly to regular products. To display the blog posts in the storefront, the following setup must be done once.

## Create shopping experience layout

First you have to create a shopping experience layout for the blog posts. For this you have to navigate in the admin to `Content > Shopping Experiences`. and click on the button `Create new layout` to create a new layout.

![](/files/-MhSi7vGA9acuZykUgBK)

Now you have to create a new `Shop page`. Here you have the choice, if you want to have a `Sidebar` as a layout or if you or if you prefer to use the full available width with `Full width`. Afterwards you have to give the layout a name (e.g. Blog).

Next, you need to drag the right CMS blocks into the layout. To display the blog posts, there is a special CMS block called `Blog posts listing`, which can be found in the block category `Blog`.

If you want to use a filter, you need the CMS block called `Product filter`, which can be found in the block category `Sidebar`.

![](/files/-MhUsOsBrAdez0X_y3yQ)

Finally you need to save the layout using the `Save` button.

## Create category <a href="#create-category" id="create-category"></a>

In Shopware, new pages like the blog are managed via their own categories. To create a new category you have to navigate to `Catalogues > Categories` in the admin, click on the `...` button in any category and create a new category (e.g. `New subcategory`).

Now you have to give a name to the category (e.g. Blog) and then activate the category via `Category active`.

Finally you should save the category using the `Save` button.

{% hint style="info" %}
Tip

You can also create multiple subcategories for the blog to introduce proper blog categories. The assignment of the posts to the categories takes place directly in the blog posts.
{% endhint %}

## Assign shopping experience layout

Now that you have a category for the blog, you need to assign the shopping experience layout you created earlier to the category. Click the category again to edit the details.

A bit further down you can find the `Layout Assignment` section. There you can use the button `Change layout` to assign the to assign the shopping experience layout.

![](/files/-MhSiZyg5ZgG8JQfTaEa)

Finally you should save the category using the `Save` button.

## Publish posts <a href="#publish-posts" id="publish-posts"></a>

The one-time setup would now be done! This means that you can now [publish your blog posts](/shopware/extensions/blog/create-and-publish-posts.md).


---

# 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.shop-studio.io/shopware/extensions/blog/setup.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.