# Updates

An updates block lets you share new releases on your site in a format that matches established best practices for changelog updates.

You can add a date to your update block, then format the content inside the block using other blocks as you would expect. To change the date or update the date format, click the date in your block. You can choose between the full date, a shortened date, or a date using only numbers (e.g. 12/25/2025).

Once you’ve added an update block to your page, you can hover your cursor above or below the block to see the option to add another in sequence.

Each update block can also have its own [tags](/docs/creating-content/content-structure/page/tags.md). Use the tag picker below the date to add, remove, or reorder tags.

### RSS feeds

Any page containing an updates block automatically gets an RSS feed, making it easy for your readers to stay on top of new updates.

Users can open the RSS feed from the button at the top of the page, copy the URL, and paste it into their preferred reader. Any updates you publish in your changelog will automatically be pushed to that reader so they’ll see them in real-time.

### Example

{% 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 %}

### Representation in Markdown

{% 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.