Export and Import Settings

Copy your MailerPress configuration from one site to another without redoing it by hand. Export your settings to a JSON file (a text file that holds your settings), then import it on the other site and choose which settings to apply.

Location: MailerPress > Tools > Export / Import. You need permission to manage MailerPress settings.

When to use this

• Copying a staging (test copy) configuration to your live site.
• Setting up a new client site with your usual defaults.
• Backing up your configuration before a major change.
• Moving to a new server or domain.

Only settings are transferred. Contacts, lists, campaigns, templates and automations are not included.

Export your settings

1. In Export settings, tick the settings to include. Use Select all, or tick a whole category at once.
2. Click Export. A file named mailerpress-settings-YYYY-MM-DD.json is downloaded to your computer.

Category	Settings
General	General Settings (default sender, reply-to, subscription pages, saved with your sender addresses), Sending Frequency, Inactive Contacts, Signup Confirmation, Theme
Email Delivery	Email Service Providers, Bounce Management, Spam Protection, WordPress Email Templates, WooCommerce Email Templates
Webhooks	Outgoing Webhooks, Incoming Webhooks, Webhook Secret, Webhook Async Setting
Design & AI	Custom Fonts, Global Typography, AI Configuration

Bounce management handles emails returned as undeliverable. Webhooks are automatic notifications sent between MailerPress and other apps. Outgoing Webhooks, Webhook Secret and Webhook Async Setting are only exported when MailerPress Pro is active. Settings you have never configured are skipped.

Sensitive data

Settings marked Sensitive (Email Service Providers, Bounce Management, Webhook Secret and AI Configuration) contain API keys, passwords or tokens in clear text. Anyone with the file can use them.

• Never send the file by email or store it in a public folder.
• Don’t commit it to a Git repository.
• To keep it, use a password manager or an encrypted vault.
• Delete it from your Downloads folder after the import.

To share your configuration with someone else, untick the sensitive settings before exporting.

Import settings

Before you start, check that:

• the target site runs the same MailerPress version, or a newer one;
• your email service provider keys work in the target environment (production keys may not work on a sandbox account, and the reverse);
• MailerPress Pro is active on the target site if you import settings that require it, such as outgoing webhooks.

1. On the target site, go to MailerPress > Tools > Export / Import.
2. In Import settings, drag and drop your export file, or click the area to browse. Only JSON files exported by MailerPress are accepted.
3. Check the Export file information: source site, plugin version, export date and number of settings. A warning appears if the file comes from a different MailerPress version.
4. Under Select settings to import:, every setting found in the file is ticked. Untick those you want to keep unchanged on this site.
5. Click Import selected settings.

Each imported setting overwrites the current one on this site, and this cannot be undone. If you may need to go back, export the target site’s settings first. Unticked settings, and settings missing from the file, are left untouched.

After importing

1. Open the affected settings screens and confirm everything came through.
2. Check that the subscription pages selected in the general settings exist on the new site.
3. Send a test email to make sure your sender, email service provider and bounce handling work.