Since

Quick summary #

The since shortcode is used to render a small badge marking the release a feature was introduced in (for example “since 2.17.0”). It is intended for documentation and changelog-style pages. Use it when you need to mark, at a glance, which version of a project a feature first shipped in. By default the badge is plain text; configure a release URL to turn it into a link.

Syntax overview #

Use either positional options or named options in a single shortcode call. Do not mix both styles in the same call.

Positional options #

{{< since "2.17.0" >}}

Named options #

{{< since version="2.17.0" >}}

The version can also be omitted entirely, in which case it is read from the page’s since front matter:

{{< since >}}

Parameter overview #

* The version is required somewhere: as the positional argument, as the named version argument, or as the page’s since front matter value. If none is provided, nothing is rendered.

Linking and link target are not shortcode arguments — they are set in site configuration (see Configuration notes).

Usage rules #

• Use either positional options or named options. Do not mix both styles in the same shortcode call.
• Prefer the page since front matter when a whole page documents one release — then call {{< since >}} with no argument.
• Prefer an explicit argument when a single page mentions several versions.
• Keep the version value quoted.

How it works #

The since shortcode resolves the version in this order of precedence: the first positional argument, the named version argument, then the page’s since front matter. It renders a badge whose text reads since <version>.

By default the badge is plain text (a <span>). If you set a release URL in params.ananke.shortcodes.since.repo_url, the badge becomes a link (an <a>) to that release. The URL is a printf format string with %s replaced by the version. The link opens in a new tab (target="_blank") unless you change params.ananke.shortcodes.since.target.

When no version can be resolved, the shortcode renders nothing and prints a build-time warning naming the page so the missing value is easy to find.

Intended use #

Use this shortcode when:

• you document a feature and want to show which release introduced it
• you maintain a changelog or “what’s new” page
• you annotate a whole page with a single “available since” badge

Avoid this shortcode when:

• plain Markdown already communicates the version clearly enough
• the version information belongs in a structured data file or table instead
• you want a link but cannot point it at a valid release URL

Basic examples #

Basic positional example #

{{< since "2.17.0" >}}

This renders a badge reading “since 2.17.0”.

Basic named example #

{{< since version="2.17.0" >}}

This renders the same badge as the positional example.

Example catalogue #

Minimal usage #

{{< since "2.17.0" >}}

Result:

A plain-text “since 2.17.0” badge. With no release URL configured it is not a link.

Link the badge to releases #

Set a release URL in your site configuration:

[params.ananke.shortcodes.since]
repo_url = "https://github.com/your-org/your-project/releases/tag/v%s"

{{< since "2.17.0" >}}

Result:

The badge becomes a link to https://github.com/your-org/your-project/releases/tag/v2.17.0, opening in a new tab.

Open the link in the same window #

[params.ananke.shortcodes.since]
repo_url = "https://github.com/your-org/your-project/releases/tag/v%s"
target = false

Result:

The link opens in the same window instead of a new tab. Set target to a custom value such as "_top" to use a specific browsing context.

With page front matter #

---
title: Hooks & Filters
since: "2.17.0"
---

{{< since >}}

Result:

The badge reads “since 2.17.0”, taking the version from the page’s since front matter. This is the recommended pattern when one page documents one release.

With fallback behaviour #

{{< since >}}

Result:

When the page has no since front matter and no argument is given, nothing is rendered and a build-time warning naming the page is printed.

Common mistake: mixing positional and named options #

Do not use this:

{{< since "2.17.0" version="2.17.0" >}}

Use positional options:

{{< since "2.17.0" >}}

Or use named options:

{{< since version="2.17.0" >}}

Output explanation #

This shortcode renders a single badge with the text since <version>. When no release URL is configured it is a <span> (plain text). When params.ananke.shortcodes.since.repo_url is set it is an <a> linking to the release; the link opens in a new tab with rel="noopener" unless target is changed.

The generated output is intended to give readers a quick indication of when a feature became available. It is styled by the theme and should not require custom HTML in the Markdown content.

Accessibility notes #

• When linking is enabled the badge is a real link with descriptive text (since <version>), so it is announced meaningfully by assistive technology.
• By default the link opens in a new tab; the visible text makes its destination clear. Set target = false if you prefer to keep readers in the same window.
• The badge relies on text, not colour alone, to convey its meaning.

Configuration notes #

The badge label (“since”) is a translatable interface string (since). Override it in your project’s i18n/<language>.toml rather than editing the shortcode — see Overriding theme interface strings.

Related shortcodes #

There are no closely related shortcodes.

Troubleshooting #