Changelog
Keep track of what's new with ACSS! For details on specific features and utilities, please check the official documentation.
4.0.2
Automatic.css 4.0.2 brings many new recipes to Bricks, makes license handling and settings import/export much easier, and fixes a long list of bugs reported by the community. We recommend updating promptly: this release also includes security hardening for log files, update checks and Global CSS.
Before you update: recipes now use
?everywhere. Replace@recipe-namewith?recipe-name. The broken?breakpoint-*recipes were removed. Here is what to use instead.Recipes
- Bricks now has many new recipes, including
?flex-grid,?center-*, gradient helpers,?tooltip,?footer-reveal,?skip-link,?font-face,?corner-ribbonand pseudo-selector shortcuts like?::beforeand?:hover. Learn more - Recipes now work without turning on Variable Expansion & Validation. That setting now only controls the automatic
var(),calc()and bracket corrections. - Several recipes have new defaults:
?columnsuses 350px columns with no rule,?variable-griduses a 350px minimum,?concentric-radiusadds--inner-radius, the divider recipes skip edge spacing and the fade recipes support--fade-softness. Learn more - Color recipes like
?primary-clrexpand to working OKLCH relative colors again. - Recipes now use
?in every builder and in the dashboard. The old@trigger is gone. - The broken
?breakpoint-xsto?breakpoint-up-xxlrecipes were removed. Use your builder’s breakpoints or a normal media query instead (community thread).
- Bricks now has many new recipes, including
Licensing
- You can set your license key with an
ACSS_LICENSE_KEYconstant inwp-config.php. It activates automatically, and the license screen shows which domain the license is active on. Learn more - New Check for updates now button on the license screen. Learn more
- After updating from Automatic.css 3, the license screen no longer stays locked when the old license has nothing left to release. While it is still being released, the screen tells you why and when the next attempt runs.
- Failed license activations and deactivations now show up in the Activity Log.
wp acss license getshows where the key comes from and which site it is activated on. Learn more
- You can set your license key with an
Dashboard
- Import and export your settings from the dashboard header menu, including unsaved changes. Learn more
- Importing an Automatic.css 3 settings file now converts it for v4 automatically. Learn more
- Reset to defaults moved into the header menu, with clearer confirmations and a press-and-hold reset. Learn more
- Download and clear the Activity Log right from the settings page. Learn more
- Number fields accept values like
480px,2remand1.2em, and upgrades no longer get stuck on “There are some settings that needs to be fixed” (community thread). - When saving fails, the dashboard now shows the real reason and keeps the back button visible.
- The live preview waits for the right editor canvas, so it no longer fails to start in the block editor (community thread).
- In Bricks, paste, undo, copy and other editing shortcuts work in dashboard text fields again (community thread).
- Dashboard shortcuts no longer block browser shortcuts like Inspect Element while the dashboard is closed (community thread).
Bricks
- ACSS shades are grouped under each main color in a single “ACSS Colors” palette. Learn more
- The variable context menu only offers variables ACSS 4 actually generates, including the new width tokens (community thread).
- The “Import Original Classes for Templates” setting works again.
- The Grid Visualizer stays hidden when you turn it off.
Form Styling
- WS Form styling now applies with Layer utilities and the WS Form Styler, and the focus outline is back (community thread).
- Error color, secondary color and tooltip radius keep working when the related ACSS options are off.
- The settings for section legend weight, inside label scale and navigation borders now affect your forms.
Settings That Had No Effect
- Outline buttons use their own focus color settings.
- “Use Global Transition Style” for links now works as expected.
- The 2XL icon size and padding settings now generate correctly.
Effects
- Enter and exit effects can be combined on the same element, and
on-enter--parallaxmoves even when other entrance effects are enabled (community thread).
- Enter and exit effects can be combined on the same element, and
Security
- Activity and debug logs use unguessable file names.
- Update checks only run for administrators, cron and WP-CLI.
- On multisite and other installs without
unfiltered_html, site administrators can edit Global CSS again, with imports limited to Automatic.css files. Learn more
Other Fixes
- Pages no longer lose their ACSS styles when a request sends JSON headers. This prevented unstyled pages from ending up in your page cache (community thread).
- Regenerating CSS rebuilds your Custom CSS when its source file is missing, so custom styles no longer disappear.
- On multisite, ACSS tells you to network-deactivate Automatic.css 3 first, and the upgrade keeps third-party settings like Frames toggles.
- Cheat sheet documentation links point to docs.automaticcss.com, and the color preview no longer shows a swatch for keywords like
currentcolororinherit.
3.3.8
Automatic.css 3.3.8 reduces unnecessary upgrade-lock activity, improves PHP 8.4 compatibility, and fixes WS Form group label styling when using .form–dark and .form–light.
WS Form label
WS Form radio and checkbox group titles now inherit .form–dark and .form–light styling when WS Form renders them as div.wsf-label.
PHP 8.4 no longer fills error logs
PHP 8.4 no longer fills error logs with ACSS deprecation notices from implicitly nullable parameters.
Dashboard documentation links
Remaining dashboard documentation links now point to
docs.automaticcss.cominstead of retired documentation URLs.
4.0.1
This release fixes the license activation issues some of you ran into after the 4.0.0 launch, repairs form styling for WS Form, and cleans up a handful of smaller bugs. Updating is safe — everything migrates automatically, and your custom settings are untouched.
Licensing
- License activation and deactivation now always give you clear feedback — before, some messages were silently swallowed and it looked like nothing happened.
- If your previous Automatic.css 3 license is still being released in the background, the license tab now tells you so in plain language instead of blocking activation invisibly.
- Entering an Automatic.css 3 key now tells you exactly that: “This license key belongs to Automatic.css 3. Automatic.css 4 requires its own license key — please copy it from your account.”
- Deleting or replacing a license key now works reliably, even in edge cases where the licensing server couldn’t confirm the old activation.
- Sites whose outbound connections are blocked by a firewall can no longer get permanently stuck during the license handover.
Dashboard
- Hover arrows from color rows no longer float over the header when you scroll.
The color preview swatch now works for every CSS color, including color-mix(), oklch() and light-dark() values.
- Hover arrows from color rows no longer float over the header when you scroll.
Form Styling
- Fixed a bug where forms silently fell back to WS Form’s default black-and-white styling instead of your ACSS colors, and the floating label lost its background on focus. Form fields, labels, tabs and legends now follow your ACSS tokens again, and changing a base color in the dashboard flows through to all dependent fields — including live preview.
- The Form Styling fields now show the ACSS tokens you already know (–text-dark, –white, –text-m and friends) instead of internal variable names. Values you set yourself are kept exactly as they were.
- Field focus colors now follow your site-wide Focus Color setting (Additional Styling), so a focused field can’t be mistaken for an invalid one on palettes with a red primary.
- New setting: Floating Label Background (Form Styling → Label). Give the floated label its own background color — handy when your field background is translucent or differs from the surface behind the form.
Other Fixes
- Smooth scrolling now works in Firefox.
- The WordPress Widgets screen no longer throws console errors caused by ACSS.
- 404 pages for URLs under /wp-admin/ are styled correctly again.
- debug.log is no longer written when logging is disabled.
4.0.0
Important
This release includes important security hardening. If you’re running an Automatic.css 4.x prerelease, we recommend upgrading to 4.0.0 as soon as possible. Existing v3 sites should remain on v3 because v4 is not backward compatible.
Automatic.css 4.0.0 is here — the culmination of the alpha, beta, and release candidate cycles that shaped ACSS 4. This milestone brings all of that work together and completes the transition to the permanent v4 plugin and licensing setup. Follow the upgrade guide before installing.
Alongside the work completed throughout the prerelease cycle, this release restores ACSS color workflows in Bricks 2.2+, adds the option to disable effects while editing in Bricks and Etch, improves WordPress 7 compatibility, and includes useful refinements throughout the dashboard and generated CSS.
The changes below are the additions and fixes included specifically in 4.0.0:
Automatic.css 4.0.0 installs as a new plugin
Automatic.css 4.0.0 installs as a new plugin. Follow our upgrade guide to move from a 4.x prerelease. This is a one-time manual upgrade — future Automatic.css 4 updates will be delivered through your WordPress dashboard.
The new Disable Effects In Page Builders option keeps effects out of the way while editing in Bricks and Etch
Manage your Automatic.css license with WP-CLI
Manage your Automatic.css license with WP-CLI. View the available commands.
Transparent color swatches now insert modern color-mix(in oklch, var(--primary) 10%, transparent) values
Transparent color swatches now insert modern
color-mix(in oklch, var(--primary) 10%, transparent)values instead of generated-trans-*variables — all while retaining the utility class names you already use.Content grid exclusion styles now use lower specificity, giving you more control and making them easier to override.
Dashboard help links open the ACSS cheat sheet
Dashboard help links open the ACSS cheat sheet when available, while documentation, community, and support links now take you to their latest destinations.
The license key field now asks browsers and password managers to disable autocomplete and save prompts
License requests now identify themselves to our servers
License requests now identify themselves to our servers — groundwork for resolving activation issues on hosts that are currently challenged by our firewall.
License activation and checks are less likely to be disrupted by third-party plugins.
ACSS color workflows are back in Bricks 2.2 and later! Right-clicking Background and Typography color swatches once again inserts ACSS variables directly into the color field.
Hide Deactivated Classes works correctly on WordPress 7 without triggering the wp_enqueue_script() notice in Bricks
Update checks no longer throw a Class not found fatal when malformed transient data requires a new stdClass instance
Logged entries now render safely in the dashboard, log growth stays bounded, and rotated Activity Log and debug log files remain protected
Dashboard license checks are now restricted to authorized administrators
3.3.7
Automatic.css 3.3.7 improves content offset on Bricks sites that use background video. License activation and checks are also less likely to be disrupted by third-party plugins, and now include information that helps us prevent Cloudflare from blocking legitimate requests.
Documentation, community, and support links now take you to their latest destinations.
The license key field now asks browsers and password managers to disable autocomplete and save prompts.
In Bricks, ACSS no longer applies content offset spacing to background-video wrappers.
License activation and checks are less likely to be disrupted by third-party plugins
License activation and checks are less likely to be disrupted by third-party plugins, and now include information that helps us prevent Cloudflare from blocking legitimate requests. (ACSS-614) – Unfortunately, that doesn’t yet fix the current issues we’re having with Cloudflare (CF-Ray-XXXXXXX…).
Dashboard license checks are now restricted to authorized administrators.