Release Notes

Read First

Be sure to read the Upgrade Guide first as manual changes may be necessary. You can also read the Statamic 5 Launch Announcement blog post to learn about many of the new features in depth!

What's new

• Laravel 11 support
• Sites can be managed in the control panel.
• Approved sites may use offline license validation.
• Laravel Reverb support
• Ability to fake SQL queries for the Stache.
• Ability to install first-party addons using install:eloquent-driver, install:ssg, and install:collaboration commands.
• The "default" values set on blueprint fields is now used across the board rather than only in the publish form.
• Glide URLs now always contain the original filename for better SEO.
• The Glide "hash" in its URLs can be customized.
• Addon test suite is included as part of the make:addon command.
• New syntax for escaping Antlers inside tag parameters.
• Ability for forms to have temporary files used as email attachments.
• Added pluck to the query builder.
• Form submissions have been upgraded to a full repository and query builder.
• The form submission listing in the control panel can be filtered.
• Entries etc are now JSON-serialized where appropriate.
• The GraphQL editor in the control panel (GraphiQL) has been updated and given a facelift.
• Tokens can be stored elsewhere, like a database.

What's improved

• A ton of performance improvements.
• Really, a lot of them. One bullet point isn't enough.
• Commands have received a fresh coat of paint using Laravel Prompts.
• Entry status is now queried more appropriately.
• Slug generation in the Control Panel is smarter.
• Slugs and handles are validated more appropriately.
• Blueprint and fieldset YAML files are easier to read. Unnecessary options are stripped out, and Bard/Replicator/Grid sets/fields keys are pushed to the end.
• SVG tags are sanitized by default.
• Improved error reporting when you have recursive fieldsets.
• Ignition suggestions have returned to exception messages.
• A bunch of under the hood code modernization and clean up.

What's changed

• Dropped support for Laravel 9 and PHP 8.0.
• There are a number of breaking changes. Consult the 5.0 upgrade guide.

What's fixed

• Add sanitization #10787 by @jasonvarga

What's fixed

• Fix Eloquent User notifications conflict. #10024 by @duncanmcclean
• Fix EloquentQueryBuilder orderby bug. #10023 by @duncanmcclean

What's improved

• French translations. #10017 by @PatrickJunod

What's fixed

• Fix queue worker state issue around assets. #9690 by @aerni
• Fix button group wrapping on non-fieldtype buttons. #10021 by @PatrickJunod
• Fix child URIs being outdated when parent slug changes. #9454 by @jacksleight
• Fix Eloquent ordering when using lazy() or chunk(). #9956 by @helloiamlukas
• Fix recursive editing check. #10012 by @duncanmcclean

What's new

• Add Vite content tag. #9973 by @jimblue
• Include alt field in shallow augmented assets. #10013 by @duncanmcclean

What's improved

• French translations. #10015 by @duncanmcclean

What's fixed

• Fix ButtonGroup from overflowing. #10000 by @PatrickJunod
• Fix docblock on Parse facade's template method. #10008 by @duncanmcclean
• Ensure blueprint tabs & sections always have handles. #10014 by @duncanmcclean
• Fix JSON being returned when using the back button sometimes. #10016 by @duncanmcclean
• Fix fullscreen button in Group Fieldtype. #10009 by @duncanmcclean
• Remove clear button of readonly date field. #9993 by @PatrickJunod

What's improved

• German translations. #9957 by @helloDanuk

What's fixed

• Fix Starter Kit installation on Windows. #9968 by @JohnathonKoster
• Fix starter-kit:install with custom branch when branch has slash. #9978 by @jesseleite
• Fix first child redirects when using array syntax. #9965 by @jasonvarga
• Fix wrong permission used for configuring navs. #9961 by @simonolog
• Fix DataReferenceUpdater when field data from array is null. #9954 by @duncanmcclean
• Fix dated collection listing when time is enabled. #9951 by @jacksleight
• Fix route parameters in Statamic routes with closures. #9953 by @arthurperton
• Fake composer installs in make command tests. #9955 by @jasonvarga

What's fixed

• Fix missing composer binary (starter kits couldn't install). #9950 by @duncanmcclean

What's improved

• French translations. #9939 by @ebeauchamps

What's fixed

• Require composer/semver instead of composer/composer. #9947 by @jasonvarga
• Fix DimensionsRule for Livewire. #9927 by @aerni
• Fix Blade compiler error. #9946 by @duncanmcclean
• Prevent passing HTML to the Video fieldtype. #9944 by @duncanmcclean
• Fix missing OAuth controller argument. #9942 by @simonolog

What's new

• Add deleteQuietly methods. #9666 by @ryanmitchell
• Support using closures for Statamic route data. #9868 by @arthurperton

What's fixed

• Fix single unpublished entries in listing column. #9917 by @jacksleight
• Prevent computed fields from being sortable in listing tables. #9916 by @duncanmcclean
• Fix Grid styles messing up row-controls of nested fields. #9910 by @duncanmcclean
• Fix icons color. #9895 by @peimn
• Fix Nova icon not displaying in Icon Fieldtype. #9906 by @duncanmcclean
• Add title fallback for roles & groups. #9907 by @duncanmcclean
• Fix Bard scrolling editor/page on link insert. #9886 by @jacksleight
• Hash API cache keys the key to handle long route and query parameters. #9858 by @Smef
• Fix regression on bard/replicator group set previews. #9901 by @caseydwyer
• Fix arrow direction in fav creator for RTL. #9897 by @peimn
• Fixes for asset/term reference updater strictness. #9878 by @jesseleite
• Add date to reserved fields for form blueprints. #9872 by @duncanmcclean
• Fix tables in Bard not saving updates. #9867 by @jacksleight
• Add tailwind safelist with horizontal margins and padding. #9864 by @jasonvarga
• Fix PHPUnit deprecations. #9912 by @jasonvarga

What's fixed

• Fix max depth validation on "Parent" field when collection has no max depth set. #9850 by @duncanmcclean
• Update URIs for mounted collection entries only if slug on mounted entry changed. #9851 by @marcorieser

What's new

• Bard hooks. #9823 by @jacksleight
• Ability to disable SVG sanitization on upload. #9839 by @duncanmcclean
• Add Edit Blueprint link to form page dropdown. #9840 by @jacksleight
• Track Laravel version in the Outpost. #9820 by @jasonvarga

What's fixed

• Prevent recursive editing via relationship fieldtype. #9841 by @duncanmcclean
• Improve array fieldtype validation for dynamically keyed fields. #9834 by @jesseleite
• Fix overlapping set group & set name in Safari. #9837 by @duncanmcclean
• Arr::wrap in/notIn values. #9833 by @ryanmitchell
• Fix filter preset issues. #9826 by @duncanmcclean
• Ensure redirects work for localized entries. #9819 by @duncanmcclean
• Fix OAuth login when using independent auth guards. #9816 by @duncanmcclean
• Fix icons in preference save options. #9827 by @duncanmcclean
• Prevent "Permanently added the ECDSA host key for IP address" from being logged as a Git error. #9828 by @duncanmcclean
• Fix deleted sets breaking Bard & Replicator. #9818 by @duncanmcclean
• Prevent overwriting filter views. #9792 by @duncanmcclean
• Fix serializing entries when slug property is a closure. #9791 by @duncanmcclean
• Use the configured Git binary in commands. #9793 by @duncanmcclean
• Enforce max depth when validating entry parent. #9799 by @duncanmcclean
• Fix new lines not working in user activation email. #9798 by @duncanmcclean
• Hide "Create Entry" button when all collection blueprints are hidden. #9744 by @duncanmcclean
• Bump vite from 4.5.2 to 4.5.3 #9821 by @dependabot

What's new

• Add tags blade directive. #9732 by @Jade-GG
• Ability to provide additional urls for static:warm. #9303 by @ryanmitchell
• Enable configuration of full measure static cache permissions. #9755 by @ryanmitchell
• Listing page state gets added to URLs to become shareable. #9408 by @jacksleight
• Add augmented hooks. #9625 by @ryanmitchell

What's improved

• French and English translations. #9774 by @ebeauchamps

What's fixed

• Fix Revealer state issues when closing Live Preview. #9797 by @jesseleite
• Fix Bard IME input in Safari. #9788 by @jacksleight
• Fix Glide cache not clearing on image reupload if append_original_filename is enabled. #9610 by @daun
• Update entry parent index on collection tree save. #9443 by @jacksleight
• Support chunk on query builders in Antlers. #9157 by @ryanmitchell
• Fix return type of AssetContainer:all(). #9777 by @daun
• Avoid using a pipeline if there are no Hooks registered. #9772 by @jasonvarga
• Enable pro fix and improvements. #9763 by @jesseleite
• Flush entire static_cache cache store when running static:clear. #9770 by @duncanmcclean

What's new

• Collections etc are hidden when unavailable to currently selected site in the CP. #9583 by @pdipatrizio
• Add ability to install starter kit from specific branch. #9766 by @jesseleite
• Widgets can be restricted to specific sites. #9600 by @aerni
• Add Ukrainian translations. #9750 by @osbre
• Add direct link to preferences. #9740 by @jasonvarga

What's improved

• Polish translations. #9771 by @PaperTurtle
• French translations. #9736 by @ebeauchamps
• Russian translations. #9722 by @dragomano
• Improve locale preference selector. #9739 by @jasonvarga
• Throw more helpful exception when invalid values are passed to whereCollection/whereTaxonomy methods. #9751 by @duncanmcclean

What's fixed

• Fix 403 views not using error template. #9768 by @edalzell
• Fix field locking user avatar size. #9761 by @duncanmcclean
• Fix markdown and code fieldtype read-only modes. #9764 by @duncanmcclean
• Fix blueprint error when creating user. #9276 by @duncanmcclean
• Allow slashes in comb search queries. #9754 by @ryanmitchell
• Add entry and term empty view permission checks. #9377 by @jacksleight
• Ensure changes to "Parent" get saved when using revisions. #9079 by @duncanmcclean
• Replace Mix paths with Vite paths in starter-kit.yaml stub. #9741 by @duncanmcclean
• Fix {{ nocache }} tag when URL contains URL fragment. #9742 by @duncanmcclean
• Add missing DocBlocks to the Markdown facade. #9746 by @osbre
• Add missing config items. #9734 by @jasonvarga
• Fix stacked grid margin-top styling. #9733 by @jesseleite
• Ensure pagination is always displayed at the bottom of collection widget. #9726 by @duncanmcclean
• Bump follow-redirects from 1.15.4 to 1.15.6 #9748 by @dependabot

What's improved

• Persian translations. #9711 by @peimn

What's fixed

• Fix "A field with a handle of X already exists" error when editing fieldsets. #9718 by @duncanmcclean
• Fix arrow direction in RTL. #9712 by @peimn

What's fixed

• Fix broken navigation tree. #9709 by @duncanmcclean