Troubleshooting
WordPress Astra Theme Not Working: Causes and How to Fix It

Short answer
The Astra theme usually stops working because of a plugin conflict, mismatched Astra and Astra Pro versions, stale cached CSS, or a low PHP memory limit. Test with other plugins disabled, update Astra and its add-ons together, regenerate Astra's CSS files, clear every cache layer, and resave permalinks if layouts show 404 errors.
Key takeaways
- Plugin conflicts cause most Astra problems, so test with plugins disabled first.
- Keep Astra and Astra Pro on matching current versions.
- Stale CSS files and page caches stop design changes from appearing.
- Resave permalinks to fix Site Builder and custom layout 404 errors.
- Set page builder pages to a full width content layout in Astra's page settings.
Why is the Astra theme not working?
Astra usually stops working because of a plugin conflict, mismatched Astra and Astra Pro versions, cached or stale CSS files, a low PHP memory limit, or settings that a page builder or starter template has overridden.
Astra itself is a lightweight, well-maintained theme, so problems rarely come from the theme alone. They come from how it interacts with plugins, caching and hosting.
Start by pinning down the symptom. A Customizer that will not load needs a different fix than a header that disappears or a layout that looks broken after an update.
| Symptom | Likely cause | First fix |
|---|---|---|
| Customizer stuck loading or blank | Plugin conflict or memory limit | Disable plugins, raise memory |
| Customizer options missing | Astra Pro module off or version mismatch | Update both, enable module |
| Design changes not showing | Cached CSS or page cache | Regenerate CSS, clear caches |
| Layout broken after update | Old CSS files or outdated add-ons | Clear caches, update add-ons |
| Site Builder or custom layout gives 404 | Permalinks need refreshing | Resave permalinks |
| Page builder page not full width | Astra page settings | Change content layout |
How do you check for a plugin conflict?
Deactivate all plugins except Astra-related ones, test the problem, then reactivate plugins one at a time until it returns; the last plugin you turned on is the conflict.
Conflicts are the most common cause of Astra problems, especially with caching, optimization and security plugins. Astra's own troubleshooting steps start here too.
On a live site, use the free Health Check & Troubleshooting plugin. Its troubleshooting mode disables plugins only for your login, so visitors see the normal site while you test.
Our full guide on fixing a plugin conflict shows the process step by step.
Once you find the conflicting plugin, check for updates first. If none fixes it, contact the plugin's support with details of the clash, or look for an alternative.
Why won't the Astra Customizer load?
The Customizer usually hangs or shows a blank panel because of a plugin conflict, a JavaScript error, a low memory limit or a security rule blocking the preview.
Try these checks in order:
- Open the Customizer in a private browser window to rule out extensions
- Press F12 and look for red errors in the Console tab
- Deactivate plugins to test for conflicts
- Raise the PHP memory limit
- Ask your host if a firewall rule blocks admin-ajax or the preview
If you see a message saying the preview could not be loaded, Astra has a help page on the preview could not be loaded pop-up with specific fixes.
Low memory is a frequent cause on cheap shared hosting. Our guide on increasing the PHP memory limit shows how to raise it. The PHP memory_limit setting controls how much memory each request can use.
Why are Astra Customizer options missing?
Options disappear when an Astra Pro module is turned off, when Astra and Astra Pro versions do not match, or when a page builder or plugin replaces that part of the site.
Astra Pro features come from modules. If a module such as Colors and Background or Typography is disabled, its settings vanish from the Customizer. Turn modules on in the Astra Pro settings screen.
Keep Astra and the Astra Pro plugin on current versions. An old Pro plugin with a new theme, or the reverse, can hide options or cause errors. Astra documents this in its article on Customizer options being unavailable.
Also check whether the element is controlled elsewhere. If Elementor's Theme Builder or a header plugin replaces the header, Astra's header settings will not change anything.
Why are your Astra changes not showing on the site?
Changes usually do not appear because a page cache, a CDN or Astra's generated CSS file is serving an older version of your styles.
Astra can write its dynamic CSS to a file for better performance. When that file is stale, your new colors and fonts do not show. Look for the option to regenerate or flush the CSS files in Astra's settings, or temporarily turn file generation off to test.
Then clear every layer of cache:
- Your caching plugin
- Your host's server cache
- Cloudflare or another CDN
- Your browser, with a hard refresh
Our guide on clearing the cache in WordPress covers each layer.
If custom CSS still does not apply, see fixing CSS changes not showing.
What if Astra broke after an update?
If the site broke right after updating Astra or Astra Pro, clear all caches, update related add-ons and starter templates, then roll back the theme only if the problem stays.
Most post-update problems come from cached CSS or JavaScript built for the old version. Clearing caches fixes them in many cases.
Next, update everything that extends Astra, such as Astra Pro, Spectra, Starter Templates and any Astra add-on plugins. Old add-ons often assume features that changed.
If the site is still broken, restore a backup or roll the theme back to the previous version while you contact Astra support. Our guide on reverting a WordPress theme update explains safe ways to do it.
For a white screen or a critical error message, read our guide on a theme breaking the site after an update.
Why do Astra Site Builder layouts show a 404?
A 404 when editing or viewing Site Builder or custom layouts usually means WordPress needs its permalink rules refreshed.
Go to Settings > Permalinks and click Save Changes without changing anything. This rebuilds the rewrite rules that tell WordPress how to find those layouts.
Astra has a help page on the Site Builder 404 error if resaving does not help. Our guide on flushing permalinks covers the same fix in more detail.
Why does an Elementor or Beaver Builder page look wrong with Astra?
Page builder layouts look boxed, padded or show an extra title when Astra's page settings are left on their defaults, which are designed for normal posts.
Edit the page and open the Astra settings panel in the editor sidebar. Set the content layout to full width or stretched, and disable the page title if your design includes its own heading.
You can also disable the theme's header or footer on a single page from the same panel. That helps when a landing page needs a clean, distraction-free layout.
Why won't Astra starter templates import?
Starter template imports fail mainly because of low PHP limits, server timeouts, or a security plugin blocking requests to the template library.
Raise the memory limit and maximum execution time, and temporarily disable security or firewall plugins during the import. Shared hosts with strict limits often time out on large templates.
Import on a fresh install where possible. Importing over an existing site mixes old content, settings and widgets with the template, which can look broken.
What should you send Astra support?
If none of these fixes work, send Astra support your theme and plugin versions, the exact symptom, any console or debug log errors, and the steps that trigger the problem.
Turn on WordPress debug logging to capture PHP errors. The WordPress guide to debugging in WordPress explains the settings.
Free Astra users can post on the WordPress.org support forum for the theme. Astra Pro customers get direct support through the vendor's site. If you are weighing the paid version, our article on whether Astra is free explains what Pro adds.
Frequently asked questions
Why is the Astra Customizer stuck on loading?
The most common causes are a plugin conflict, a JavaScript error or a low PHP memory limit. Open the Customizer in a private window, check the browser console for errors, disable plugins one at a time and raise the memory limit.
Why are my Astra settings not saving?
Settings may save but not show because of cached CSS or a page cache. Regenerate Astra's CSS files and clear all caches. If settings truly do not save, a security plugin or server rule may be blocking the save request.
Do I need to update Astra Pro when I update Astra?
Yes. Astra Pro is a separate plugin that extends the theme, and the two should stay on current versions. A large version gap can hide Customizer options, break layouts or trigger errors.
Why is my Astra header missing?
The header may be disabled for that page in Astra's page settings, hidden by a custom layout, or replaced by a page builder header template. Check the page settings first, then any Site Builder or Theme Builder header templates.
Is Astra compatible with Elementor?
Yes. Astra is widely used with Elementor and other page builders. For best results, set each builder page to a full width or stretched content layout and turn off the default page title when your design has its own heading.
Sources
- Troubleshooting Steps Astra Docs
- Astra Customizer Options Unavailable Astra Docs
- The Preview Could Not Be Loaded Pop-up Astra Docs
- Health Check & Troubleshooting WordPress.org
- Debugging in WordPress WordPress Developer Resources
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


