NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #3143 most downloaded on Packagist
Craft CMS
Latest stable
5.12.1
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
1348 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Fixed a low-severity XSS vulnerability. (GHSA-fvwq-45qv-xvhv)
X-Craft-Gql-Cache: no-cache header, or if the request contained any mutations. (#18348)config/twig-sandbox.php can now include an allowedClasses array, with class names whose entire collection of properties and methods should be allowed in sandboxed Twig environments.craft\base\ElementInterface, craft\fields\data\ColorData, craft\fields\data\MultiOptionsFieldData, craft\fields\data\OptionData, and yii\base\Event are now allowed in their entirety within sandboxed Twig environments.craft\web\View::renderSandboxedObjectTemplate() and renderSandboxedString() weren’t properly sandboxing templates rendered from the control panel.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixed an error that could occur when updating to Craft 4.17 on environments with allowAdminChanges disabled.
allowAdminChanges disabled. (#18332)Fixed a bug where image transforms with invalid position properties weren’t being handled properly.
Fixed low-severity XSS vulnerabilities. (GHSA-4mgv-366x-qxvx)
composer.json are now set with caret operators (e.g. ^1.2.3). (#18297)clear-cache command now accepts a space-delimited list of cache IDs that should be cleared.up command now warns about any astray license issues before running migrations. (#18297)up command rather than from migrate commands.enableTwigSandbox config setting. (#18208, #18216)disableGraphqlTransformDirective config setting is now deprecated.foo/$ENV_NAME/bar or foo-${ENV_NAME}-bar). (#17949)yii\base\BaseObject via the create() Twig function. (GHSA-94rc-cqvm-m4pw)uuid() Twig function.@parseRefs and @transform GraphQL directives are now optional for each GraphQL schema. (GHSA-7x43-mpfg-r9wj)craft\base\ElementInterface::setAttributesFromRequest().craft\services\Search::deleteOrphanedIndexJobs().craft\web\GqlResponseFormatter.craft\web\Response::FORMAT_GQL.craft\web\View::renderSandboxedObjectTemplate().craft\web\View::renderSandboxedString().craft\web\View::renderSandboxedTemplate().craft\web\twig\AllowedInSandbox. (#18219)craft\web\twig\SecurityPolicy.craft\web\twig\nodes\BaseNode.craft\helpers\FileHelper::writeToFile() now throws an exception if the file path isn’t writable, or there isn’t sufficient free space on the disk. (#17762)craft\helpers\UrlHelper now encodes square brackets in generated URLs. (#17840)craft\web\Request::accepts() now accepts wildcard characters (*) in the $contentType argument, to check for a range of MIME types (e.g. application/*+json).craft\web\Request::getAcceptsJson() now returns true for requests with Content-Type headers that match application/*+json, in addition to application/json._includes/forms/radio.twig template now escapes the label variable. A raw HTML label can be passed by wrapping the label value in raw() or craft\helpers\Template::raw().Craft.ui.createCheckbox() now escapes the config.label property. A raw HTML label can be passed via the config.labelHtml property.Craft.ui.createSelect() now escapes options’ label properties. Raw HTML labels can be passed via labelHtml properties.Content-Type header to application/graphql-response+json.users/send-password-reset-email requests. (#17337)search query param if present on the initial request.Fixed a high-severity user account enumeration vulnerability. (GHSA-234q-vvw3-mrfq)
composer.json are now set with caret operators (e.g. ^1.2.3). (#18297)up command now warns about any astray license issues before running migrations. (#18297)search query param if present on the initial request.Fixed low-severity XSS vulnerabilities. (GHSA-4mgv-366x-qxvx)
clear-cache command now accepts a space-delimited list of cache IDs that should be cleared.up command rather than from migrate commands.enableTwigSandbox config setting. (#18208, #18216)disableGraphqlTransformDirective config setting is now deprecated.foo/$ENV_NAME/bar or foo-${ENV_NAME}-bar). (#17949)yii\base\BaseObject via the create() Twig function. (GHSA-94rc-cqvm-m4pw)uuid() Twig function.@parseRefs and @transform GraphQL directives are now optional for each GraphQL schema. (GHSA-7x43-mpfg-r9wj)craft\base\ElementInterface::setAttributesFromRequest().craft\services\Search::deleteOrphanedIndexJobs().craft\web\GqlResponseFormatter.craft\web\Response::FORMAT_GQL.craft\web\View::renderSandboxedObjectTemplate().craft\web\View::renderSandboxedString().craft\web\View::renderSandboxedTemplate().craft\web\twig\AllowedInSandbox. (#18219)craft\web\twig\SecurityPolicy.craft\web\twig\nodes\BaseNode.craft\helpers\FileHelper::writeToFile() now throws an exception if the file path isn’t writable, or there isn’t sufficient free space on the disk. (#17762)craft\helpers\UrlHelper now encodes square brackets in generated URLs. (#17840)craft\web\Request::accepts() now accepts wildcard characters (*) in the $contentType argument, to check for a range of MIME types (e.g. application/*+json).craft\web\Request::getAcceptsJson() now returns true for requests with Content-Type headers that match application/*+json, in addition to application/json._includes/forms/radio.twig template now escapes the label variable. A raw HTML label can be passed by wrapping the label value in raw() or craft\helpers\Template::raw().Craft.ui.createCheckbox() now escapes the config.label property. A raw HTML label can be passed via the config.labelHtml property.Craft.ui.createSelect() now escapes options’ label properties. Raw HTML labels can be passed via labelHtml properties.Content-Type header to application/graphql-response+json.users/send-password-reset-email requests. (#17337)Fixed low-severity XSS vulnerabilities. (GHSA-6j87-m5qx-9fqp, GHSA-3jh3-prx3-w6wc)
purgeStaleUserSessionDuration config setting was set to a duration interval string. (#18238)type param was used. (#18223)Fixed SSRF vulnerabilities. (GHSA-96pq-hxpw-rgh8, GHSA-m5r2-8p9x-hp5m, GHSA-8jr8-7hr4-vhfx)
utils/fix-field-layout-uids command now checks for duplicate top-level field layout UUIDs. (#18193)Fixed RCE vulnerabilities. (GHSA-255j-qw47-wjh5, GHSA-742x-x762-7383)
lazyGqlTypes config setting was enabled. (#18014)@. (#18123)Fixed a bug where assets with disallowed file extensions could still be uploaded to the system’s temp directory.
Reverted an element query performance optimization for MySQL 9.
.env if the environment variable didn’t exist yet. (#17942)new is now a reserved filesystem handle.
new is now a reserved filesystem handle.utils/fix-field-layout-uids command. (#17848)EVENT_DEFINE_EXTRA_FIELDS event wasn’t getting triggered for elements. (#17866)craft\services\Assets::EVENT_AFTER_REPLACE_ASSET events weren’t getting triggered when replacing an asset file via GraphQL. (#17005)Fixed a bug where entries’ and categories’ descendants’ URIs weren’t always getting updated after a parent’s URI changed.
When searching for elements, partial matches within titles are now scored higher than exact matches in other fields.
sort query string parameter, so the selected sort option could revert back if the window was reloaded. (#17761)Improved the performance of element queries.
Fixed a bug where the folderPath asset query param required a trailing slash. (craftcms/html-field#18)
folderPath asset query param required a trailing slash. (craftcms/html-field#18)Added craft\services\UserPermissions::reset().
craft\services\UserPermissions::reset().craft\elements\Asset::getFormattedSizeInBytes() wasn’t returning null when the asset’s size property was null. (#17695)Fixed a potential session leakage vulnerability.
Deprecated craft\helpers\User::getLoginFailureMessage().
craft\helpers\User::getLoginFailureInfo().craft\helpers\User::getLoginFailureMessage().preventUserEnumeration was enabled.The Craft 5 Upgrade utility now has a “Prep composer.json” button, which displays the project’s composer.json file, updated with Craft 5-compatible de
craft\helpers\Json::detectIndent().craft\helpers\Json::encodeToFile().craft\helpers\Json::reindent().newUser set to true. (#17659)Craft no longer logs warnings for requests that don’t meet the user agent and IP requirements for maintaining a user session, unless a PHP session alr
Fixed an information disclosure vulnerability.
Fixed a potential remote execution vulnerability.
Fixed a potential user account enumeration bug when preventUserEnumeration was enabled.
preventUserEnumeration was enabled.Fixed a bug where an unsaved changes warning would be shown when leaving an element edit form, if a conditional field had just been shown or hidden in
Element condition builders now show condition rules for custom fields with duplicate names.
craft\fields\BaseRelationField::canShowSiteMenu().craft\queue\BaseBatchedJob::after().craft\queue\BaseBatchedJob::afterBatch().craft\queue\BaseBatchedJob::before().craft\queue\BaseBatchedJob::beforeBatch().craft\fields\data\ColorData now extends craft\base\Model and includes blue, green, hex, luma, red, and rgb attributes in its array keys. (#17265)Table fields with “Static Rows” enabled now get populated with the default row values when their value is null.
null. (#17452)It’s now possible to mutate Table field data via GraphQL using custom column handles, rather than just the column IDs.
--language option was required when running the install command non-interactively.Fixed a bug where HUDs could be positioned incorrectly if their trigger element had been scrolled since the last time the HUD was opened.
Improved error responses for assets/generate-transform requests.
assets/generate-transform requests. (#17228)Return URLs are now sanitized before being saved to the PHP session.
craft\helpers\StringHepler::replaceMb4(). (#17202)_includes/forms/button.twig wasn’t rendering labels set to '0'. (#17225)Fixed a PHP deprecation error that could occur when applying the replace Twig filter to a null variable.
forms.checkboxField macro wasn’t respecting fieldset and checkboxLabel keys passed into its config.replace Twig filter to a null variable. (#17159)Fixed a bug where static relational field inputs weren’t showing the related elements’ hierarchy.
notificationDuration value per the accessibilityDefaults config setting wasn’t being respected for users who hadn’t saved their preferences yet.omitScriptNameInUrls and usePathInfo config settings were both disabled. (#17147)Condition rules for Checkboxes, Dropdown, Multi-select, and Radio Buttons fields now include “has a value” and “is empty” operators.
db/repair command. (#16812)--batch-size option for resave/* commands. (#16586)plugin/install command now accepts an edition argument, and prompts for the default edition if none is specified. (#17030)plugin/uninstall command now reports if no plugin is installed with the provided handle. (#17030)users/create command now prompts to send an activation email, or outputs an activation URL. (#16794)searchTermOptions GraphQL query argument. (#16979)revisionNotes GraphQL entry mutation argument. (#16943)aria-label attributes via an ariaLabel property.craft\base\ElementInterface::getSerializedFieldValuesForDb().craft\base\FieldInterface::serializeValueForDb().craft\base\conditions\BaseMultiSelectConditionRule::$includeEmptyOperators.craft\db\Connection::getIsMaria().craft\db\Table::SEARCHINDEXQUEUE_FIELDS.craft\db\Table::SEARCHINDEXQUEUE.craft\db\mysql\QueryBuilder::jsonContains().craft\db\mysql\QueryBuilder::jsonExtract().craft\db\pgsql\QueryBuilder::jsonContains().craft\db\pgsql\QueryBuilder::jsonExtract().craft\events\UpdateReleaseEvent.craft\models\UpdateRelease::EVENT_IS_CRITICAL.craft\models\UpdateRelease::isCritical().craft\queue\ReleasableQueueInterface. (#16672)craft\records\User::haveIndexAttributesChanged().craft\services\Search::indexElementIfQueued().craft\services\Search::queueIndexElement().craft\cache\ElementQueryTagDependency now merges cache tags provided by the element query with any tags already set on its $tags property.craft\services\Users::ensureUserByEmail() now prioritizes credentialed users.craft\queue\Queue::release() and releaseAll() now call release() and releaseAll() on the proxied queue if it implements craft\queue\ReleasableQueueInterface. (#16672)changedattributes and changedfields tables are now cleaned up during garbage collection. (#16531)resourcepaths table is now truncated when clearing control panel resources, via the Caches utility or the clear-caches/cp-resources command. (#16514)CRAFT_WEB_URL and CRAFT_WEB_ROOT environment variables could be overridden by @web and @webroot aliases define by the aliases config setting. (#16980)Fixed an error that could occur when changing a field’s type.
Condition rules for Checkboxes, Dropdown, Multi-select, and Radio Buttons fields now include “has a value” and “is empty” operators.
db/repair command. (#16812)--batch-size option for resave/* commands. (#16586)plugin/install command now accepts an edition argument, and prompts for the default edition if none is specified. (#17030)plugin/uninstall command now reports if no plugin is installed with the provided handle. (#17030)users/create command now prompts to send an activation email, or outputs an activation URL. (#16794)searchTermOptions GraphQL query argument. (#16979)revisionNotes GraphQL entry mutation argument. (#16943)aria-label attributes via an ariaLabel property.craft\base\ElementInterface::getSerializedFieldValuesForDb().craft\base\FieldInterface::serializeValueForDb().craft\base\conditions\BaseMultiSelectConditionRule::$includeEmptyOperators.craft\db\Connection::getIsMaria().craft\db\Table::SEARCHINDEXQUEUE_FIELDS.craft\db\Table::SEARCHINDEXQUEUE.craft\db\mysql\QueryBuilder::jsonContains().craft\db\mysql\QueryBuilder::jsonExtract().craft\db\pgsql\QueryBuilder::jsonContains().craft\db\pgsql\QueryBuilder::jsonExtract().craft\queue\ReleasableQueueInterface. (#16672)craft\records\User::haveIndexAttributesChanged().craft\services\Search::indexElementIfQueued().craft\services\Search::queueIndexElement().craft\cache\ElementQueryTagDependency now merges cache tags provided by the element query with any tags already set on its $tags property.craft\queue\Queue::release() and releaseAll() now call release() and releaseAll() on the proxied queue if it implements craft\queue\ReleasableQueueInterface. (#16672)changedattributes and changedfields tables are now cleaned up during garbage collection. (#16531)resourcepaths table is now truncated when clearing control panel resources, via the Caches utility or the clear-caches/cp-resources command. (#16514)CRAFT_WEB_URL and CRAFT_WEB_ROOT environment variables could be overridden by @web and @webroot aliases define by the aliases config setting. (#16980)Nothing published for this version
Fixed a bug where craft\services\Assets::EVENT_BEFORE_REPLACE_ASSET and EVENT_BEFORE_REPLACE_ASSET events weren’t getting triggered when replacing an
craft\services\Assets::EVENT_BEFORE_REPLACE_ASSET and EVENT_BEFORE_REPLACE_ASSET events weren’t getting triggered when replacing an asset file via GraphQL. (#17005)Fixed a privilege escalation vulnerability.
resourceBasePath setting was set to a nonexistent folder path. (#17021)includeSubfolders asset GraphQL query argument wasn’t working. (#17023)Fixed a bug where relations weren’t always propagating to newly-added sites for sections correctly.
Craft::createObject() with its relation field data included in the passed-in config. (#16942)folderPath asset query param only accepted strings. (#16981)craft\elements\Asset::getSrcset() could return malformed results if any sizes didn’t have corresponding image URLs. (#16984)Fixed a bug where relational fields with “Maintain hierarchy” enabled weren’t displaying the correct relations after an element was moved within its s
revisionNotes GraphQL fields were returning the entry’s current revision’s notes. (#16909)Added craft\base\conditions\BaseTextConditionRule::isEmpty().
craft\base\conditions\BaseTextConditionRule::isEmpty().craft\htmlpurifier\RelAttrLinkTypeDef.rel attributes to be set to any value. (#16798)_includes/forms/button.twig was always adding class="btngroup-btn-first" to the resulting button HTML.{slug} in the subpath could create folders named after temporary slugs. (#16799)Added craft\base\ElementTrait::$isNewSite.
craft\base\ElementTrait::$isNewSite.craft\queue\jobs\PropagateElements::$isNewSite.string().ancestors and parent eager-loading wasn’t working on some environments. (#16381, #16382, #16341)Fixed a bug where scrollable panes weren’t automatically scrolling when dragging objects near their edges.
Added craft\base\Element::ancestors().
craft\base\Element::ancestors().craft\base\Element::descendants().Fixed a bug where multiple “New file uploaded.” notifications could be shown at once.
preserveAspectRatio attributes. (#16709)Fixed a bug where multi-site elements’ search indexes could be updated twice.
utils/delete-empty-volume-folders command was deleting folders that had no assets directly, but had subfolders. (#16388)level. (#16661)up command, the app/migrate action, and the Project Config utility weren’t aware of pending project config changes if a database backup was restored but caches weren’t cleared. (#16668)Fixed an error that occurred when accessing the edit/ route for a draft that no longer existed.
edit/<elementId> route for a draft that no longer existed.fit transform mode. (#16622)Added craft\db\ExpressionBuilder.
craft\db\ExpressionBuilder.craft\db\ExpressionInterface.craft\db\QueryBatcher::getSlice() wasn’t using the database connection passed to the class constructor. (#16579)Fixed a bug where Entries fields’ entry select modals could show expand/collapse toggles for Structure sections, for elements that didn’t have any sel
transaction: true in the Codeception configuration wasn’t rolling back database DML changes after a test. (#16546)Fixed a bug where all multi-byte characters were getting stripped out of search indexes.
Deprecated the ucfirst Twig filter. capitalize should be used instead.
elements/delete-all-of-type command. (#16423)utils/delete-empty-volume-folders command. (#16388)primarySite global Twig variable. (#16370)duration Twig filter now has a language argument. (#16332)X-Craft-Site header set to a site ID or handle. (#16367)ucfirst Twig filter. capitalize should be used instead.craft\helpers\Image::EXIF_IFD0_ROTATE_0_MIRRORED.craft\helpers\Image::EXIF_IFD0_ROTATE_0.craft\helpers\Image::EXIF_IFD0_ROTATE_180_MIRRORED.craft\helpers\Image::EXIF_IFD0_ROTATE_270_MIRRORED.craft\helpers\Image::EXIF_IFD0_ROTATE_90_MIRRORED.craft\models\AssetIndexingSession::$forceStop. (#16435)GuzzleHttp\Client is now instantiated via Craft::createObject(). (#16366)craft\helpers\DateTimeHelper::humanDuration() now has a $language argument. (#16332)actions/app/health-check) now send no-cache headers by default. (#16364)craft\config\GeneralConfig::safeMode() set Safe Mode to false by default.relatedTo* GraphQL arguments to null. (#16433)craft\events\DefineAssetUrlEvent::$transform wasn’t always defined for assets’ EVENT_BEFORE_DEFINE_URL and EVENT_DEFINE_URL events. (#16464)Fixed a bug where the control panel could display a notice about the Craft CMS license belonging to a different domain, even when accessing the contro
relatedTo* GraphQL arguments to null. (#16431)Fixed a bug where custom fields could cause validation errors when running the users/create command.
users/create command.ancestors, children, descendants, and parent eager-loading wasn’t working on some environments. (#16381, #16382)Fixed a bug where asset edit page URLs contained spaces if the asset filename contained spaces.
getInputHtml() method returned an empty string.Fixed a bug where elements’ getPrev() and getNext() methods could cause duplicate queries.
getPrev() and getNext() methods could cause duplicate queries. (#16329)ancestors, children, descendants, and parent eager-loading wasn’t working for previewed elements. (#16327)Fixed a bug where blank user group descriptions weren’t getting omitted from project config data.
Fixed a bug where asset, category, and entry sources defined by the EVENT_REGISTER_SOURCES event didn’t have any custom fields available to them, unle
EVENT_REGISTER_SOURCES event didn’t have any custom fields available to them, unless the EVENT_REGISTER_FIELD_LAYOUTS event was also used to define the available field layouts for the event-defined source. (#16256)Reduced the likelihood of a deadlock error occurring when updating search indexes.
phpinfo() function is disabled. (#16229)isSelectable() methods weren’t being respected.EVENT_INIT or EVENT_DEFINE_BEHAVIORS entry event handlers were calling getSection() or getType() on the entry. (#16254)Element indexes now sort by ID by default, for sources that don’t define a default sort option.
craft\events\ApplyFieldSaveEvent::$field wasn’t being set consistently by craft\services\Fields::EVENT_BEFORE_APPLY_FIELD_SAVE. (#16156)project-config/rebuild. (#16189)One column per quarter.