> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifuse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Enable and configure the blog feature for your workspace.

<img src="https://mintcdn.com/notifuse/tEno5RTKyhyoJvpR/assets/screenshots/enable_blog.png?fit=max&auto=format&n=tEno5RTKyhyoJvpR&q=85&s=cdcc37742b705e31959a2480ec5878ba" alt="Enable blog" width="2622" height="1182" data-path="assets/screenshots/enable_blog.png" />

## Enabling the Blog

1. Go to **Settings** > **Blog**
2. Toggle **Enable Blog**
3. A default theme is automatically created and published

## Custom Domain

The blog is served at the root path `/` of your custom domain. Configure this in **Settings** > **Workspace**:

1. Set your **Custom Endpoint URL** (e.g., `https://blog.example.com`)
2. Point your DNS to your Notifuse instance
3. The blog will be available at `https://blog.example.com/`

When the blog is disabled, the root path redirects to `/console`.

<img src="https://mintcdn.com/notifuse/tEno5RTKyhyoJvpR/assets/screenshots/custom_endpoint.png?fit=max&auto=format&n=tEno5RTKyhyoJvpR&q=85&s=c9898f23aa0121357671afd75f23474f" alt="Custom endpoint" width="2620" height="1928" data-path="assets/screenshots/custom_endpoint.png" />

## URL Structure

```
https://blog.example.com/                     → Home page
https://blog.example.com/?page=2              → Home page 2
https://blog.example.com/announcements        → Category page
https://blog.example.com/announcements/hello  → Post page
```

## Blog Settings

| Setting                | Description                                          |
| ---------------------- | ---------------------------------------------------- |
| **Title**              | Blog title (defaults to workspace name)              |
| **Logo URL**           | Blog-specific logo                                   |
| **Icon URL**           | Favicon for the blog                                 |
| **Home Page Size**     | Posts per page on home (default: 20, max: 100)       |
| **Category Page Size** | Posts per page on categories (default: 20, max: 100) |

## SEO Settings

Default SEO settings apply to all pages unless overridden at the category or post level:

| Field                | Description                                |
| -------------------- | ------------------------------------------ |
| **Meta Title**       | Title tag for search engines               |
| **Meta Description** | Description for search results             |
| **OG Title**         | Open Graph title for social sharing        |
| **OG Description**   | Open Graph description                     |
| **OG Image**         | Image for social sharing                   |
| **Keywords**         | Meta keywords                              |
| **Meta Robots**      | Crawling directives (e.g., `index,follow`) |
| **Canonical URL**    | Canonical URL override                     |

## Auto-Generated Pages

The blog automatically generates:

* **`/robots.txt`** - Allows all crawlers and references the sitemap
* **`/sitemap.xml`** - Lists all published posts with last modified dates

## Caching

Blog pages are cached for 5 minutes. Cache is automatically cleared when:

* A post is published or unpublished
* A post is created, updated, or deleted
* A theme is published
* A category is modified