> ## 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.