Skip to content

Update Bulk Settings Manager docs to current UI labels #31

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bkatusic merged 1 commit into from
Apr 17, 2026
Merged

Update Bulk Settings Manager docs to current UI labels #31

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
130 changes: 63 additions & 67 deletions add-ons/administrative/bulk-settings-manager-extension.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,11 @@ addonType: extension
id="addon-data"
style={{display: 'none'}}
data-title="Bulk Settings Manager"
data-purchase-url="https://mainwp.com/extension/bulk-settings-manager/"
data-purchase-url="https://mainwp.com/add-on/bulk-settings-manager/"
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.0"
data-version="5.0.4"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-bulk-settings-manager-extension/"
data-owned-by="Jestart LLC"
Expand All @@ -38,7 +38,7 @@ addonType: extension
**Extension Add-on** - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.
</Info>

With the [MainWP Bulk Settings Manager](https://mainwp.com/extension/bulk-settings-manager/) Extension, you can adjust your Child site settings for the WordPress Core and almost any WordPress Plugin or Theme.
With the [MainWP Bulk Settings Manager](https://mainwp.com/add-on/bulk-settings-manager/) Extension, you can adjust your Child site settings for the WordPress Core and almost any WordPress Plugin or Theme.

## How it Works

Expand Down Expand Up @@ -97,15 +97,15 @@ Press the **MainWP Key Maker** button listed at the top of your screen![Initiate
<Step title="Select the post-submission Request field and copy the generated code by clicking the Copy to Clipboard button">
Select the **post-submission Request** field and copy the generated code by clicking the **Copy to Clipboard** button
</Step>
<Step title="Login in to your MainWP Dashboard">
<Step title="Log in to your MainWP Dashboard">
</Step>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager">
</Step>
<Step title="Click the Import Keys tab">
<Step title="Open the Import Keys tab">
![Import key code](/images/add-ons/bulk-settings-import-key-code.png)
1. Paste that copied code in the Key Code field
2. Give your Key a name
3. Click the **Make the Key** button
1. In the **Import from MainWP Key Maker** section, give your key a name
2. Paste the copied code in the **Key code** field
3. Click the **Import Key** button
</Step>
<Step title="After the Key has been created, you will be redirected to the Key Edit screen.">
After the Key has been created, you will be redirected to the **Key Edit** screen.
Expand All @@ -119,7 +119,7 @@ Verify the form fields look correct for you and, if needed, update field values
Go to the **Single Keys** tab
1. Select the Key
2. Select your Child Sites
3. Click the **Save Key to Selected Child sites** button
3. Click the **Save Key** button
</Step>
</Steps>

Expand All @@ -131,7 +131,7 @@ Key Ring feature allows you to group your Keys and submit them all at once. It c
<Steps>
<Step title="Login to your MainWP Dashboard">
</Step>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager">
</Step>
<Step title="Go to the Single Keys tab">
</Step>
Expand All @@ -156,7 +156,7 @@ Key Ring feature allows you to group your Keys and submit them all at once. It c
<Steps>
<Step title="Login to your MainWP Dashboard">
</Step>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager">
</Step>
<Step title="Go to the Single Keys tab">
</Step>
Expand All @@ -166,7 +166,7 @@ Key Ring feature allows you to group your Keys and submit them all at once. It c
</Step>
<Step title="Select your Child Sites">
</Step>
<Step title="Click the Save Key to Selected Child Sites button">
<Step title="Click the Save Key button">
</Step>
</Steps>

Expand All @@ -176,7 +176,7 @@ Key Ring feature allows you to group your Keys and submit them all at once. It c
<Steps>
<Step title="Login to your MainWP Dashboard">
</Step>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager">
</Step>
<Step title="Go to the Key Rings tab">
</Step>
Expand All @@ -186,7 +186,7 @@ Key Ring feature allows you to group your Keys and submit them all at once. It c
</Step>
<Step title="Select your Child Sites">
</Step>
<Step title="Click the Save Key Ring to Selected Child Sites button">
<Step title="Click the Save Key Ring button">
</Step>
</Steps>

Expand Down Expand Up @@ -215,13 +215,13 @@ Go to a settings page of a plugin, theme, or one of the WordPress settings pages
</Step>
<Step title="Login to your MainWP Dashboard">
</Step>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager">
</Step>
<Step title="Go to the Import Keys from Key Maker tab">
Go to the **Import Keys from Key Maker** tab
1. Paste that copied code in the Key Code field
2. Give your Key a name
3. Click the **Make the Key** button
<Step title="Go to the Import Keys tab">
Go to the **Import Keys** tab and use the **Import from MainWP Key Maker** section
1. Paste the copied code in the **Key code** field
2. Give your key a name
3. Click the **Import Key** button
</Step>
<Step title="After the Key has been created, you will be redirected to the Key Edit screen.">
After the Key has been created, you will be redirected to the **Key Edit** screen.
Expand All @@ -238,24 +238,24 @@ Verify the form fields look correct for you and, if needed, update field values

- **Delay** – allows you to set a time delay between two submissions. For example, if you set a delay to 5 seconds and submit a key to 3 child sites after the Key has been submitted to the first site, the extension will wait for 5 seconds before it proceeds to the next child site. **This option helps you to reduce server load.**
- **Clear History** – by clicking the button, you will delete all historical data from the Bulk Settings Manager extension.
- **Use Boilerplate** – if enabled, you will be able to use Boilerplate tokens as key field values. **Note that this option works only if the [MainWP Boilerplate Extension](https://mainwp.com/extension/boilerplate/) has been installed and activated on your MainWP Dashboard.**
- **Use Boilerplate** – if enabled, you will be able to use Boilerplate tokens as key field values. **Note that this option works only if the [MainWP Boilerplate Extension](https://mainwp.com/add-on/boilerplate/) has been installed and activated on your MainWP Dashboard.**

## Import a Bulk Settings Manager Key

There are two ways to import Bulk Setting Manager Extension keys, first, by pasting a key code, and second, by importing a key file.
There are two ways to import Bulk Settings Manager Extension keys: by pasting a key code or by importing a key file.

### Paste Key Code

<Steps>
<Step title="Login to your MainWP Dashboard">
</Step>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager">
</Step>
<Step title="Locate the Import Key from the MainWP Key Maker option box">
Locate the **Import Key from the MainWP Key Maker** option box![Paste key code](/images/add-ons/bulk-settings-import-keymaker.png)
1. Enter the key name in the **Key Name** field
2. Paste the previously copied code in the **Key Code** field
3. Click the **Make the Key** button
<Step title="Locate the Import from MainWP Key Maker section">
Locate the **Import from MainWP Key Maker** section![Paste key code](/images/add-ons/bulk-settings-import-keymaker.png)
1. Enter the key name in the **Key name** field
2. Paste the previously copied code in the **Key code** field
3. Click the **Import Key** button
</Step>
</Steps>

Expand All @@ -267,13 +267,13 @@ After pasting the key, you will be prompted to the Edit Key screen, where you ca
<Steps>
<Step title="Login to your MainWP Dashboard">
</Step>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager">
</Step>
<Step title="Locate the Import Key from a File option box">
Locate the **Import Key from a File** option box![Screenshot of Import Key from a File option box with Choose File and Import Key buttons](/images/add-ons/bulk-settings-import-file.png)
<Step title="Locate the Upload Key File section">
Locate the **Upload Key File** section![Screenshot of Import Key from a File option box with Choose File and Import Key buttons](/images/add-ons/bulk-settings-import-file.png)
1. Click the **Choose File** button
2. Browse and select the previously downloaded key file
3. Click the **Import Key** button
3. Click the **Upload Key** button
</Step>
</Steps>

Expand All @@ -285,11 +285,11 @@ After importing the key, you will be prompted to the Edit Key screen, where you
To edit Key values,

<Steps>
<Step title="Go to the MainWP > Add-ons > Bulk Settings Manager > Single Keys page">
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager > Single Keys">
</Step>
<Step title="Locate the Key that you need to edit">
</Step>
<Step title="Click the Edit button">
<Step title="Open the action menu and click Edit">
</Step>
<Step title="Once prompted to the Key Edit page, locate the fields that you need to update">
Once prompted to the **Key Edit** page, locate the fields that you need to update![Edit key field](/images/add-ons/bulk-settings-edit-field-value.jpg)
Expand All @@ -304,25 +304,25 @@ Once prompted to the **Key Edit** page, locate the fields that you need to updat

## How to Use Boilerplate Tokens in Keys

MainWP Bulk Settings Manager Extension supports Boilerplate tokens. By using tokens, it is possible to set per-site unique values in forms. Changing the WP > Settings > General Settings form is the best example of this. In the WP General Settings, 2 fields have to have unique values for each child site. Those are **Site URL** (siteurl) and **WordPress Address** (home). So to properly handle this form,
MainWP Bulk Settings Manager Extension supports Boilerplate tokens. By using tokens, it is possible to set per-site unique values in forms. Changing the WordPress **Settings > General** form is a common example. In that form, the `siteurl` and `home` fields must remain unique for each child site. To handle that kind of form correctly:

<Steps>
<Step title="Make sure that the Support for Boilerplate tokens is enabled">
Make sure that the Support for Boilerplate tokens is enabled![Use boilerplate option](/images/add-ons/bulk-settings-boilerplate-option.jpg)
<Step title="Make sure that the Use Boilerplate option is enabled">
Make sure that the **Use Boilerplate** option is enabled![Use boilerplate option](/images/add-ons/bulk-settings-boilerplate-option.jpg)
</Step>
<Step title="Next, after creating the Key, please find it in the list and Edit it">
</Step>
<Step title="Locate the siteurl and home key fields">
<Step title="Locate the key fields you want to replace with Boilerplate tokens">
</Step>
<Step title="Replace the URL in key with the [url.site] token.">
Replace the URL in key with the [url.site] token.![Key fields](/images/add-ons/bulk-settings-key-fields-tokens.png)
<Step title="Replace the relevant field values with the Boilerplate tokens you want to use">
Replace the relevant field values with the Boilerplate tokens you want to use. ![Key fields](/images/add-ons/bulk-settings-key-fields-tokens.png)
</Step>
<Step title="Save settings.">
<Step title="Save the key">
</Step>
</Steps>


By default, the [url.site] token values are set for each child site. But if you need to use any other token or even create a custom one, be sure that values are set for each child you submit the key to.
Bulk Settings Manager replaces Boilerplate tokens only when the MainWP Boilerplate Extension is installed, activated, and the **Use Boilerplate** option is enabled. Confirm that the token names and per-site values in your Boilerplate setup are correct before you save the key.

## Change WordPress Administration Email Address on Multiple Child Sites at Once

Expand All @@ -344,21 +344,21 @@ Install Bulk Settings Manager and Boilerplate extension on your MainWP Dashboard
<Step title="Install MainWP Key Maker on any of the Child Sites to create a template to replicate on other Child sites">
Install MainWP Key Maker on any of the Child Sites to create a template to replicate on other Child sites
</Step>
<Step title="On MainWP Dashboard > Add-ons > Bulk Settings Manager > Settings page, enable Use Boilerplate option">
On **MainWP Dashboard > Add-ons > Bulk Settings Manager > Settings** page, enable **Use Boilerplate** option ![Use boilerplate option](/images/add-ons/bulk-settings-boilerplate-option.jpg)
<Step title="On MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager > Settings, enable Use Boilerplate">
On **MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager > Settings** enable **Use Boilerplate**. ![Use boilerplate option](/images/add-ons/bulk-settings-boilerplate-option.jpg)
</Step>
<Step title="Navigate to WordPress Dashboard > Settings > General Settings on a Child Site with the Key Maker plugin installed in step 2, and create a Key">
Navigate to **WordPress Dashboard > Settings > General Settings** on a Child Site with the Key Maker plugin installed in step 2, and create a Key
</Step>
<Step title="Navigate to MainWP Dashboard > Add-ons > Bulk Settings Manager > Import Keys and import the Key you just created">
Navigate to **MainWP Dashboard > Add-ons > Bulk Settings Manager > Import Keys** and import the Key you just created
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager > Import Keys and import the key">
Go to **MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager > Import Keys** and import the key you just created
</Step>
<Step title="Next, after creating the Key, please find it in the list and Edit it">
</Step>
<Step title="Locate the siteurl and home key fields">
<Step title="Locate the URL-related key fields">
</Step>
<Step title="Replace the URL in key with the [url.site] token">
Replace the URL in key with the [url.site] token. **Note:** In some specific WordPress installations, WordPress Address (URL) and Site Address (URL) is not the same. In that case, [url.site] token cannot be used for both fields. A custom Boilerplate token will [need to be created](/add-ons/posts-pages/boilerplate-extension#create-custom-tokens) and used for the other field.![Key fields](/images/add-ons/bulk-settings-key-fields-tokens.png)
<Step title="Replace those values with the Boilerplate tokens you want to apply">
Replace those values with the Boilerplate tokens you want to apply. If one token cannot cover every field you need, create the additional token in [MainWP Boilerplate](/add-ons/posts-pages/boilerplate-extension#create-custom-tokens). ![Key fields](/images/add-ons/bulk-settings-key-fields-tokens.png)
</Step>
<Step title="Locate the new_admin_email key field">
</Step>
Expand All @@ -367,35 +367,31 @@ Replace the **Value** of the field with the new address you want to apply to Chi
</Step>
<Step title="Save changes to the Key">
</Step>
<Step title="Select Child Sites from the right and Submit the Key">
<Step title="Select Sites from the right and click Save Key">
</Step>
</Steps>


By default, the [url.site] token values are set for each child site. But if you need to use any other token or even create a custom one, be sure that values are set for each child you submit the key to.
Before you apply the key, confirm that the Boilerplate tokens you used have the correct per-site values for every selected child site.

## How to fix Invalid nonce error in Bulk Settings Manager

When saving a key to a Child Sites, Bulk Setting Manager can, under some circumstances, report an "Invalid nonce" error message. ![Invalid nonce error](/images/add-ons/bulk-settings-sync-nonce-error.png) To resolve this issue:
When saving a key to child sites, Bulk Settings Manager can, under some circumstances, report an "Invalid nonce" error message. ![Invalid nonce error](/images/add-ons/bulk-settings-sync-nonce-error.png) The current interface includes a built-in **Skip Invalid nonce** option in the **Save Key Options** panel. To use it:

<Steps>
<Step title="Edit the key">
<Step title="Open the Single Keys or Key Rings tab">
</Step>
<Step title="Create a new text field by drag-and-dropping the 'Text Field' from the 'Available Fields' box on the right">
Create a new text field by drag-and-dropping the "Text Field" from the "Available Fields" box on the right ![Add new key field](/images/add-ons/bulk-settings-add-text-field.gif)
<Step title="Select the key or key ring and choose the child sites you want to target">
</Step>
<Step title="Fill in the values of the Text Field">
Fill in the values of the Text Field
1. Description: can be any arbitrary value
2. Name: use the text from the error message after the "Try to use:" part
3. Value: mainwp-bsm-unverify-nonce ![New key field values](/images/add-ons/bulk-settings-text-field-nonce.png)
<Step title="Enable Skip Invalid nonce in Save Key Options">
Enable **Skip Invalid nonce** in **Save Key Options**
</Step>
<Step title="Save the key">
<Step title="Click Save Key or Save Key Ring">
</Step>
</Steps>


If another type of Nonce error message appears after saving the key, repeat the steps above by adding another Text Field in the key, but in the Name field, use the new error name.
If a child site error still tells you to "Try to use:" a specific nonce action, you can edit the key and add a **Text Field** where the **Name** matches that action and the **Value** is `mainwp-bsm-unverify-nonce`.

## How to change Rank Math settings on your child sites using Bulk Settings Manager

Expand All @@ -410,14 +406,14 @@ Install MainWP Key Maker on any of the Child Sites to create a template to repli
<Step title="Navigate to WordPress Dashboard > Rank Math > General Settings on a Child Site with the Key Maker plugin installed, and create a Key">
Navigate to **WordPress Dashboard > Rank Math > General Settings** on a Child Site with the Key Maker plugin installed, and create a Key
</Step>
<Step title="Navigate to MainWP Dashboard > Add-ons > Bulk Settings Manager > Import Keys and import the Key you just created">
Navigate to **MainWP Dashboard > Add-ons > Bulk Settings Manager > Import Keys** and import the Key you just created
<Step title="Go to MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager > Import Keys and import the key">
Go to **MainWP Dashboard > Add-ons > Administrative > Bulk Settings Manager > Import Keys** and import the key you just created
</Step>
<Step title="Next, after creating the Key, please find it in the list and Edit it">
Next, after creating the Key, please find it in the list on the **Single Keys** tab ![RankMath key](/images/add-ons/bulk-settings-rankmath-key.png)
</Step>
<Step title="Select Child Sites from the right and Save the Key">
Select Child Sites from the right and Save the Key ![Site selection](/images/add-ons/bulk-settings-site-selection.png)
<Step title="Select Sites from the right and click Save Key">
Select Sites from the right and click **Save Key** ![Site selection](/images/add-ons/bulk-settings-site-selection.png)
</Step>
<Step title="All options from Rank Math > General Settings page are now applied to all selected Child Sites">
All options from **Rank Math > General Settings** page are now applied to all selected Child Sites
Expand Down