Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Info

WordPress Reset Theme Settings Explained: What Each Option Does

WordPress Reset Theme Settings Explained: What Each Option Does

Short answer

Resetting theme settings returns a theme's design choices to their defaults without touching your content. Block themes use Reset styles and template reset options in the Site Editor, while classic themes need the theme's own reset tool, a Customizer reset plugin or WP-CLI to clear stored theme mods.

Key takeaways

  • Classic themes store Customizer choices as theme mods in the database.
  • Block themes save styles and edited templates as posts.
  • Reinstalling a theme does not clear its settings.
  • WP-CLI can remove all or single theme mods quickly.
  • Full site reset plugins wipe content and belong on test sites only.

What does resetting WordPress theme settings mean?

Resetting theme settings means returning a theme's design choices, such as colors, fonts, layouts and custom templates, to the defaults the theme shipped with, without deleting your posts, pages or media.

Where those settings live depends on the theme type. Classic themes store choices from the Customizer as theme mods in the database. Block themes store style changes and edited templates as special posts.

So there is no single reset button for every site. You pick the option that matches your theme and how much you want to undo.

This guide explains each option, what it removes and what it leaves alone. Take a full backup before you try any of them.

Reset optionTheme typeWhat it resetsWhat it keeps
Theme's own reset toolClassic or hybridThat theme's options panelContent, menus, widgets
Customizer reset pluginClassicAll Customizer settings for the themeContent, menus
Reset styles in Site EditorBlockGlobal colors, typography, layoutTemplates, content
Clear template customizationsBlockEdited templates and partsGlobal styles, content
WP-CLI theme mod removeClassicAll or chosen theme modsEverything else
Full site reset pluginAnyDatabase back to fresh installUsually nothing except users chosen

Where does WordPress store theme settings?

Classic theme settings are saved in the wp_options table under an entry named theme_mods followed by the theme's folder name, while block theme changes are saved as posts.

Every classic theme gets its own theme_mods entry. That is why switching themes does not erase your old settings. If you switch back later, your logo, colors and header choices return.

Block themes work differently. Changes made in Styles are saved as a wp_global_styles post, and edited templates are saved as wp_template and wp_template_part posts.

You can see these rows in a database tool such as phpMyAdmin, but avoid editing serialized values by hand.

Some premium themes also keep their own options in separate database rows. Their reset tools only clear those rows.

Our guide to WordPress theme settings explains where each kind of setting appears in the dashboard.

How do you reset styles in a block theme?

In a block theme, open Appearance, then Editor, go to Styles, open the options menu and choose Reset styles to return colors, typography and layout to the theme defaults.

The exact label may vary slightly between WordPress versions. You can also reset single parts, such as a color palette or a block type's typography, from inside those panels.

This only touches global styles. Your edited templates, patterns and page content stay as they are.

The Styles documentation shows where each style panel lives. Before you reset, you can use the style revisions feature to look at earlier versions and restore one instead.

If your theme uses a custom theme.json, the reset returns to the values in that file. Our guide on how to use theme.json explains how those defaults are set.

How do you reset templates and template parts?

Open the template or template part in the Site Editor, open its actions menu and choose the option to reset or clear customizations, which restores the theme's original file.

When you edit a header, footer or page template in a block theme, WordPress saves a copy in the database. The theme's original file stays untouched in the theme folder.

Resetting deletes the saved copy, so WordPress falls back to the theme file. In the templates list, edited items are often marked so you can see which ones were changed.

Templates you created yourself, rather than ones the theme provided, cannot be reset. You delete them instead.

For more on editing these parts, read our guide on editing the header in a block theme.

How do you reset Customizer settings in a classic theme?

Classic themes have no built-in reset button in core WordPress, so you use the theme's own reset tool, a Customizer reset plugin, or WP-CLI to clear the theme mods.

Check the theme first. Many popular themes include a reset, import and export panel in their own options page or Customizer. That is the safest route because it knows which settings belong to the theme.

If your theme has no reset, a plugin that resets Customizer settings can clear the theme mods for the active theme. Search the plugin directory, check recent updates and test on staging.

The Customizer documentation lists the panels that these settings come from, such as Site Identity, Colors, Header Image and Menus.

Remember that menu locations and widget assignments are often saved as theme mods too. After a reset, you may need to reassign your menus.

Can you reset theme settings with WP-CLI?

Yes, WP-CLI can list and remove theme mods for the active theme, which gives developers a fast and precise reset.

The command wp theme mod list shows every stored setting. The command wp theme mod remove with the --all flag clears them all, as described in the WP-CLI theme mod reference.

You can also remove single settings by name. That is useful when one broken value, such as a bad header image, is causing trouble.

In custom code, the remove_theme_mods() function does the same job for the active theme. Use it once, not on every page load.

If you are new to the tool, the WP-CLI website covers installation and basic use.

Does reinstalling a theme reset its settings?

No, deleting and reinstalling a theme usually keeps its settings, because they live in the database rather than in the theme files.

Reinstalling replaces the theme's files, which can fix corrupted or edited code. But your Customizer choices and block theme edits stay in the database and return when you activate the theme again.

To get a truly clean slate, reinstall the theme and also clear its settings with one of the methods above.

If you made changes to the theme files themselves, reinstalling removes them. That is a good reason to keep custom code in a child theme.

What about full site reset plugins?

Full site reset plugins wipe the WordPress database back to a fresh install, which removes far more than theme settings and should only be used on test sites.

These tools delete posts, pages, settings and often plugins. They are popular for developers who test themes repeatedly on a local site.

Never run a full reset on a live site to fix a design issue. It is like reformatting a computer to change the wallpaper.

If you want a fresh start with a new design instead, our guide on how to change a WordPress theme is the better path.

What should you do before resetting?

Back up the database, note any settings you want to keep, and test the reset on a staging copy before running it on the live site.

Take screenshots of your Customizer or Styles panels. Copy your custom CSS, logo files, colors and font choices into a document.

Many themes let you export settings to a file. Do that first so you can import them again if the reset goes too far.

If a recent theme update broke your design rather than your own changes, a reset may not help. In that case, read our guide on reverting a WordPress theme update instead.

Frequently asked questions

Does resetting theme settings delete my posts and pages?

No. Theme resets only touch design settings such as colors, fonts, layout options and edited templates. Posts, pages, media and users stay in place. Full site reset plugins are different and can delete content, so avoid them on live sites.

Will switching themes reset my settings?

No. Each classic theme keeps its own saved settings in the database, so switching away and back restores them. Block theme style changes are also tied to that theme and return when you reactivate it.

How do I reset a block theme template to its original version?

Open the template in the Site Editor, open its actions menu and choose the option to reset or clear customizations. WordPress deletes your saved copy and uses the theme's original file again.

Can I undo a theme settings reset?

Only if you have a backup or an exported settings file. Block themes also keep style revisions that may help. Always back up the database and export settings before resetting, since the reset itself has no undo button.

Why are my menus missing after a reset?

Menu location assignments are stored as theme settings in many themes. A reset clears them, even though the menus still exist. Go to the Menus screen or Customizer and assign each menu to its location again.

Sources

  1. Styles overview WordPress.org Documentation
  2. Customizer screen WordPress.org Documentation
  3. wp theme mod remove WP-CLI Commands
  4. remove_theme_mods() WordPress Developer Resources
  5. WP-CLI WP-CLI

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.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.