Release Notes

What's new

• Live Preview is supported in the REST API. #5623 by @jasonvarga
• Query builders can accept page name and number. #5602 by @mattmurtaugh
• Added csrf parameter to form tag. #5626 by @robdekort
• Added has_focus variable to assets. #5638 by @jasonvarga
• Added playtime variable to assets. #5586 by @jackmcdade

What's improved

• Redesigned Search Index Utility. #5625 by @jackmcdade
• Removed primary style on the Asset browser's "Create Container" button. #5629 by @jackmcdade
• Expanded Windows testing. #5613 by @jesseleite
• Updated Swedish translations. #5615 #5620 #5617 #5616 by @jannejava
• Made asset editor full width. #5608 by @jackmcdade
• Asset fields will auto-select the container when only one exists. #5498 by @duncanmcclean

What's fixed

• The to_json modifier can handle query builders. #5635 by @jasonvarga
• Fix is_external check for anchors. #5631 by @grandpalacko
• Fix Asset Editor not showing HTML5 players. #5607 by @jackmcdade

What's improved

• Update French translations. #5540 by @ebeauchamps
• Link to automatic titles section in the docs. #5553 by @jackmcdade

What's fixed

• Prevent filtering users by password hashes in the APIs. #5568 by @jasonvarga
• Prevent usage of null as filesystem paths. #5562 by @jasonvarga
• The glide tag pair can handle query builders. #5552 by @jasonvarga
• Fix Flysystem 3 support in Glide. #5551 by @jasonvarga
• Make isset on properties work. #5530 by @jasonvarga
• Range fields can now use 0 as a value or default. #5538 by @jasonvarga

What's new

• Ability to make fields read only through the Blueprint builder. #5379 by @jackmcdade

What's improved

• Update German translations. #5511 by @helloDanuk

What's fixed

• Fix issue in Runtime parser where augmenting within an expression could alter the scope. #5525 by @JohnathonKoster
• Fix Grid fields not converting to JSON by making Values implement JsonSerializable. #5524 by @jasonvarga
• Fix error when determining slug language on non-entry forms. #5523 by @jasonvarga
• Fix nested query builder access in Regex parser. #5521 by @jasonvarga
• Fix Runtime parser not supporting dashes in variable names. #5516 by @JohnathonKoster
• Fix Flysystem error on Cache Manager utility page. #5509 by @jesseleite

Read First 👀

Be sure to read the Upgrade Guide first as manual changes (especially if you're running on Laravel 7) may be necessary. You can also read the Statamic 3.3 Launch Announcement blog post to learn about many of the new features in depth!

What's new

• New Antlers Parser.
• Laravel 9 support.
• Headless Live Preview.
• Frontend form field conditions.
• Improved Blade interoperability.
• Blade tag/modifier helpers.
• Statamic::query() aliases to query builders.
• Entries and other data objects can use magic property access to get augmented values.
• Entries and other data objects can use magic methods to get query builders.
• Entries and other data objects are Arrayable.
• The static:warm command may leverage the queue.
• Hidden blueprints now have visual indicators.
• You now have more control over how values should be stored for querying. (e.g. date fieldtypes store Carbon instances.)
• Date-based where clauses are now supported by query builders.

What's fixed

• The new parser fixes an impressively large number of issues.

Major changes

• PHP 7.2 and 7.3 are no longer supported.
• Laravel 6 and 7 are no longer supported.

Special note

• Control Panel forms now only submit visible fields (as originally intended) which fixes sometimes/required_if/etc validation rules, among other things. This could potentially be a breaking change if you were using field conditions purely for cosmetic showing/hiding of form fields.

Everything else

• Review the rest of the changes in the upgrade guide.

What's fixed

• Prevent filtering users by password hashes in the APIs. #5604 by @jasonvarga
• Fix error when determining slug language on non-entry forms. #5603 by @jasonvarga

What's new

• Support whereJsonContains, whereJsonDoesntContain, and whereJsonLength in the query builder. #4707 by @ryanmitchell
• Add ability to select assets in the link fieldtype. #4647 by @jacksleight
• Add origin_id to augmented entry data. #5455 by @jasonvarga

What's improved

• Updated French translations. #5465 by @ebeauchamps
• Slugification is language-aware. #5494 by @jasonvarga

What's fixed

• Fix division by zero error when calculating asset ratio. #5488 by @arthurperton
• Register Variables debugbar collector once. #5448 by @michaelr0
• Fix link fieldtype not updating when switching sites. #5447 by @jasonvarga
• Fix a few asset issues. #5433 by @jasonvarga
• Fix nav tag's is_current and is_parent variables. #5292 by @arthurperton

What's improved

• Updated Swedish translations. #5421 by @jannejava

What's fixed

• Fix validation related error in Grid fields. #5424 by @jasonvarga
• Fix user wizard icon size. #5423 by @duncanmcclean
• Fix rare GitHub auth error output in the starter-kit:install command. #5410 by @jesseleite

What's new

• The route tag can be used with a name parameter. #5407 by @ryanmitchell
• The CP updater will prevent you upgrading to a version that could require manual changes. #5401 by @jasonvarga

What's fixed

• Namespaced translation methods #5144 by @jasonvarga
• The range fieldtype will save integers. #5391 by @jackmcdade

What's fixed

• Fixed casing of pdfobject import.

(Assets are missing from this release. Fixed in 3.2.35)

What's new

• New PDF viewer that doesn't rely on Google Docs and allows previewing of PDFs in private containers. #5349 by @edalzell
• Add duration to asset augmentation. #5265 by @schmidex
• Form validation rules are queryable in GraphQL. #5344 by @arthurperton
• Support when, unless, and tap in the query builder. #5090 by @ryanmitchell
• Support taxonomy:term:not="something" syntax. #5206 by @jackmcdade
• Add ability to filter navigation trees. #5085 by @arthurperton
• The entry GraphQL query now supports the filter argument. #5119 by @strebl
• Add Malaysian translation. #5326 by @zunnurs01

What's improved

• Improve messaging around GitHub auth errors when installing Starter Kits. #5374 by @jesseleite
• Added a notification about an updated CLI tool when installing Starter Kits. #5338 by @jesseleite
• Provide a helpful exception if a site doesn't exist when viewing a collection. #5336 by @jackmcdade
• Update Swedish translations. #5330 #5329 #5328 by @jannejava
• Update German translations. #5321 by @helloDanuk
• Update French translations. #5261 by @ebeauchamps

What's fixed

• Fix issue where items would always be placed at the end of the tree when using numeric IDs (i.e. the Eloquent driver). #5283 by @ryanmitchell
• The reverse modifier will preserve keys when modifying a collection. #5340 by @Konafets
• Prevent replacements interfering with in regex validation rules. #5345 by @arthurperton
• Fix Grid UI when using date fields with time. #5364 by @arthurperton
• The entry GraphQL query will filter out drafts by default. #5119 by @strebl
• Fix incorrect query parameter replacement in the video fieldtype. #5317 by @arthurperton
• Remove null values from Grid. #5284 by @duncanmcclean
• The collection tag will respect the custom sort field and direction in the config. #5071 by @ryanmitchell
• Remove unused parameters from call to HTML::email() #5235 by @Konafets
• Remove unused replicator method. #5281 by @jasonvarga
• Bump ajv from 6.12.2 to 6.12.6 #5258 by @dependabot
• Bump url-parse from 1.5.6 to 1.5.10 #5359 by @dependabot
• Bump color-string from 1.5.3 to 1.9.0 #5276 by @dependabot
• Bump url-parse from 1.5.1 to 1.5.6 #5275 by @dependabot
• Bump ws from 5.2.2 to 5.2.3 #5274 by @dependabot
• Bump tmpl from 1.0.4 to 1.0.5 #5273 by @dependabot
• Bump follow-redirects from 1.14.1 to 1.14.8 #5263 by @dependabot

What's new

• Support whereBetween and whereNotBetween in the query builder. #4752 by @ryanmitchell
• Ability to add config fields to existing fieldtypes. #5077 by @aerni
• Add Polish translation. #5146 by @damianchojnacki
• Replicator/Bard/Grid fields can be validated against fields in the same set/row. #5047 by @arthurperton
• Add audio and video attributes to assets. #5045 by @edalzell

What's improved

• Improve performance of fetching user roles. #5120 by @jonassiewertsen
• The password protection page is translatable. #4894 by @jelleroorda

What's fixed

• Fix toggle fieldtype alignment issues. #5251 by @arthurperton
• Fix the list modifier not working with Collections. #5255 by @ryanmitchell
• Fix incorrect exception usage in Comb. #5223 by @Konafets
• Fix incorrect exception usage in the Agolia index. #5224 by @Konafets
• Fix the structures icon not inheriting color. #5230 by @aerni
• Removed duplicated logic in nav tag. #5210 by @arthurperton
• Revert type being a reserved word for field handles. #5184 by @jasonvarga
• Fix static caching not invalidating when a collection tree is deleted. #5170 by @Konafets
• Fix HTML snippet in Bard fieldtype related messages. #5145 by @Konafets
• Set the color fieldtype's color_modes default value correctly. #5137 by @Konafets
• Prevent additional data in blueprint YAML files being removed when saving. #5129 by @jasonvarga
• A bunch of code formatting fixes. #5218 #5214 #5219 #5215 #5189 #5158 #5134 #5142 by @Konafets

What's improved

• Improve performance of the nav tag. #4925 by @FrittenKeeZ
• Prevent entering negative values into max_items/max_files configs. #5044 by @edalzell
• Prevent using type as a field handle. #5088 by @arthurperton
• Default field names are suffixed to help prevent tag/variable collisions. #5084 by @arthurperton

What's fixed

• Fix infinite loop in UI when removing assets from asset fieldtype. #5070 by @arthurperton
• Fix widont inserting spaces into nested lists. #5115 by @benfreke
• Fix Replicator preview text generation. #5096 by @arthurperton
• Fix Eloquent query builder column selects. #5125 by @jasonvarga
• Fix "passed value cannot be an array" error. #5127 by @jasonvarga
• Fix unintentionally added new abstract query builder method. #5123 by @jasonvarga
• Fix nav tag's is_parent logic so it works better for Navs. #4969 by @arthurperton
• Throw a 404 instead of 500 on Glide asset URLs when there's an invalid container. #5094 by @edalzell
• Fix Replicator's "add set" button not inserting at the right position. #5107 by @arthurperton
• Fix the "delete" action confirmation translations. #5074 by @zsoltjanes
• Bump marked from 0.7.0 to 4.0.10 #5075 by @dependabot

What's new

• Ability to exclude certain fields from displaying in the REST API. #5041 by @arthurperton
• Ability to select fields in nav, locales, and collection tags. #5068 by @jasonvarga
• Add search to the user listing in the CP. #4084 by @arthurperton
• Support whereColumn in the query builder. #4754 by @ryanmitchell

What's fixed

• The static:warm command visits taxonomy URLs, excludes taxonomy URLs with no views, includes multisite taxonomy URLs, displays the URL count, and excludes excluded URLs. #5065 by @arthurperton
• Fix how localized terms and globals save their data and fall back to origin values. #4884 by @aerni
• Prevent nested Bard fields from going into fullscreen mode. #5059 by @jonassiewertsen
• Fix infinite loop when using nested Replicator fields. #5055 by @jasonvarga
• Replaced a hardcoded lang directory reference. #5054 by @Konafets
• Fix incorrect redirect when saving a taxonomy term. #5053 by @arthurperton
• Fix SVGs not displaying in private asset containers. #4991 by @arthurperton
• Fix saving not using the latest state when you hit save too quickly after typing. #5039 by @jackmcdade
• Fix some PHP 8.1 deprecation messages. #5063 by @edalzell
• Add allowed composer plugins. #5069 by @jasonvarga

What's new

• Support sub-field querying (JSON) in the query builder. #4758 by @ryanmitchell
• The collection tag (and others) can sort by sub-fields. #5030 by @jasonvarga
• Uploaded assets may be attached to form submission emails. #4726 by @jacksleight
• Provide errors indexed by fields for the user:reset_password_form tag. #4822 by @marcorieser
• DataCollection can use the first value of an array for sorting. #4967 by @arthurperton
• Add min_ and max_filesize validation rules for assets fieldtypes. #4980 by @arthurperton

What's improved

• The display field is auto-focused in the blueprint builder. #5026 by @jackmcdade

What's fixed

• Fix state mutations in Replicator, causing the page to freeze in some situations. #5031 by @arthurperton
• Fix the Asset's remove method not removing anything. #5038 by @arthurperton
• Fix inappropriate state mutations in Grid and Assets fieldtypes. #5005 by @arthurperton
• Fix terms not being sorted appropriately in other sites. #4982 by @arthurperton
• Fix the range field's derpy layout of uneven widths #5027 by @jackmcdade
• Fix View method chainability. #5020 by @jasonvarga
• Fix unnecessary dirty state when changing sites. #5013 by @jasonvarga
• Fix readonly sub-fields in localizable Grid and Bard fields. #4962 by @arthurperton

What's new

• Support where([...]) syntax in the query builder. #4899 by @ryanmitchell
• Added login throttling to user:login_form. #4971 by @arthurperton
• Add is_homepage variable to cascade. #4995 by @edalzell
• The pagination slider window can be adjusted. #5001 by @ryanmitchell

What's improved

• Updated French translations. #4976 by @ebeauchamps
• Updated German translations. #4998 by @helloDanuk

What's fixed

• Fix red error states when dealing with nested fields (Replicator, Grid, Bard). #5002 by @arthurperton
• Prevent error when when uploading assets in forms when there's no container configured. #4974 by @arthurperton
• Fix intersection error in iterator query builder, which search uses. #5006 by @jasonvarga
• In the fieldtype selector, hide empty sections, and hide slug for forms. #4948 by @jesseleite
• Link to docs in route config field. #4986 by @Konafets
• Fix reordering in a collection ending with the word "collection". #4978 by @arthurperton
• Fix changelog dates. #4973 by @markguleno