v3.11.0

3.11.0 (2025-11-27)

Highlights

• Bug fixes and improvements.™

Changelog

Features

• core: ✨ use table icon for SMW and Cargo (by @alistair3149) (c99f053)
• PageForms: ✨ add icon for Page Forms button (by @alistair3149) (9c4bd7b), closes #1200

Bug Fixes

• pageActions: fixes transition for page actions and ToC buttons (by @Zes-MinKey-Young, @ChenWuwei404, and @SolidBlock-cn) (#1199) (4ba8120), closes #1193
• stickyHeader: 🐛 sticky element should collapse when sticky header is hidden (by @alistair3149) (4458ddd), closes #1195
• tests: 🐛 fix incorrect namespace in CitizenComponentBodyContentTest (by @alistair3149) (56ea7e6)

Performance Improvements

• core: ⚡️ re-use the same frame counting function (by @alistair3149) (7b0894b)

Miscellaneous Chores

• dev-deps: 🔧 revert ESLint to v8 (by @alistair3149) (20d5dc1)

New Contributors

• @Zes-MinKey-Young made their first contribution in #1199
• @ChenWuwei404 made their first contribution in #1199
• @SolidBlock-cn made their first contribution in #1199

Full Changelog: v3.10.0...v3.11.0

v3.10.0

3.10.0 (2025-10-28)

Highlights

• Bug fixes and improvements.™

Changelog

Features

• core: ✨ allow CSS keyword transition by default (by @alistair3149) (0561ad1)
• typography: ✨ apply more monospace font (by @AmeroHan) (504f36b)

Bug Fixes

• mixins: 🐛 fix unknown custom properties in hsl mode (by @AmeroHan) (#1172) (6d2586e)
• OOUI: 🐛 use fixed font size for some UI of VisualEditor and DiscussionTools (by @alistair3149) (bb82009)
• pageActions: 🐛 prevent flickering of page actions when header is hidden (by @alistair3149) (8b2c0cd)
• skinning: 🐛 fix image padding regression (by @alistair3149) (d014d9b), closes #1168

Full Changelog: v3.9.0...v3.10.0

v3.9.0

3.9.0 (2025-10-17)

Highlights

• 🛡️ SECURITY: Stored XSS in sticky header button messages
  Fix the vulnerability where an evil user with interface message rights can inject arbitrary HTML into the sticky header button messages. (CVE-2025-62508/GHSA-g955-vw6w-v6pp)
• 📖 Improve emphasis styles for East Asian scripts
  clreq: dots are used in both horizontal and vertical writing modes.
  mlreq: wavy lines are used instead of dots.
• 🔍 Search shortcuts are now keyboard layout-independent
  Search shortcuts such as / and Ctrl+K now work regardless of the keyboard layout.

Many thanks to those who contributed to the recent releases! Citizen is a better skin thanks to you! 🎉

Changelog

Features

• icon: ✨ add microinteraction for configure icon (8f55d2d)
• search: ✨ make search shortcuts keyboard layout-independent (by @Vonavy) (6c806b5)
• typography: ✨ improve emphasis styles for East Asian scripts (by @AmeroHan) (#1165) (4e82bdc)

Bug Fixes

• layout: 🐛 fix page tools center alignment on main page (by @Vonavy) (#1167) (e72c859)
• menu: 🐛 language card goes off-screen when page title is too long (by @dringsim) (70181e4)
• SECURITY: 🐛 fix stored XSS in sticky header button messages (by @SomeMWDev) (e006923)
• tokens: 🐛 fix layout issues with fractional viewport sizes (by @AmeroHan) (7ae0f48)

New Contributors

• @AmeroHan made their first contribution in #1163

Full Changelog: v3.9.0...v3.8.0

v3.8.0

3.8.0 (2025-10-06)

Highlights

• ⚙️ Configurable Header Position
  You can now customize the header's position on the page using the $wgCitizenHeaderPosition setting. Supported values are top, bottom, left, and right. (Thanks, @Vonavy!)

• ⚡️ New Performance Mode
  A new performance mode has been added to improve responsiveness by disabling frosted glass and transition effects. The skin automatically enables this mode on page load and disables it if GPU acceleration is detected. You can manually enable or disable it using the Performance mode button in the preferences.

• 🖼 Improved Page Backgrounds
  Backgrounds applied to the .citizen-page-container are now correctly displayed underneath the header. This should benefit those who are using semi-transparent header backgrounds.

Changelog

Features

• core: ✨ make site header position configurable (by @Vonavy) (ff2f22a)
• header: ✨ use CSS variables to define header behavior (5b611c5)
• header: ✨ use padding instead of margin for page container (41a472f)
• pref: ✨ add performance mode client preferences (0a01979), closes #1151
• pref: ✨ apply performance mode if it is not set and GPU accel is not avaliable (22ae76f)

Bug Fixes

• CodeMirror: 🐛 fix the misaligned CodeMirror v6 overlay on VE (by @xtexx) (#1139) (555babe)
• commandPalette: 🐛 use page.key for id (by @TiggeZaki) (bbd9e1d)
• debugToolbar: 🐛 fix ToC button above the debug toolbar (ada6352)
• overflow: 🐛 add inline margin to prevent clipping borders (68325a0)
• prefs: 🐛 fix incorrect opacity and backdrop filter for performance mode in dark mode (f8c3cf9)
• search: 🐛 fix double escaping in legacy search box (by @SomeMWDev) (#1135) (abbee1d)
• search: 🐛 remove aria-details if using command palette (by @TiggeZaki) (3fda30f)
• sidebar: add icon to special pages link in sidebar for MW 1.44+ (05a4fbe)
• SyntaxHighlight: 🐛 remove background color that exceeds the border (by @TiggeZaki) (#1145) (3c083f0)
• tokens: 🐛 include unit in CSS variables with zero as value (77d7c09), closes #1152

Performance Improvements

• preferences: ⚡️ only load preferences module when preference button is clicked (9fe31f4)

Miscellaneous Chores

• composer: 🔧 sync package description (6e0cb50)
• deps-dev: 🔗 pin ESLint to 8.57.0 (e7c8264)

New Contributors

• @xtexx made their first contribution in #1139

Full Changelog: v3.7.0...v3.8.0

v3.7.0

3.7.0 (2025-09-22)

Highlights

• 👾 Two new backported Codex icons.
  The settings icon and the 'back to top' button have been updated with shiny new icons from Codex: 'configure' and 'arrow up' respectively.

• ✨ Special pages in the sidebar are now special again!
  No more seeing double! We've fixed a bug that created duplicate 'Special pages' links in the sidebar on MediaWiki 1.44 and above.

• 🍷 Simpler and more consistent frosted glass.
  We've swapped our fancy frosted glass for a simpler, more consistent effect. It's faster, looks great, and is easier for you to customize.

Changelog

Features

• core: ✨ add transition for icons that uses content-visibility (57837fa)
• core: ✨ simplify frosted glass implementation (8c10712)
• core: ✨ use Codex arrow up icon for back to top icon (6d61fc8)
• core: ✨ use subtle borders for inner border (c30c040)
• mediawiki: ✨ tweak change list date font styles (36b77f4)
• preferences: ✨ replace setting gear icon with configure icon (d835649)
• tokens: ✨ increase border color contrast (02b67b8)

Bug Fixes

• commandPalette: 🐛 do not reuse menu ID (b4d8513)
• core: 🐛 include settings icon in skin module (5afe8d1)
• core: 🐛 use --color-visited--active (c32e8cd)
• OOUI: 🐛 fix incorrect indicator style in framed tabs (7bc4c35)
• sidebar: 🐛 fix incorrect ID for special page link in sidebar (7ff58fc)
• sidebar: 🐛 only add special page link on MW 1.43.X (2c36fc9)
• stickyHeader: 🐛 use edit icon when source edit is the only button (9095ce7)

Performance Improvements

• icons: ⚡️ use SVG instead of base64 for configure icon (6e7b1cd)

New Contributors

• @TiggeZaki made their first contribution in #1129

v3.6.0

3.6.0 (2025-09-06)

Highlights

• 👓 Not a fan of frosted glass?
  You can now control the frosted glass background by changing the CSS variable --opacity-glass. Setting it to 1 will turn off the effect.
• 🖼 MultimediaViewer for the fans of frosted glass
  We have improved the styles in MultimediaViewer to match with current state of the skin.

Changelog

Features

• core: ✨ add transition to sticky element (291d266)
• core: ✨ simplify and improve loading indicator styles (3f95e54)
• MultimediaViewer: ✨ improve dialog styles (9d8d557), closes #1096
• MultimediaViewer: ✨ improve lightbox styles (c97a259)
• stickyHeader: ✨ enhance click handling and target setup (1f8b364), closes #1100
• tokens: ✨ add opacity-glass variable for frosted glass background (a619b1e)
• userMenu: ✨ tweak font sizing (32a303c)

Bug Fixes

• Codex: 🐛 fix incorrect quiet button hover color for MW 1.44+ (4cc33d2), closes #1105
• core: 🐛 cast key to string when adding icons to menu items (c574159), closes #1103
• core: 🐛 do not add site tools if it exists (56a1e79), closes #1116 #1117
• mediawiki: 🐛 fix overlapped sticky header in Special:ApiSandbox (#1120) (721e20e)
• use pre-1.45 namespace for LanguageConverterFactory (fa0342e)

Performance Improvements

• core: ⚡️ rewrite collapsible section parser (6a7c36c)

v3.5.0

3.5.0 (2025-07-21)

Highlights

• 🔗 Command Palette links are now the real deal!
  No more tricky buttons, you can now open them in new tabs or windows just like you'd expect.
• 🕵️‍♀️ Search trigger just got smarter!
  You can now pre-fill the search box using a super handy search trigger. Want to master this new trick? Find out how here!
• 🎨 Our box shadows got a fresh new look!
  We also tidied up our shadow variables to match with Codex, so drop-small is now simply small, drop-medium is medium, and drop-xx-large is large.

Changelog

Features

• CommandPalette: ✨ use <a> or <button> respectively (7e6bfe4), closes #1089
• core: ✨ add disabled styles for default HTML elements (6445ecd), closes #885
• core: ✨ tweak box shadow styles (0847197)
• Search: ✨ enhance citizen-search-trigger to support pre-filling input (5dce5a2)
• tokens: ✨ deprecate box-shadow-drop variables (6c1c60f)

Bug Fixes

• #885 (6445ecd)

v3.4.0

3.4.0 (2025-07-03)

Highlights

• ⚠️ This release contains important security fixes, please update to this version when possible.
• Legacy classes such as skin-citizen-light and skin-citizen-dark are now hard-deprecated. See here for migration examples.
• Minor bug fixes and improvement™

Changelog

Features

• catlinks: ✨ update category pill styles (eaa043e)
• commandPalette: ✨ add transition to list actions (3eb5275)
• commandPalette: ✨ use frosted glass effect as background (dfdcc2a)
• ManageWiki: ✨ drop unused ManageWiki styles (e498e9a)
• ReplaceText: ✨ revamp ReplaceText styles (cf4ff02)
• SemanticMediaWiki: ✨ update styles to 5.0.2 (5720476)

Bug Fixes

• search: 🐛 fix incorrect position for old search card (10b336f)
• SECURITY: 🐛 🔒️ sanitize search result descriptions in old search module (aedbceb) (CVE-2025-53368)
• SECURITY: 🐛 🔒️ sanitize short description page tagline (c85a40b) (CVE-2025-53370)
• stickyHeader: 🐛 fix sticky header title alignment on user pages (835e02d), closes #1080

Performance Improvements

• commandPalette: ⚡️ use regex exec over string match (426105c)
• pageHeading: ⚡️ remove redundant method call (b554d03)
• prefs: ⚡️ use regex exec over string match (0d22c32)

v3.3.2

3.3.2 (2025-06-12)

Bug Fixes

• CookieWarning: add missing styles import (#1078) (ab5efaf)
• DataMaps: add missing styles import (44782c8)
• typography: 🐛 rollback <small> element styles (37ee040), closes #1074

Miscellaneous Chores

• Math: 🔧 🗑️ remove Math extension styles and references (6fba95e)
• variables: 🔧 🗑️ remove unused variables (d2f7561)
• WikiHiero: 🔧 🗑️ remove WikiHiero extension and associated styles (cea735a)

v3.3.1

3.3.1 (2025-06-11)

Bug Fixes

• layout: 🐛 fix incorrect --width-page for extended pages (ac273af)
• security: 🐛 🔒️ fix various stored XSS system message vulnerabilities (93c36ac) (CVE-2025-49575, CVE-2025-49576, CVE-2025-49577, CVE-2025-49578, CVE-2025-49579)
• styles: 🐛 correct font-family variable for overline text (407052e)

Miscellaneous Chores

• 🔧 add stylelint Baseline config (4b44f69)