Changelog

• 0.42.5

  Oct 1, 2026

  🐞 Patch Changes

  • #4227 5ba7a70 Thanks @I90rche! - Adds Macedonian language support
• 0.42.4

  Sep 24, 2026

  🐞 Patch Changes

  • #4149 fa10e87 Thanks @ematipico! - Optimizes rendering of large nested sidebars

  • #4215 f791de6 Thanks @HiDeoo! - Adds a new seti:coffee icon for CoffeeScript files in the <FileTree> component.

  • #4215 f791de6 Thanks @HiDeoo! - Fixes <FileTree> icons for .ejs and npm-debug.log files displaying the default file icon.

• 0.42.3

  Sep 22, 2026

  🐞 Patch Changes

  • #4211 33e21ec Thanks @HiDeoo! - Fixes a potential page freeze due to table of contents highlighting when a <PageTitle> component override does not render a heading with the required id="_top".
• 0.42.2

  Sep 18, 2026

  🐞 Patch Changes

  • #4201 fafd989 Thanks @linux-universe! - Add 1 new icon: fluxer
• 0.42.1

  Sep 15, 2026

  🐞 Patch Changes

  • #4198 96a44d4 Thanks @mayank99! - Removes the popover attribute from the sidebar pane on desktop viewports. This ensures the desktop sidebar doesn’t stay in a “hidden” popover visibility state.
• 0.42.0

  Sep 2, 2026
  

  🍿 Minor Changes

  • #3572 292fb17 Thanks @HiDeoo! - Distributes package as JavaScript files with dedicated type declaration files instead of TypeScript source files.

  • #4121 2623ae6 Thanks @delucis! - Simplifies markup for Starlight’s mobile menu toggle

    ⚠️ Potentially breaking change: If you use a theme plugin, custom styles, or component overrides targeting the MobileMenuToggle button or PageFrame components, you may need to adjust these for the new markup. The button is no longer wrapped in a <starlight-menu-button> custom element and no longer uses the aria-expanded attribute. Instead, you can use the .sl-menu-button class name to target the button and the :popover-open pseudo-class to style the menu open state specifically.

    In the following example, custom styles for the menu button are updated for the new approach:

     starlight-menu-button button {
     .sl-menu-button {
      color: var(--sl-color-text);
    }
    
     starlight-menu-button[aria-expanded='true'] button {
     .sl-menu-button:has(~ :popover-open) {
      color: var(--sl-color-text-accent-high);
    }

    See MobileMenuToggle.astro and PageFrame.astro on GitHub for the full source code of the updated components.

  • #3572 292fb17 Thanks @HiDeoo! - Removes the tagline configuration option, which was never used.

    If your configuration included a tagline option, you can safely remove it without any replacement.

  • #4134 6135f01 Thanks @HiDeoo! - Updates internal @astrojs/mdx, @astrojs/markdown-satteri, and satteri dependencies.

    ⚠️ BREAKING CHANGE: The following minimum versions are now required:

    • astro v7.2.10 or later
    • @astrojs/markdown-satteri 0.4.0 or later (if you use it)
    • @astrojs/markdown-remark 7.3.0 or later (if you use it)

    Please update Starlight and Astro together:

    npx @astrojs/upgrade

  • #4121 2623ae6 Thanks @delucis! - Refactors Starlight’s mobile menu toggle to work when JavaScript fails or is disabled

    ⚠️ BREAKING CHANGE: This release drops official support for Chromium-based browsers prior to version 116 (released August 2023), Safari-based browsers prior to version 17.0 (released September 2023), and Firefox prior to version 125 (released April 2024). You can find a list of currently supported browsers and their versions using this browserslist query.

    This change also removes the data-mobile-menu-expanded attribute, which was previously added to <body> while the mobile menu is open. If you have custom code that was depending on this attribute, you will need to update it to use a new selector to check if the mobile menu is open.

    In the following example, a custom background colour for the site header while the menu is open is updated for the new approach:

     [data-mobile-menu-expanded] header {
     body:has(sl-sidebar-pane:popover-open) header {
      background-color: var(--sl-color-bg);
    }

• 0.41.11

  Sep 1, 2026

  🐞 Patch Changes

  • #4167 32a5e29 Thanks @HiDeoo! - Fixes a layout issue and anchor links appearing for hidden headings, e.g. footnote headings, when markdown.headingLinks is enabled or the <AnchorHeading> component is used.

  • #4148 cdfafd8 Thanks @ematipico! - Optimizes sidebar data generation logic to speed up sites with large sidebars

• 0.41.10

  Aug 28, 2026

  🐞 Patch Changes

  • #4160 88442c3 Thanks @ArmandPhilippot! - Adds the missing translations for Expressive Code in the following locales: ar, hi, it, ja, ko, pt, zh-CN, and zh-TW.

  • #4156 57af92d Thanks @pyxelr! - Adds 1 new icon: hypothesis

  • #4159 a0e0ba2 Thanks @trueberryless! - Adds 1 new icon: npmx

• 0.41.9

  Aug 25, 2026

  🐞 Patch Changes

  • #4145 1c90d69 Thanks @pyxelr! - Adds 1 new icon: goodreads
• 0.41.8

  Aug 24, 2026

  🐞 Patch Changes

  • #4142 cacbc9f Thanks @alebelcor! - Adds 1 new icon: whatsApp

  • #4133 3944311 Thanks @delucis! - Internal refactor: numbered id attributes in the <Tabs> component are now page-specific instead of using a global counter

  • #4138 cd4b665 Thanks @delucis! - Fixes localisation of code block UI elements when using the Sätteri Markdown processor

• 0.41.7

  Aug 5, 2026

  🐞 Patch Changes

  • #4114 3e486fb Thanks @delucis! - Fixes processing of code examples in RTL languages when using Astro’s Sätteri Markdown processor
• 0.41.6

  Jul 31, 2026

  🐞 Patch Changes

  • #4102 f1dddc0 Thanks @delucis! - Adds 1 new icon: forgejo
• 0.41.5

  Jul 28, 2026

  🐞 Patch Changes

  • #4095 bb06434 Thanks @HiDeoo! - Fixes a regression when using a union to extend Starlight’s docsSchema().
• 0.41.4

  Jul 22, 2026

  🐞 Patch Changes

  • #3936 712eedd Thanks @miichom! - Fixes support for modifying Zod enums when passing an extend option to Starlight’s docsSchema()

  • #4092 0896b91 Thanks @delucis! - Fixes support for links containing a protocol like mailto: in the sidebar

  • #4088 4486ba4 Thanks @delucis! - Simplifies Starlight’s client-side sidebar state persistence script slightly

• 0.41.3

  Jul 3, 2026

  🐞 Patch Changes

  • #3911 1686ecc Thanks @timothyjordan! - Keeps keyboard focus inside the mobile menu while it is open, preventing focus moving to hidden interactive elements in page content.
• 0.41.2

  Jul 1, 2026

  🐞 Patch Changes

  • #4008 58a3520 Thanks @FrancoKaddour! - Fixes the table of contents overflowing the right edge of the viewport when a custom --sl-content-width value exceeds available space

  • #4015 bdbfffc Thanks @delucis! - Fixes an issue where aside icons were rendered incorrectly in projects where Astro’s MDX integration had optimization disabled

• 0.41.1

  Jun 25, 2026

  🐞 Patch Changes

  • #3967 72e63dc Thanks @HiDeoo! - Adds 2 new icons: link and link-alt.

  • #3988 ac55cfa Thanks @delucis! - Fixes a dependency resolution issue introduced in Starlight v0.41

  • #3967 72e63dc Thanks @HiDeoo! - Optimizes the icons of Markdown asides.

• 0.41.0

  Jun 23, 2026
  

  🍿 Minor Changes

  • #3951 1202dd4 Thanks @HiDeoo! - Adds support for Astro v7, drops support for Astro v6.

    Upgrade Astro and dependencies

    ⚠️ BREAKING CHANGE: Astro v6 is no longer supported. Make sure you update Astro and any other official integrations at the same time as updating Starlight:

    npx @astrojs/upgrade

    Community Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v7. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.

    ⚠️ BREAKING CHANGE: This release drops official support for Chromium-based browsers prior to version 111 (released 07 March 2023) and Safari-based browsers prior to version 16.4 (released 27 March 2023). You can find a list of currently supported browsers and their versions using this browserslist query.

  🐞 Patch Changes

  • #3953 a935d33 Thanks @HiDeoo! - Fixes Starlight Markdown processing being potentially applied to files that should not be processed.
• 0.40.0

  Jun 9, 2026
  

  🍿 Minor Changes

  • #3923 edf2e6b Thanks @Princesseuh! - Adds support for Astro 6.4 and the new Sätteri Markdown processor.

    It is now possible to opt into using Astro’s 6.4 Sätteri Markdown processor by installing the @astrojs/markdown-satteri package and configuring it in your astro.config.mjs file:

    import { defineConfig } from 'astro/config';
    import { satteri } from '@astrojs/markdown-satteri';
    
    export default defineConfig({
      markdown: {
        processor: satteri(),
      },
    });

    ⚠️ BREAKING CHANGE: The minimum supported version of Astro is now v6.4.5.

    Please update Starlight and Astro together:

    npx @astrojs/upgrade

    Community Starlight plugins and Astro integrations may also need to be manually updated to work with Sätteri. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.

  🐞 Patch Changes

  • #3923 edf2e6b Thanks @Princesseuh! - Updates Expressive Code to version 0.43.1.
• 0.39.3

  Jun 2, 2026

  🐞 Patch Changes

  • #3910 dddf405 Thanks @andreialba! - Improves Romanian UI translations

  • #3924 02f2ce1 Thanks @BouRock! - Improves Turkish UI translations

  • #3928 11a7ed2 Thanks @delucis! - Updates Pagefind to v1.5 and adds support for Pagefind’s new diacriticSimilarity and metaWeights advanced ranking options

  • #3927 e944870 Thanks @HiDeoo! - Refactors internal file path handling for Starlight content collections.