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 Export Theme Settings Explained: What Each Option Does

WordPress Export Theme Settings Explained: What Each Option Does

Short answer

WordPress has no single button for exporting theme settings. Block themes export your design as a theme zip from the Site Editor, while classic themes need a Customizer export plugin or the theme's own tool. Tools, then Export only covers content.

Key takeaways

  • Tools > Export covers content, not theme settings.
  • Block themes export a zip from the Site Editor options menu.
  • Classic themes need a Customizer export plugin or built-in tool.
  • Settings only import into the same theme.
  • Widgets and menu locations usually need setting up again.

Can you export WordPress theme settings?

Yes, but WordPress has no single built-in button for it; classic theme settings export with a Customizer plugin or the theme's own tool, and block theme changes export from the Site Editor as a theme zip.

The method depends on what kind of theme you use and which settings you want to move. Colours and fonts live in a different place from menus, widgets and content.

This guide explains each export option, what it includes, and what it leaves behind. That way you know which one to use before you start.

Where does WordPress store theme settings?

Classic theme settings live in the database as theme mods, one record per theme, while block theme changes live as saved templates, template parts and global styles.

In a classic theme, choices you make in Appearance > Customize are saved in the options table under a name such as theme_mods_yourtheme. Each theme gets its own record.

That is why switching themes and switching back brings your old settings back. They were never deleted.

In a block theme, edits in Appearance > Editor are stored as special posts: templates, template parts and a global styles entry. The theme's original files stay untouched.

Our overview of WordPress theme settings explains what each type of setting does.

Does Tools > Export include theme settings?

No, the built-in Tools > Export only exports content such as posts, pages, comments, menus and custom post types, not Customizer settings, widgets or global styles.

The Tools Export screen documentation lists what the export file contains. It is a WXR file, which is a type of XML.

Navigation menus are included when you export All content, because menus are stored as posts. Their theme locations are not.

So a content export alone will not bring your design across. You need one of the methods below as well.

What are the ways to export theme settings?

The main options are the Site Editor export for block themes, a Customizer export plugin for classic themes, your theme's own import and export tool, a full site migration, or WP-CLI.

MethodTheme typeWhat it exportsBest for
Site Editor exportBlockTheme files plus your template and style editsMoving a block theme design
Create Block Theme pluginBlockA new or updated theme with your changes saved inBuilding a reusable theme
Customizer Export/Import pluginClassicCustomizer settings and optionsCopying a classic theme setup
Theme's own export toolUsually classicThat theme's settingsThemes like Astra, Kadence, Blocksy
Full migration pluginAnyEverything, including the databaseMoving the whole site
WP-CLIClassicThe theme mods record as textDevelopers and scripts

Each option is explained below.

How do you export settings from the Site Editor?

Open Appearance > Editor, open the options menu and choose Export, and WordPress downloads a zip of your theme that includes your saved template and style changes.

Step by step:

  1. Go to Appearance > Editor.
  2. Open the three-dot options menu at the top of the editor.
  3. Choose Export.
  4. Save the zip file.

You can upload that zip on another site through Appearance > Themes > Add New > Upload Theme. The Site Editor documentation covers the editor in more detail.

Your edits are written into the theme's files in the zip, such as theme.json and the template files. That makes the design portable.

Content inside your pages and posts is not included. Images used in templates may still point to the old site's media library, so check them after importing.

When should you use the Create Block Theme plugin?

Use it when you want to save your Site Editor changes into a clean theme, create a child theme, or package a design to reuse on several sites.

The official Create Block Theme plugin adds options to save changes to the theme, create a new theme or child theme, and export the result as a zip.

It also handles fonts better than a plain export. Fonts you added through the editor can be bundled into the theme.

The plugin is developed in the open, and its GitHub repository lists known issues and recent changes.

This is a good choice for agencies and freelancers who set up the same starting design for many clients.

How do you export classic theme Customizer settings?

Install a plugin such as Customizer Export/Import, then use its export button inside the Customizer to download a file you can import on another site with the same theme.

The free Customizer Export/Import plugin adds an Export/Import section to Appearance > Customize. The steps are:

  1. Install and activate the plugin on both sites.
  2. On the old site, open Appearance > Customize > Export/Import.
  3. Click Export to download the settings file.
  4. On the new site, activate the same theme first.
  5. Open the same section, choose the file and click Import.

The plugin can also download and import images referenced in your settings, such as a logo. Check the plugin page for current options.

Settings only apply to the same theme. Importing settings from one theme into a different theme does nothing useful, because each theme uses its own setting names.

Do themes have their own export tools?

Many popular themes include their own import and export feature, so check your theme's settings screen or documentation before installing an extra plugin.

Theme tools often export extras that a generic plugin misses, such as layouts, header builder settings or custom sections. Where they live differs by theme.

For example, our guide to Blocksy export settings shows how one theme handles it. Other themes put the option in a dashboard page or inside the Customizer.

Premium add-ons may store their settings separately, so read the theme's documentation for what is and is not included.

What about widgets and menu locations?

Widgets and menu locations are not part of most theme exports, so you either move them with a widget export plugin, a full migration, or set them up again by hand.

Menus themselves come across with a full content export. After importing, open Appearance > Menus and assign each menu to its location again.

Widgets in classic themes are stored separately from Customizer settings. If you have many, a dedicated widget importer and exporter plugin saves time. For a few, rebuilding them is quicker.

If widgets fail to appear after a move, our guide to fixing widgets that are not showing covers the common causes.

Can you export theme settings with WP-CLI?

Yes, developers can read a classic theme's settings record with the wp option command and save it as JSON, then load it on another site.

WP-CLI is the official command-line tool for WordPress. If it is new to you, the WP-CLI website explains how to install it, and many hosts include it already.

A typical command looks like this:

wp option get theme_mods_yourtheme --format=json > theme-mods.json

You can then use wp option update with the --format=json flag on the new site. The wp option command reference explains the flags.

Watch for full URLs inside the settings, such as logo addresses. Replace the old domain if the new site uses a different one. Our guide to migrating WordPress with WP-CLI covers search and replace.

Should you just migrate the whole site instead?

If you are moving the entire site to a new host or domain, a full migration is simpler, because it brings theme settings, widgets, content and plugins across in one go.

Theme exports are best when you want to copy a design to a different site that has its own content. For a full move, use a migration plugin or a manual migration.

Our guide on migrating WordPress with Duplicator shows one common route.

Whatever method you use, take a backup of the destination site before importing anything. An import can overwrite settings you wanted to keep.

Frequently asked questions

Does WordPress export include theme settings?

No. The built-in export under Tools only saves content such as posts, pages, comments and menus. Customizer settings, widgets and global styles are not included. Use a Site Editor export, a Customizer export plugin or your theme's own tool for those.

Can I import theme settings into a different theme?

Not in a useful way. Each theme names its settings differently, so settings from one theme do not map onto another. Import settings only into the same theme, ideally the same version, and rebuild your design by hand when changing themes.

Will exporting a block theme include my pages?

No. The Site Editor export includes the theme files with your template, template part and style changes. Pages, posts and media stay in the database. Move those separately with a content export or a full migration.

Are theme settings lost when I switch themes?

No. Classic theme settings are stored per theme, so they stay in the database when you switch. If you switch back, they return. Widgets and menu locations may need assigning again, though, because they depend on the active theme's areas.

Is it safe to import theme settings on a live site?

It is usually safe, but an import overwrites current settings for that theme. Take a full backup first, import during a quiet period, and check the site straight away. If something looks wrong, restore the backup.

Sources

  1. Tools Export Screen WordPress.org Documentation
  2. Site Editor WordPress.org Documentation
  3. Create Block Theme WordPress.org Plugins
  4. Customizer Export/Import WordPress.org Plugins
  5. wp option WP-CLI Commands

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.