Skip to main content

​
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 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.

​
Features Overview

FeatureDescription
White LabelReplace plugin name, description, author, and URIs with your own branding
Hide PluginMake the MainWP Child plugin invisible in the client’s plugins list
Remove & DisableRestrict access to selected WordPress and MainWP Child admin areas
WordPress OptionsCustomize login images, favicons, dashboard widgets, footer text, and admin CSS
Support FormAdd 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.
1

Navigate to White Label settings

Go to MainWP > Add-ons > White Label and select the White Label tab.
2

Configure the MainWP Child white label settings

White Label Settings
FieldDescription
Visually hide the MainWP Child pluginHide the plugin from the WordPress plugins list
Plugin nameYour custom plugin name
Plugin descriptionYour custom description
Plugin URILink to your website or plugin page
Plugin authorYour name or company name
Author URILink to your author page
3

Save Settings

Click Save Settings to apply changes to all child sites.
Example result: If you set Plugin name to “Demo Name” and Plugin author to “Demo Author”, the plugins list will display: Branding Result
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.Remove and disable white label options

​
Available Options

OptionEffect
Prevent theme alterationsLocks the current theme and prevents switching to another theme
Hide the MainWP Child Settings pageRemoves the MainWP Child Settings page
Hide the MainWP Child Server Information pageRemoves the MainWP Child Server Information page
Hide the MainWP Child Restore (Clone) pageRemoves the MainWP Child Restore (Clone) page
Hide the WordPress Tools pageRemoves the Tools menu from WP Admin
Hide the WordPress General settings pageRemoves the Settings menu from WP Admin
Hide the Permalinks settings pageRemoves 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.White Label - WordPress options

​
Available Options

OptionDescription
Custom login page imageUpload a custom image for the WordPress login page
Custom login image URLSet the destination URL for the login image
Custom login image titleSet the login image title text
Custom website faviconUpload a custom favicon for the site
Hide default WordPress dashboard widgetsHide selected default dashboard widgets
Suppress update notifications for WordPress coreHide WordPress core update notifications
Hide screen optionsHide the Screen Options tab
Hide help boxHide the Help tab
Hide default WordPress post meta boxesRemove selected post editor meta boxes
Hide default WordPress page meta boxesRemove selected page editor meta boxes
Global Footer ContentAdd content to the front-end footer
Dashboard Footer ContentReplace “Thank you for creating with WordPress” in admin footer
Site Generator OptionsReplace the default generator text and link
Custom Admin CSSAdd CSS to customize the admin area
Custom Login CSSAdd CSS to customize the login page
Text ReplaceFind 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.White Label - Support options

​
Configuration Options

SettingDescription
Activate the Support featureEnable or disable the support form
Designated support contact emailSet the email address that receives support messages
Position of the “Contact Support” buttonShow the button in the Top Admin bar, Admin menu, or both
Contact Support button titleSet the text displayed on the support button
Support introduction messageSet the message shown above the contact form
Submit Button TitleText on the form submit button
Successful Submission MessageConfirmation message after form submission
Message to return sender to page they were onSet 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:
1

Navigate to White Label

Go to MainWP > Add-ons > White Label.
2

Reset settings

Scroll to the bottom and click Reset Settings.
3

Confirm and save

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. Download and install the Reset MainWP Child Plugin Settings 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

1

Access the child site via FTP

Connect to your child site server.
2

Locate the MainWP Child class file

Find site_root/wp-content/plugins/mainwp-child/class/class-mainwp-child.php
3

Edit the file

Find the public function __construct( $plugin_file ) function (around line 210). After the line containing this->update();, add:
delete_option('mainwp_branding_child_hide');
4

Upload and overwrite

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: 
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: 
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: 
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 to deploy these filters to all child sites at once.