---
title: "Manual Setup"
version: "main"
source: "Setup/Manual/Index.rst"
modified: "2026-09-14T14:02:30+00:00"
---

# Manual Setup

The manual setup helps you to build an **integrated** instance of the TYPO3 Blog
Extension. If you want a standalone Blog and do not have an existing
site, please go with the [Setup Wizard](../Wizard/Index.html#SetupWizard) instructions.

Prerequisites:

1.  Ensure the TYPO3 Blog Extension is [installed and activated](../../Installation/Index.html#Installation)
1.  Ensure your logged in as **Administrator**

1.  Edit your existing site your existing site configuration

    ![](manual-1.png)
1.  Add the "Blog: Integration" set to your site.

    ![](manual-2.png)

    > [!TIP]
    > It is recommended to use the "Integration" template to use the prepared page
    > templates for lists and posts. These are using the layout "Default" and the
    > section "Main" of your Template.
    >
    > If your "Page-Template/-Sections" named differently, please overwrite the blog
    > templates in your sitepackage. Check the used templates below and adapt them
    > to your own needs.
    >
    > -   [BlogList](https://github.com/TYPO3GmbH/blog/blob/master/Resources/Private/Templates/Page/BlogList.html)
    > -   [BlogPost](https://github.com/TYPO3GmbH/blog/blob/master/Resources/Private/Templates/Page/BlogPost.html)
1.  Create Blog Pages

    ![](manual-3.png)

    1.  Right click the page you want the Blog to list below
    1.  Select "More options"
    1.  Select "Create multiple pages"

    ![](manual-4.png)

    Create the following Pages, make sure they have the correct **Type**

    | Name | Type |
    | --- | --- |
    | Blog | Blog Page |
    | Authors | Blog Page |
    | Categories | Blog Page |
    | Tags | Blog Page |
    | Archive | Blog Page |
    | Data | Folder |

    ![](manual-5.png)

    Edit the newly generated Data folder to contain the "Blog"

    1.  Edit the page "Data" and select the "Behaviour" tab
    1.  Select "Blog" at "Contains Plugin"
    1.  Save the Page

    ![](manual-6.png)

    Sort the pages like the following screenshot
1.  Configure the page ids in the site settings

    ```yaml
    plugin:
       tx_blog:
          settings:
             blogUid:       ID_of_Page_Blog
             categoryUid:   ID_of_Page_Categories
             tagUid:        ID_of_Page_Authors
             authorUid:     ID_of_Page_Tags
             archiveUid:    ID_of_Page_Archive
             storagePid:    ID_of_Page_Data
    ```

    ![](manual-7.png)

    ![](manual-8.png)

    ![](manual-9.png)

    ![](manual-10.png)
1.  Frontend Routing

    The extension provides a frontend route enhancer configuration that
    you can include it in your site configuration.

    ```yaml
    imports:
       - { resource: "EXT:blog/Configuration/Routes/Default.yaml" }
    ```

    > [!TIP]
    > You can find your site configuration in **./config/sites/\<identifier>/config.yaml**
1.  Add Plugins to Blog Pages

    Example: Blog Listing

    1.  Select the Page module
    1.  Select the Blog page
    1.  Click the Button to add content

    ![](manual-11.png)

    1.  Select the "Blog" tab
    1.  Add plugin "Blog: List of posts"

    ![](manual-12.png)

    | Page | Plugin |
    | --- | --- |
    | Blog | Blog: List of posts |
    | Authors | Blog: List by author |
    | Categories | Blog: List by category |
    | Tags | Blog: List by tag |
    | Archive | Blog: Archive |
1.  Congratulations

    Your blog is now ready, please read on in the capters about "how to add a blog post" and learn more about configuration options.

    ![](manual-13.png)