> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.
# White Label
> With this White Label Extension, you can rebrand MainWP Child, visually hide the plugin, customize selected WordPress admin elements, and provide on-site support for your clients.
## What You'll Learn
* White labeling the MainWP Child plugin
* Hiding the plugin from clients
* Managing available white label controls
* Adding branded support forms
* Resetting white label settings
***
**Extension Add-on** - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.
The [MainWP White Label Extension](https://mainwp.com/add-on/white-label/) lets you rebrand the MainWP Child plugin on client sites. You can replace the plugin name and author information with your own branding, hide the plugin entirely from the plugins list, restrict client access to certain WordPress features, and add a branded support contact form.
This extension white labels the MainWP Child plugin only. The MainWP Dashboard plugin cannot be white labeled.
White Label no longer includes child-site plugin and update hiding controls (for example, hiding Plugins/update pages or disabling update checks) due to WordPress.org compliance requirements. See [Removed hiding options](/add-ons/agency/white-label-plugin-update-hiding-removal).
## Features Overview
| Feature | Description |
| ----------------- | ------------------------------------------------------------------------------- |
| White Label | Replace plugin name, description, author, and URIs with your own branding |
| Hide Plugin | Make the MainWP Child plugin invisible in the client's plugins list |
| Remove & Disable | Restrict access to selected WordPress and MainWP Child admin areas |
| WordPress Options | Customize login images, favicons, dashboard widgets, footer text, and admin CSS |
| Support Form | Add a branded contact form to child site admin areas |
## White Label the MainWP Child Plugin
Rebrand how the MainWP Child plugin appears in the WordPress plugins list. The same **White Label** tab and **MainWP Child White Label Settings** section also includes the option to visually hide the plugin, so you can configure the branding fields, the hide option, or both at the same time.
Go to **MainWP > Add-ons > White Label** and select the **White Label** tab.
| Field | Description |
| ------------------------------------- | ----------------------------------------------- |
| Visually hide the MainWP Child plugin | Hide the plugin from the WordPress plugins list |
| Plugin name | Your custom plugin name |
| Plugin description | Your custom description |
| Plugin URI | Link to your website or plugin page |
| Plugin author | Your name or company name |
| Author URI | Link to your author page |
Click **Save Settings** to apply changes to all child sites.
Go to **MainWP > Sites > Manage Sites**, find the site, and click **Settings**.
Go to the **White Label** tab, locate **General Settings**, and enable **Override general settings**.
In the **MainWP Child White Label Settings** section, enable **Visually hide the MainWP Child plugin** if needed and enter your custom **Plugin name**, **Plugin description**, **Plugin URI**, **Plugin author**, and **Author URI**.
Click **Save Settings** to apply.
**Example result:** If you set **Plugin name** to "Demo Name" and **Plugin author** to "Demo Author", the plugins list will display:
Leave fields empty (except **Plugin name**) to hide that information rather than display the original. Hiding the plugin does not disable the other branding fields, so if you use reporting or other areas that still surface the child plugin details, set the branding fields as well so those views use your custom plugin information instead of the default MainWP Child details. To remove white labeling entirely, delete the **Plugin name** and save.
## Remove & Disable Functions
Restrict client access to WordPress features and MainWP Child settings.
Go to **MainWP > Add-ons > White Label** and select the **Remove & Disable Options** tab.
Go to **MainWP > Sites > Manage Sites**, open the site's **Settings**, navigate to the **White Label** tab, enable **Override general settings**, then locate **Remove & Disable Options**.
### Available Options
| Option | Effect |
| --------------------------------------------- | --------------------------------------------------------------- |
| Prevent theme alterations | Locks the current theme and prevents switching to another theme |
| Hide the MainWP Child Settings page | Removes the MainWP Child Settings page |
| Hide the MainWP Child Server Information page | Removes the MainWP Child Server Information page |
| Hide the MainWP Child Restore (Clone) page | Removes the MainWP Child Restore (Clone) page |
| Hide the WordPress Tools page | Removes the **Tools** menu from WP Admin |
| Hide the WordPress General settings page | Removes the **Settings** menu from WP Admin |
| Hide the Permalinks settings page | Removes the **Permalinks** settings page from WP Admin |
## WordPress Options
Customize WordPress admin areas, login pages, and site-wide elements on child sites.
Go to **MainWP > Add-ons > White Label** and select the **WordPress Options** tab.
Go to **MainWP > Sites > Manage Sites**, open the site's **Settings**, navigate to the **White Label** tab, enable **Override general settings**, then locate **WordPress Options**.
### Available Options
| Option | Description |
| ------------------------------------------------ | --------------------------------------------------------------- |
| Custom login page image | Upload a custom image for the WordPress login page |
| Custom login image URL | Set the destination URL for the login image |
| Custom login image title | Set the login image title text |
| Custom website favicon | Upload a custom favicon for the site |
| Hide default WordPress dashboard widgets | Hide selected default dashboard widgets |
| Suppress update notifications for WordPress core | Hide WordPress core update notifications |
| Hide screen options | Hide the **Screen Options** tab |
| Hide help box | Hide the **Help** tab |
| Hide default WordPress post meta boxes | Remove selected post editor meta boxes |
| Hide default WordPress page meta boxes | Remove selected page editor meta boxes |
| Global Footer Content | Add content to the front-end footer |
| Dashboard Footer Content | Replace "Thank you for creating with WordPress" in admin footer |
| Site Generator Options | Replace the default generator text and link |
| Custom Admin CSS | Add CSS to customize the admin area |
| Custom Login CSS | Add CSS to customize the login page |
| Text Replace | Find and replace text strings throughout the admin area |
## Support Form
Add a branded contact form to child site admin areas so clients can reach you directly.
Go to **MainWP > Add-ons > White Label** and select the **Support Form** tab.
Go to **MainWP > Sites > Manage Sites**, open the site's **Settings**, navigate to the **White Label** tab, enable **Override general settings**, then locate **Support Form**.
### Configuration Options
| Setting | Description |
| --------------------------------------------- | --------------------------------------------------------- |
| Activate the Support feature | Enable or disable the support form |
| Designated support contact email | Set the email address that receives support messages |
| Position of the "Contact Support" button | Show the button in the Top Admin bar, Admin menu, or both |
| Contact Support button title | Set the text displayed on the support button |
| Support introduction message | Set the message shown above the contact form |
| Submit Button Title | Text on the form submit button |
| Successful Submission Message | Confirmation message after form submission |
| Message to return sender to page they were on | Set the text for the return link after submission |
The support form remains disabled if the **Designated support contact email** field is empty.
## Reset White Label Options
To reset all white label settings to defaults:
Go to **MainWP > Add-ons > White Label**.
Scroll to the bottom and click **Reset Settings**.
Click **Yes** in the confirmation popup, then click **Save Settings** to apply the reset to child sites.
## White Label Master Reset
If a child site becomes disconnected and you cannot see the MainWP Child plugin (because it was hidden) or other white label options are stuck, use one of these methods to reset.
### Option 1: Reset Tool (Recommended)
Download and install the [Reset MainWP Child Plugin Settings](https://www.dropbox.com/scl/fi/m5eo3qgzpvuals4wzstci/klbs-reset-mainwp-settings.zip?rlkey=wvum5e72b6w7qcu7z4pl4db0q\&dl=0) plugin on the child site. It resets all MainWP Child settings and deactivates itself automatically.
Remove the reset tool plugin after use for security reasons.
### Option 2: Manual Code Edit
Connect to your child site server.
Find `site_root/wp-content/plugins/mainwp-child/class/class-mainwp-child.php`
Find the `public function __construct( $plugin_file )` function (around line 210). After the line containing `this->update();`, add:
```php theme={null}
delete_option('mainwp_branding_child_hide');
```
Save and upload the file back to the server, overwriting the original.
### Option 3: Functions.php Filter
Add this code to the active theme's functions.php on the child site:
```php theme={null}
add_filter( 'mainwp_child_branding_init_options', 'mycustom_mainwp_child_branding_init_options');
function mycustom_mainwp_child_branding_init_options( $opts ) {
if (is_array($opts) && isset($opts['hide'])) {
$opts['hide'] = '';
}
return $opts;
}
```
After reconnecting the site, remove this code so the White Label Extension functions properly again.
## Exclude Specific Users from White Labeling
The `mainwp_child_branding_init_options` filter lets you disable white label settings for specific users on child sites.
### Exclude by User ID
This example excludes user ID 1 from white label settings:
```php theme={null}
add_filter( 'mainwp_child_branding_init_options', 'mycustom_mainwp_child_branding_init_options' );
function mycustom_mainwp_child_branding_init_options( $option ) {
$current_user_id = get_current_user_id();
if ( $current_user_id == '1' && is_array( $option ) && isset( $option['cancelled_branding'] ) ) {
$option['cancelled_branding'] = true;
}
return $option;
}
```
### Exclude by Username
This example excludes the user "bogdan" from white label settings:
```php theme={null}
add_filter( 'mainwp_child_branding_init_options', 'mycustom_mainwp_child_branding_init_options' );
function mycustom_mainwp_child_branding_init_options( $option ) {
$current_user = wp_get_current_user();
if ( $current_user && $current_user->user_login == 'bogdan' && is_array( $option ) && isset( $option['cancelled_branding'] ) ) {
$option['cancelled_branding'] = true;
}
return $option;
}
```
Use the [MainWP Code Snippets Extension](https://mainwp.com/extension/code-snippets/) to deploy these filters to all child sites at once.
***
## Related Resources
* [Removed hiding options](/add-ons/agency/white-label-plugin-update-hiding-removal) - Change details and manual code option
* [Team Control Extension](/add-ons/agency/team-control-extension) - Role-based access control
* [Pro Reports Extension](/add-ons/agency/pro-reports-extension-overview) - Branded client reports
* [Agency Add-ons](/add-ons/agency) - Browse agency add-ons
| Field | Description |
| ------------------------------------- | ----------------------------------------------- |
| Visually hide the MainWP Child plugin | Hide the plugin from the WordPress plugins list |
| Plugin name | Your custom plugin name |
| Plugin description | Your custom description |
| Plugin URI | Link to your website or plugin page |
| Plugin author | Your name or company name |
| Author URI | Link to your author page |
