Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
WPB Cup
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

How to Import / Export WordPress Theme Customizer Settings

Editorial Note: We earn a commission from partner links on WPBeginner. Commissions do not affect our editors' opinions or evaluations. Learn more about Editorial Process.

Do you want to import or export theme customizer settings in WordPress?

If you have multiple WordPress sites, then exporting and importing theme customizer settings will allow you to use the same configuration for the theme on both sites.

In this article, we will show you how to easily import / export WordPress theme customizer settings.

Import / export theme customizer settings in WordPress

Why Import / Export WordPress Theme Customizer Settings?

Many WordPress themes allow you to set up your WordPress website using the theme customizer. It allows you to change colors, header images, background images, choose layout settings, and more.

Some paid and free themes have more settings available in the customizer, while others have just a few basic options.

If you were working on customizing the theme on a local server or staging site, then wouldn’t it be nice if you could just move those settings to the live site?

This will allow you to move theme customizer settings from one WordPress website to another without having to move the content and database.

You may also want to export the customizer settings if you have created a custom child theme that you want to share with others or if your theme has an error and you have to delete it.

Then, once you’ve fixed that issue, you can easily import your theme customizer settings back again.

That being said, let’s take a look at how to easily import / export theme customizer settings in WordPress.

How to Import / Export Theme Customizer Settings in WordPress

First, you need to install and activate the Customize Export/Import plugin on both sites where you want to export/import. For more details, see our step-by-step guide on how to install a WordPress plugin.

Upon activation, visit the Appearance » Customize page from the WordPress dashboard of the website you want to export from.

Export/Import option in Customizer

From here, you have to click on the ‘Export/Import’ panel in the left column to open further settings.

Next, click the ‘Export’ button to download your customizer settings and send them to your browser in a .dat file.

Export customizer settings

The plugin will export all your theme options that are defined as theme mods or stored as options in the WordPress database. This means you can export things like color settings, layout directions, header media, etc.

However, it will not export your navigation menus, site title and description, widgets, and more.

Now, to import customizer settings, head over to the WordPress site where you want to import these settings.

From here, visit the Appearance » Customize page from the WordPress admin sidebar and click on the Export/Import panel.

After that, click on the ‘Choose file’ button under the ‘Import’ section to select the file you exported earlier.

You also need to check the box next to the ‘Download and import image files?’ option to import the header and other image files.

Import theme settings
Next, click on the ‘Import’ button to start uploading the customizer settings from your export file.

Once it is finished, you can review your changes in the customizer and then click on the ‘Save & Publish’ button to make those changes live.

Keep in mind that the plugin only exports theme settings saved using theme customizer and does not export site data like menus, widgets, images, and more. You will have to manually set up those changes.

We hope this article helped you learn how to import/export theme customizer settings in WordPress. You may also want to see our beginner’s guide on how to use the WordPress theme customizer like a pro and our checklist of things you must do before changing WordPress themes.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.

Disclosure: Our content is reader-supported. This means if you click on some of our links, then we may earn a commission. See how WPBeginner is funded, why it matters, and how you can support us. Here's our editorial process.

Editorial Staff

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

The Ultimate WordPress Toolkit

Get FREE access to our toolkit - a collection of WordPress related products and resources that every professional should have!

Reader Interactions

20 CommentsLeave a Reply

  1. Syed Balkhi says

    Hey WPBeginner readers,
    Did you know you can win exciting prizes by commenting on WPBeginner?
    Every month, our top blog commenters will win HUGE rewards, including premium WordPress plugin licenses and cash prizes.
    You can get more details about the contest from here.
    Start sharing your thoughts below to stand a chance to win!

  2. Ram E. says

    Thanks! Although I don’t think this would work for block themes–from default WP 2023 to the recently released 2024 theme with WordPress 6.4. I am trying to install a staging environment for my website today to configure the new WP default theme before pushing the changes to live but the staging feature of the Bluehost plugin s*cks. This is how I ended up in this article. (Sigh) Looking for some staging alternatives as I only need to update the theme.

  3. Teresa E Langston says

    This plugin does not work with child of 2022 theme.

    Export works fine. Error on import:
    Error importing settings! The settings you uploaded are not for the current theme.

    There does not seem to be a way to get past this situation. Have scanned faqs/support forums

    • WPBeginner Support says

      You would want to ensure the folder names are the same for your child theme to prevent that specific error. You can also reach out to the plugin’s support and they may be able to assist further.

      Admin

    • WPBeginner Support says

      You would want to check with the support for the plugin whose settings you are looking to transfer for if they have a tool for that purpose.

      Admin

    • WPBeginner Support says

      If you reach out to the plugin’s support and let them know your specific theme and they should be able to help

      Admin

  4. Salman Saleem says

    Thank you so much for saving my day. Was thinking to migrate the whole site but this plugin is a saviour.

  5. Fejiro says

    Please a search bar is showing in my customize theme page. Its blocking the save button. How do I remove it.

  6. Ted says

    I used this plugin to export customizer settings from one site and import them to another site using the same theme. Worked without a hitch and even imported background and header images. One thing I noticed is the current version (0.8) automatically saves the changes, which may be an issue if somebody just wants to see how it looks without committing to the changes. The unwary user will inadvertently overwrite any settings they may currently have saved.

  7. NazakatMunawar says

    WordPress themes are easily imported and export as all the content and images will get transformed into any themes accordingly but still, I suggest to make a back up before making any changes to the themes.

Leave A Reply

Thanks for choosing to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and your email address will NOT be published. Please Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.