# Updates

An updates block lets you add a changelog to any page. Each update has a date, optional tags, and supports any block content inside it — text, images, code blocks, lists, and more.

### Adding updates

Insert an updates block on any page. Once it's on the page, hover above or below an existing update to add another in sequence.

To change the date format, click the date in the block. You can display the full date, a shortened version, or numbers only (for example, 12/25/2025).

### Tags

Each update can have its own tags. Use the tag picker below the date to add, remove, or reorder them.

### RSS feed

Any page with an updates block automatically gets an RSS feed — no extra setup required.

Your readers can open the feed from the button at the top of the page, copy the URL, and add it to their preferred reader. New updates you publish are pushed to that reader automatically.

If a page doesn't have an updates block, it won't have an RSS feed. Adding one to the page is all you need to generate it.

#### Plan availability

The updates block is available on \[paid plans]. If you don't see the option to add an updates block, check that your plan includes access to it.

#### If your feed isn't appearing

If the RSS button isn't showing on a published page, confirm that the page includes at least one updates block. The feed is tied to the presence of that block — if it's missing, the feed won't generate. If the block is in place and the feed still isn't appearing, contact [GitBook support](https://www.gitbook.com/contact).

### Example

{% updates format="full" %}
{% update date="2025-12-25" tags="beta" %}

## A brand new update

Use this block to tell users about a new update. Add any additional blocks you need inside it — images, code, lists, and more.
{% endupdate %}
{% endupdates %}

{% code overflow="wrap" %}

```markdown
{% updates format="full" %}
{% update date="2025-12-25" tags="beta" %}
## A brand new update

This block is perfect for telling users all about a brand new update to your product. You can easily add other blocks within this update block, including images, code, lists and much more.
{% endupdate %}
{% endupdates %}
```

{% endcode %}


---

# Agent Instructions: 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://gitbook.com/docs/creating-content/blocks/updates.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.