> 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/cms-elements.md).

# CMS elements

The plugin ships with a set of elements that you can assemble in Shopping Experiences. You will find all of them in the **Add block** dialog under the **Blog (PremSoft)** tab.

## Universal showcase blocks

You can use these three blocks **anywhere** — on the home page, landing pages, category pages or inside your magazine. They surface articles exactly where your customers need them.

| Block                    | Shows                                            | Configuration                  |
| ------------------------ | ------------------------------------------------ | ------------------------------ |
| Blog – Latest posts      | The latest active posts.                         | Number of posts `1–50`.        |
| Blog – Posts by category | Posts from a specific blog category.             | Category plus number of posts. |
| Blog – Selected posts    | Manually selected posts in the order you choose. | Multi-select list of posts.    |

All three blocks use the same card design as the magazine overview, so recommendation areas blend into the rest of the shop.

## Blocks for the magazine overview

These blocks are made for the magazine overview category from [Quickstart](/en/plugins/blog/quickstart.md), step 2.

| Block               | Shows                                                       |
| ------------------- | ----------------------------------------------------------- |
| Blog – Article list | The main article listing with pagination and sorting.       |
| Blog – Filter       | Filter form with multi-select for category, tag and author. |

## Blocks for article detail pages

Use these single-purpose blocks in the default article detail layout and rearrange them as needed.

| Block                    | Shows                                                          |
| ------------------------ | -------------------------------------------------------------- |
| Blog – Title             | Article title with category badge, subtitle and meta line.     |
| Blog – Subtitle          | The subtitle on its own.                                       |
| Blog – Short description | The lead text in larger type.                                  |
| Blog – Content           | The main content with headings, lists, quotes and code blocks. |
| Blog – Preview image     | The hero image at the top of the page.                         |
| Blog – Image gallery     | Additional images as a gallery with lightbox support.          |
| Blog – Author            | Author card with avatar, name and link to the author profile.  |
| Blog – Categories        | Clickable category badges.                                     |
| Blog – Tags              | Tag badges.                                                    |
| Blog – Linked products   | Product slider with the linked products.                       |
| Blog – Review stars      | Aggregated star rating plus review count.                      |
| Blog – Review list       | List of approved reviews.                                      |
| Blog – Review form       | Input form for new reviews.                                    |

The three review blocks appear only when reviews are enabled in the plugin configuration **and** you use the premium plan.

## Blocks for author pages

Use these blocks on the authors overview layout and on individual author pages.

| Block                     | Shows                                                     |
| ------------------------- | --------------------------------------------------------- |
| Blog – Authors list       | Card overview of all authors, sorted by last name.        |
| Blog – A-Z authors filter | Alphabet bar for filtering the authors list by last name. |
| Blog – Author details     | Combined element with name, image and description.        |
| Blog – Author name        | Name only.                                                |
| Blog – Author image       | Image only.                                               |
| Blog – Author description | Description only.                                         |

## Create your own layouts

You can build custom Shopping Experiences for your blog content:

{% stepper %}
{% step %}
Open **Content → Shopping Experiences → New**
{% endstep %}

{% step %}
Choose the right page type — for article detail pages this is **Blog page (PremSoft)**, while the magazine and authors overviews use a regular category page
{% endstep %}

{% step %}
Assemble the required blocks from the **Blog (PremSoft)** tab
{% endstep %}

{% step %}
Set the layout as the default in the plugin configuration, or assign it per article in the **Visibility** tab
{% endstep %}
{% endstepper %}

As long as you do not assign a custom layout to an article, the plugin uses the configured default layout. You can therefore stay entirely with the bundled layouts if they already fit your use case.


---

# 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/cms-elements.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.