Update

Use the Update component to display changelog entries, version updates, and release notes with consistent formatting. Each entry has a label rail on the left and its content on the right. Stack several to build a changelog.

Give an entry a title and it becomes the heading at the top of the entry and the one line that entry contributes to the table of contents. Headings inside an entry stay out of the page outline, so the contents list the updates themselves rather than every heading within them.

Example

Usage

<script>	import { Update } from '$lib';</script><Update	label="2026-06-01"	title="Plan changes, proration & analytics"	description="v1.1.0"	tags={['Feature']}>	This is an update with a label, title, description, and tag.</Update>

The title is what the table of contents shows for this entry. Leave it off and the contents fall back to the label.

Add a date to the page frontmatter and each update becomes its own entry in the RSS feed, linked to its anchor.

Filtering by tag

Wrap your updates in a Changelog to collect every tag into a filter bar at the top. Readers click a tag to show only the updates that carry it, and the tags are sorted automatically. Without the wrapper, updates render on their own and no filter bar appears.

<script>	import { Update, Changelog } from '$lib';</script><Changelog>	<Update label="2026-06-01" tags={['Feature']}>A new feature.</Update>	<Update label="2026-05-20" tags={['Fix']}>A small fix.</Update></Changelog>

Props

Update:

The entry’s anchor comes from its title, or the label when there is no title, so the table of contents and the RSS feed link straight to it. Changelog takes no props; it reads the tags from the updates inside it.