mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
d8667fed86
* docs: explain generated anchor IDs
* 💅
95 lines
3.0 KiB
Plaintext
95 lines
3.0 KiB
Plaintext
---
|
|
title: "Update"
|
|
description: "Use the update component to display product updates, release notes, and changelog entries in a structured timeline format with dates."
|
|
keywords: ["changelogs", "product updates", "release notes"]
|
|
boost: 3
|
|
---
|
|
|
|
Use the `Update` component to display changelog entries, version updates, and release notes with consistent formatting.
|
|
|
|
<Update label="Example" description="v0.1.1">
|
|
## Example update
|
|
|
|
You can add anything here, like a screenshot, a code snippet, or a list of changes.
|
|
|
|
<Frame>
|
|
<img
|
|
className="block"
|
|
src="https://mintlify-assets.b-cdn.net/hero-light.png"
|
|
alt="Screenshot of the PearsDB Introduction page as an example of an image in an Update component."
|
|
/>
|
|
</Frame>
|
|
|
|
### Features
|
|
- Responsive design
|
|
- Anchor for each update
|
|
- Generated RSS feed entry for each update
|
|
</Update>
|
|
|
|
## How to use
|
|
|
|
```mdx Update example
|
|
<Update label="2024-10-11" description="v0.1.0" tags={["Mintlify"]}>
|
|
This is an update with a label, description, and tag.
|
|
</Update>
|
|
```
|
|
|
|
Use multiple `Update` components to create [changelogs](/create/changelogs).
|
|
|
|
|
|
Update components automatically generate RSS feed entries. The entries contain pure Markdown only--components, code blocks, inline code, and raw HTML elements are not included.
|
|
|
|
If your update includes components or HTML, use the `rss` prop to provide alternative text for RSS subscribers.
|
|
|
|
```mdx Custom RSS content
|
|
<Update
|
|
label="March 2025"
|
|
description="v2.0.0"
|
|
rss={{
|
|
title: "March 2025 - Major redesign",
|
|
description: "Complete UI overhaul with new components"
|
|
}}
|
|
>
|
|
## New dashboard
|
|
|
|
<Frame>
|
|
<img src="/dashboard.png" alt="New dashboard UI displaying updated components." />
|
|
</Frame>
|
|
|
|
Check out our redesigned dashboard with improved navigation.
|
|
</Update>
|
|
```
|
|
|
|
## Props
|
|
|
|
<ResponseField name="label" type="string" required>
|
|
Label for the update. Appears to the left of the update and creates an anchor link using the same [automatic anchor ID rules](/create/text#automatic-anchor-ids) as headings. Use unique labels to create distinct anchor links.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="tags" type="string[]">
|
|
Tags for the update. Shown as filters in the right side panel.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="description" type="string">
|
|
Description of the update. Appears below the label and tag.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="rss" type="object">
|
|
Update components automatically generate RSS feed entries. Use the `rss` property to create a single RSS feed entry with a custom title and description.
|
|
|
|
If not provided:
|
|
|
|
- Updates with Markdown headings create a separate RSS feed entry for each heading.
|
|
- Updates without Markdown headings create a single RSS feed entry using the `label` as the title.
|
|
|
|
<Expandable title="properties">
|
|
<ResponseField name="title" type="string">
|
|
Custom title for the RSS feed entry.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="description" type="string">
|
|
Custom description for the RSS feed entry.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|