Released August 21, 2026

This release features Preline MCP support, AI Prompts for all Blocks, Animated Icons, Improvements and Fixes.

[!NOTE] At the moment, Preline MCP (terms apply) and Animated Icons are available for Preline Pro only.

• Components: Added a new Created with Preline MCP carousel showcase example.
• Docs: Added the AI Prompts guide with per-block prompt usage, agent setup guidance, and notes on AI output expectations.
• Docs: Added an Animated Icons page collecting the CSS icon marks, each looping so the motion can be watched without hovering.
• Components: Added native Tailwind CSS scrollbar width, gutter, and color examples to the Custom Scrollbar docs.

• Updated: Tailwind CSS to v4.3

• Fixed: Updated Advanced Datepicker calendar styles so week labels and date rows align correctly (weekend columns no longer disappear and the dates grid is no longer transposed into columns), with improved selected-range styling. #765 and #771
• Fixed: Fixed Advanced Range Slider chart theme syncing, and ApexCharts root theme handling.
• Fixed: Fixed Clipboard modal copy tooltip and icon visibility in the modal example.
• Improvement: Added request and requestCompleted events to Advanced Select to track the lifecycle of apiUrl requests (search and apiLoadMore pagination), useful for showing loading indicators. #767
• Fixed: Fixed Advanced Select apiUrl requests throwing an "Invalid URL" error when apiUrl was set to a relative path. #761 and #762
• Fixed: Updated the Advanced Select documentation to add the previously undocumented value, viewport, dropdownDirectionClasses, dropdownSpace, searchTemplate, searchWrapperTemplate, searchWrapperClasses, apiPageStart, and apiTotalPath options, extend apiFieldsMap with page, offset, and limit, replace the stale optionGroupTemplate entry with optgroupTag, and fix the additionalClasses option name typo. #763 and #764
• Fixed: Fixed Tree View isIndeterminate option using || instead of ?? for its fallback, which incorrectly forced the default true value even when explicitly set to false. #759
• Fixed: Fixed Advanced Select's addOption setting the data-hs-select-option attribute to the string "undefined" when no options object was passed; it now serializes as "null" instead. #760
• Fixed: Fixed reverse (Shift+Tab) keyboard navigation escaping the Modal, Offcanvas, Dropdown, and Advanced Select focus traps instead of cycling within them. #770

Full changelog: https://preline.co/docs/changelog.html#v5.0

Adds Marquee components, expands Stepper and Spinner examples, adds 13 framework guides, and includes Tailwind CSS v4.2.x support plus dropdown and scrollspy fixes.

New Components & Improvements

• Customization: Tailwind CSS v4.2.x new color palettes added to all components.
• Navigations: Expanded the Stepper docs with new vertical examples for static, linear, white, solid, and dynamic linear variants.
• Components: Added new Marquee components with text ticker, logo marquee, vertical, 3D, finance ticker, and card marquee examples.
• Components: Expanded the Spinners docs with new throbber, ring, pulse dot, wave, bars, terminal, blinking caret, shimmer text, loading dots, and ellipsis examples.
• Docs: Added a new Components index page to help users browse all Preline docs by category.
• Docs: Added specific Preline UI JavaScript guides for HTML + Vite, Hugo, Express, React + Vite, Next.js, Remix, Vue.js, Nuxt.js, Angular, Ember.js, Svelte, SolidJS, and Qwik.

Updates

• Updated: Tailwind CSS to v4.2.x
• Updated: Replaced legacy aspect-ratio plugin usage with native Tailwind CSS aspect-ratio utilities and removed the @tailwindcss/aspect-ratio dependency.

Fixes and Improvements

• Fixed: Preserve selected remote options in dropdown across searches in tags mode and fix crash when re-selecting an option after a subsequent search. [Issue #752]
• Fixed: Fix browser back button navigating away from page instead of returning to previous section by replacing replaceState with pushState and adding a popstate listener in scrollspy. [Issue #749]

Fixes and Improvements

• Fixed: Documentation updated according to the latest Preline release. [Issue #746]
• Fixed: Add wildcard exports for css, src, dist and variants.css to support bare specifier imports.

This update addresses a plugin export issue that could cause incorrect behavior. Now, the installation docs includes the additional options for manual initialization.

Fixes and Improvements

• Fixed: Resolved an issue with plugin exports that could cause plugins to be incorrectly exposed or unavailable in certain setups. [Issue #745]

This update adds missing Themes CSS files to the NPM package.

This update addresses core architecture improvements for plugins, other general improvements and fixes from Github issues.

Fixes and Improvements

- Improvements: Improved module entry architecture to support better tree-shaking by separating auto-init and manual-init flows. Added a dedicated preline/non-auto entry for explicit initialization, while preserving preline as the plug-and-play auto-init path. Also marked side-effectful entries explicitly and kept per-plugin imports preline/plugins/* as the recommended on-demand integration path.[Issue #697]. - Improvements: Add searchMatchMode to HSSelect ("substring", "chars-sequence", "token-all", "hybrid") to improve multi-word and non-consecutive matching, so queries like "Alpha Charlie" can match "Alpha Bravo Charlie Delta" while keeping legacy isSearchDirectMatch backward compatible. [Issue #730] - Fixed: HSOverlay.autoInit() re-initialization behavior after dynamic DOM updates to ensure overlays close correctly and restore the hidden state without getting stuck open. [Issue #704] - Fixed: Incorrect positioning of fixed dropdowns inside sticky containers. - Fixed: Accessibility issues within nested components. - Fixed: Fixed tooltips getting stuck in some cases - for example, when scrolling the page quickly, they wouldn’t disappear.

• Issue [#742]

This update introduces Preline Themes, a new foundation for customization and visual identity, along with numerous improvements, bug fixes, and new framework guides.

Themes are defaulted to all Preline content but they are optional. You may use full utility classes instead. All components, examples and templates comes with Copy Utility Classes option.

New

• Customization: Themes
• Customization: Tailwind Colors
• Automation: Agent Skills
• Framework Guides:
• • HTML + Vite
• • Livewire
• • Symfony
• • Ruby on Rails
• • Phoenix LiveView
• • Ember.js
• • Flask
• • Django
• • Express.js
• • Blazor
• • ASP.NET Core
• Components: Tabs as inner menu
• Components: Mega Menu to Overlay on Mobile Resoultion
• Components: Tabs: Open on hover
• Components: Advanced Select: Optgroup
• Components: Advanced Select: Multiple optgroup
• Components: Advanced Select: Custom template with colored square indicators
• Components: Switch: Shape

Fixes and Improvements

• Fixed: role="region" added to the collapse components to address the latest W3C Nu HTML Checker and Lighthouse/axe-core accessibility rules
• Previously, validators were more permissive about aria-labelledby on any element. Recent accessibility rules became stricter and now enforce that aria-labelledby cannot be used on a <div> unless that <div> has an allowed role.
• Fixed: Remove the duplicated search input in "tags" mode. [Issue #677]
• Fixed: Links inside the dropdown now respond to the Enter key for accessibility. [Issue #691]
• Fixed: Issue with fast typing and pasting data in the combobox. [Issue #692]
• Fixed: Bug in advanced select with infinite scroll paging. [Issue #693]
• Fixed: Double URL encoding in advanced select remote data API calls. [Issue #695]
• Fixed: Text inputs not responding to keyboard input within dropdown components. [Issue #700]
• Improvement: Added support for blank values in input number component. [Issue #702]
• Fixed: Input number max value validation not updating input field in real-time. [Issue #708]
• Improvement: Advanced Select now properly renders <optgroup> elements. [Issue #710]
• Fixed: HSDatePicker now recalculates its position on open (using Floating UI), preventing the calendar from rendering off-screen. [Issue #713]
• Fixed: Form elements inside the overlay no longer prevent the Enter key while focused. [Issue #723]
• Fixed: Add support for pre-rendering selected options on initial load. [Issue #733]
• Improvement: Improved image validation for icons. [PR #672]
• Fixed: data-hs-overlay-keyboard="false" now works as intended — overlays/modal windows no longer close when pressing ESC if the attribute is disabled. [PR #694]
• Improvement: Add support for extracting date separators from dateFormat. [PR #717]
• Improvement: Improve scrollbar width calculation for different screen resolutions. [PR #735]

Fixes and Improvements

• Fixed: Issues related to dropdown menus. [Issue #684]

Fixes and Improvements

• Fixed: Build issue related to the "externals" parameter in "webpack.config.js" [Issue #680], [Issue #681]