> ## Documentation Index
> Fetch the complete documentation index at: https://tyk-joancamostyk-patch-19.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Blog Posts

> Overview of the Developer Portal blog feature, covering use cases, configuration, and how blog posts integrate with API Products via tags.

## Availability

| Component        | Version                | Edition                                           |
| ---------------- | ---------------------- | ------------------------------------------------- |
| Developer Portal | Available since v1.0.0 | Enterprise (license must include blog capability) |

The Developer Portal includes a built-in blog that Portal Admins can use to publish content directly on the Live Portal. Blog posts are publicly visible to all visitors and serve as a content channel alongside the API catalog.

## Use Cases

The blog is suited for content that supplements the API catalog:

* **Portal announcements**: new features, scheduled maintenance, policy changes
* **API release notes**: version updates and deprecation notices for published APIs
* **Developer guides**: tutorials, best practices, and integration walkthroughs
* **Community content**: case studies, partner spotlights, or ecosystem news

## How the Blog Fits into the Portal

The blog is a top-level content area within the Live Portal. When enabled, the portal automatically registers a `/blog` route and adds a **Blog** link to the Primary navigation menu during initial setup. Portal Admins can later modify or remove this link from the [Menus](/portal/customization/menus) section.

<img src="https://mintcdn.com/tyk-joancamostyk-patch-19/espWOY2zTVql3Px_/img/portal/portal-blog-live-listing.png?fit=max&auto=format&n=espWOY2zTVql3Px_&q=85&s=8abddfc946c305d78f47fd163c02ae35" alt="Blog listing page at /blog in the Live Portal, showing published posts as cards with title, date, lede, and a Keep reading button" width="2926" height="1614" data-path="img/portal/portal-blog-live-listing.png" />

Blog posts are organized using **Categories** and **Tags**:

* **Categories** group posts by topic and are surfaced in the Live Portal at `/blog/category/[category-name]` for filtering.
* **Tags** enable cross-referencing. A post that shares a tag with a product appears in that product's **Related blog content** section in the Live Portal.

Posts support both a rich text editor and a Markdown editor. See the [Markdown reference](/portal/customization/markdown) for supported syntax and known limitations.

## Configuration

The blog is controlled through two configuration options. Both require a configuration file or environment variable change, followed by a portal restart.

| Config file key            | Environment variable              | Default | Description                                                                                             |
| -------------------------- | --------------------------------- | ------- | ------------------------------------------------------------------------------------------------------- |
| `Blog.Enable`              | `PORTAL_BLOG_ENABLE`              | `true`  | Enables or disables the blog feature entirely.                                                          |
| `Blog.AllowFormSubmission` | `PORTAL_BLOG_ALLOWFORMSUBMISSION` | `false` | Allows HTML forms embedded in blog post content to submit data. Applies when raw HTML is used in posts. |

<Tabs>
  <Tab title="Environment Variables">
    ```bash theme={null}
    PORTAL_BLOG_ENABLE=true
    ```
  </Tab>

  <Tab title="Configuration File">
    ```json theme={null}
    {
      "Blog": {
        "Enable": true
      }
    }
    ```
  </Tab>
</Tabs>