Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
c687008
Document Advanced Uptime Monitor abilities
dennisdornon Aug 11, 2026
8f0e7ef
Document Article Uploader publishing recovery
dennisdornon Aug 17, 2026
d1e353c
Document Atarim abilities
dennisdornon Aug 17, 2026
2a6c63f
Update BackWPup documentation for 5.2.0
dennisdornon Aug 17, 2026
36dac9a
Document White Label abilities
dennisdornon Aug 17, 2026
2e3d123
Document Cache Control 5.3.0 updates
dennisdornon Aug 17, 2026
69a0edf
Document Dashboard Lock abilities
dennisdornon Aug 17, 2026
98f9f9a
Document Clone policy abilities
dennisdornon Aug 17, 2026
b792eef
Document Code Snippets abilities
dennisdornon Aug 17, 2026
f121572
Document Comments Abilities
dennisdornon Aug 17, 2026
5724a10
Document Cost Tracker Assistant 5.1.0 changes
dennisdornon Aug 17, 2026
59cca5e
Document Custom Dashboard 5.2.0 changes
dennisdornon Aug 17, 2026
b7bf7d4
Document Database Updater 5.2.0 release
dennisdornon Aug 17, 2026
5b38fd2
Document Domain Monitor 5.3.0 updates
dennisdornon Aug 17, 2026
f7d704f
Document Google Analytics 6.1.0 updates
dennisdornon Aug 17, 2026
a417491
Document Google Search Console 6.2.0 actions
dennisdornon Aug 17, 2026
926df19
Document Lighthouse 5.4.0 WordPress Abilities
dennisdornon Aug 17, 2026
7927941
Document Maintenance 5.3.0 abilities
dennisdornon Aug 17, 2026
e277255
Document Matomo 5.2.0 updates
dennisdornon Aug 17, 2026
f214287
Document Regression Testing 5.3.0 abilities
dennisdornon Aug 17, 2026
43ac9a8
Document WP Rocket 5.2.0 updates
dennisdornon Aug 17, 2026
ac75b12
Document Sucuri 5.1.0 abilities
dennisdornon Aug 17, 2026
1b1bec0
Document Team Control 5.2.0 updates
dennisdornon Aug 17, 2026
1110836
Document Time Tracker 5.2.0 abilities
dennisdornon Aug 17, 2026
9aae450
Document URL Extractor 5.1.0 updates
dennisdornon Aug 17, 2026
3a32ec2
Document WooCommerce Shortcuts 5.1.0 status
dennisdornon Aug 17, 2026
6f1c0bc
Document Custom Post Types 5.1.0 updates
dennisdornon Aug 17, 2026
ca47059
review fixes: cr round 4
dennisdornon Aug 19, 2026
0f771a3
review fixes: cr round 5
dennisdornon Aug 19, 2026
a036078
review fixes: cr round 6
dennisdornon Aug 19, 2026
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
8 changes: 7 additions & 1 deletion add-ons/administrative/comments-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ addonType: extension
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.0"
data-version="6.1.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-comments-extension/"
data-owned-by="Jestart LLC"
Expand Down Expand Up @@ -235,6 +235,12 @@ curl -X PUT \

See [Extensions Endpoints](/api-reference/rest-api/extensions#comments) for the full parameter reference and additional examples.

## Comments Abilities

Version 6.1.0 adds MainWP Abilities for working with comments through supported automation tools. You can list comments, retrieve one comment, view recently synced comments, and moderate comments on authorized child sites.

For permanently deleting trashed comments, use the preview first. A confirmed request then deletes only the comments shown as eligible by that preview.

---

## Related Resources
Expand Down
8 changes: 7 additions & 1 deletion add-ons/administrative/woocommerce-shortcuts-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ thirdPartyPlugin: WooCommerce
data-pricing-tier="free"
data-bundle="Essentials"
data-addon-type="extension"
data-version="5.0.2"
data-version="5.1.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-woocommerce-shortcuts-extension/"
data-owned-by="Automattic Inc."
Expand All @@ -37,6 +37,12 @@ thirdPartyPlugin: WooCommerce

The [MainWP WooCommerce Shortcuts Extension](https://mainwp.com/add-on/woocommerce-shortcuts/) adds a widget to individual child site Overview pages, providing direct links to WooCommerce admin pages through MainWP's Jump to WP Admin flow.

## Shortcut Status and Access

Version 5.1.0 lets you use an authorized automation tool to check whether shortcut data for a selected site is current.

You see only sites that Team Control allows you to access. Before a shortcut opens through Jump to WP Admin, the extension verifies that you can still access the target site.

## Where to Find the Widget

After installing the extension, the WooCommerce Shortcuts widget appears on individual child site Overview pages:
Expand Down
11 changes: 10 additions & 1 deletion add-ons/agency/team-control-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ addonType: extension
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.1"
data-version="5.2.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-team-control-extension/"
data-owned-by="Jestart LLC"
Expand All @@ -48,6 +48,15 @@ addonType: extension
</Step>
</Steps>

## What's New in 5.2.0

- You can use Team Control abilities to manage roles, members, permissions, and role notes.
- You can grant protected authority and operation permissions only through authorized roles.
- You preview and confirm role changes before they apply. If an operation is interrupted, the extension can recover without leaving a partial role change.
- Existing installations receive an owner automatically, and you cannot grant yourself protected access.
- When you remove a user, the extension verifies the multisite deletion result before changing role membership.
- Repeating a role-note request does not create duplicates, and a complete role update replaces your prior permission set.


![Team Control Dashboard Users tab showing role filters and the users table](/images/add-ons/team-control-dashboard-users.png)

Expand Down
8 changes: 7 additions & 1 deletion add-ons/agency/white-label-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ addonType: extension
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.0.3"
data-version="5.1.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-white-label-extension/"
data-owned-by="Jestart LLC"
Expand Down Expand Up @@ -66,6 +66,12 @@ White Label no longer includes child-site plugin and update hiding controls (for
| 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 Abilities

Version 5.1.0 adds White Label abilities for authorized MainWP users. You can view global and site-specific configuration summaries, enable or disable an existing per-site override, and apply saved configuration to one child site.

If White Label settings cannot be saved, the extension shows an error instead of confirming the update.

## 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.
Expand Down
8 changes: 7 additions & 1 deletion add-ons/analytics/google-search-console-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ thirdPartyPlugin: Google Search Console
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="integration"
data-version="6.0"
data-version="6.2.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-google-search-console-extension/"
data-integrates-with="Google Search Console"
Expand Down Expand Up @@ -200,6 +200,12 @@ Go to **MainWP > Add-ons > Analytics > Google Search Console** and use these tab
- **Fetch Google Search Console data automatically**: Enable scheduling and choose how often MainWP should pull fresh data.
- **Refresh Data**: Click to fetch the latest stats immediately (Data is cached to reduce API calls; refreshing clears and updates the cache.)

## MainWP Actions

You can use MainWP actions to view Search Console connections and properties, manage site mappings and refresh settings, and request refreshes. When you refresh a connection, its property assignments stay in sync.

Your scheduled refreshes do not overlap and report their outcome. Site selection and data views show only sites you are permitted to access.

## GSC data in Pro Reports

If you use **MainWP Pro Reports**, you can include Google Search Console data in your client reports. For the full list of available tokens, see the [Available Pro Reports Tokens](/add-ons/agency/available-pro-reports-tokens) article.
Expand Down
6 changes: 5 additions & 1 deletion add-ons/analytics/mainwp-google-analytics-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ addonType: "integration"
thirdPartyPlugin: "Google Analytics"
---

<div id="addon-data" style={{display: 'none'}} data-title="Google Analytics" data-purchase-url="https://mainwp.com/extension/google-analytics/" data-pricing-tier="pro" data-bundle="MainWP Pro" data-addon-type="integration" data-version="5.0" data-developer="MainWP" data-changelog-url="https://mainwp.com/changelog/mainwp-google-analytics-extension/" data-integrates-with="Google Analytics" data-owned-by="Google LLC" data-privacy-url="https://policies.google.com/privacy" />
<div id="addon-data" style={{display: 'none'}} data-title="Google Analytics" data-purchase-url="https://mainwp.com/extension/google-analytics/" data-pricing-tier="pro" data-bundle="MainWP Pro" data-addon-type="integration" data-version="6.1.0" data-developer="MainWP" data-changelog-url="https://mainwp.com/changelog/mainwp-google-analytics-extension/" data-integrates-with="Google Analytics" data-owned-by="Google LLC" data-privacy-url="https://policies.google.com/privacy" />

## What You'll Learn

Expand Down Expand Up @@ -162,6 +162,8 @@ The add-on automatically assigns properties to child sites based on URL matching
</Step>
</Steps>

Your website assignments remain in place when you refresh analytics data or reconnect a Google account.

## Google Analytics Visitor Data

After you connect your Google Analytics account and assign GA4 properties to child sites, you can view data on **MainWP > Add-ons > Google Analytics > Visitor Data**.
Expand Down Expand Up @@ -217,6 +219,8 @@ Click **Reset Now** in the notice to regenerate the site secret. After the reset

### Sign-in account needs verification/reconnection

You can use the Manage Accounts page to identify sign-in accounts that need verification or reconnection.

- Go to **MainWP > Add-ons > Google Analytics > Manage Accounts**
- For disconnected Sign In accounts, click **Reconnect Account**
- Use **Refresh Data** after reconnecting
Expand Down
9 changes: 8 additions & 1 deletion add-ons/analytics/matomo-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ thirdPartyPlugin: Matomo
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="integration"
data-version="5.0"
data-version="5.2.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-matomo-piwik-extension/"
data-integrates-with="Matomo"
Expand All @@ -40,6 +40,13 @@ thirdPartyPlugin: Matomo

![Matomo Extension dashboard showing analytics data](/images/add-ons/matomo-dashboard-overview.png) The [MainWP Matomo (formerly Piwik) Extension](/add-ons/analytics/matomo-extension) gives you valuable insights into your visitor's search and traffic patterns, your marketing campaigns, and much more, allowing you to optimize your strategy and the online experience of your users. Matomo is the leading open-source web analytics platform and can help you gather and analyze important information about your visitors. Track Key Performance Indicators such as visits, goal conversion rates, downloads, keywords, and much more. **Important Notes:** The Matomo Extension doesn't allow you to insert the Piwik tracking code on your child sites. To do that, you will need to add the code manually or use a 3rd party plugin. The Matomo Extension is compatible only with Matomo Dashboard, On-Premise or Cloud. **Matomo for WordPress plugin and Piwik Pro are not supported.** That means that the extension cannot ready data directly from the Matomo for WordPress plugin!

## What's New in 5.2.0

- You can manage Matomo through MainWP Abilities.
- Your Matomo management requests are processed on a schedule.
- Your existing Matomo connection settings and site data are migrated for the new management features.
- When you delete a managed site, its Matomo data is removed.

## Use this Extension To Track:

- Visits
Expand Down
10 changes: 9 additions & 1 deletion add-ons/backups/backwpup-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ thirdPartyPlugin: BackWPup
data-pricing-tier="free"
data-bundle="Essentials"
data-addon-type="integration"
data-version="5.1.1"
data-version="5.2.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-backwpup-extension/"
data-integrates-with="BackWPup"
Expand All @@ -42,6 +42,10 @@ thirdPartyPlugin: BackWPup

With the MainWP BackWPup Add-on, you can control the [BackWPup Plugin](https://wordpress.org/plugins/backwpup/) settings for all your child sites directly from your MainWP Dashboard. This includes giving you the ability to create your child site backups and even set Backup schedules directly from your MainWP Dashboard.

## BackWPup Abilities

You can use MainWP Abilities to manage BackWPup site status, jobs, backups, logs, diagnostics, and plugin visibility.

## Installing the BackWPup add-on

The MainWP BackWPup add-on needs to be installed **only on your MainWP Dashboard** site. You can [install it as any other MainWP add-on](https://mainwp.com/kb/manage-extensions/#install-add-ons).
Expand Down Expand Up @@ -144,6 +148,8 @@ The BackWPup Add-on allows you to manage the BackWPup plugin backups directly fr

After you click **Save Changes**, the add-on syncs this global job to child sites that do not use **Override General Settings**.

If a global template becomes shared with another site, you cannot change its schedule for one site only.

### Create a Backup Job on a Single Site

<Steps>
Expand Down Expand Up @@ -292,6 +298,8 @@ In the top right of the page, select the desired child site from the dropdown, a
</Step>
</Steps>

Backup downloads use secure, temporary access links. If a protected FOLDER backup is unavailable, the same one-use access remains available for another attempt.


### Delete Backup Files

Expand Down
9 changes: 8 additions & 1 deletion add-ons/client/cost-tracker-assistant-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ addonType: extension
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.0.8"
data-version="5.1.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-cost-tracker-assistant-extension/"
data-owned-by="Jestart LLC"
Expand Down Expand Up @@ -79,6 +79,13 @@ When installing plugins or themes via ZIP upload, Cost Tracker Assistant streaml

This eliminates the need to navigate to Cost Tracker separately after each purchase.

## What's New in 5.1.0

- You can use automation to manage renewal notification settings and Cost Tracker site memberships.
- You see when the mailer accepted an alert but its reminder state could not be recorded.
- Your invalid or unauthorized Cost Tracker edits and archive uploads are rejected before changes are made.
- The extension prevents you from creating duplicate plugin and theme Cost Tracker entries.

## Requirements

- MainWP Dashboard with the Cost Tracker feature enabled
Expand Down
10 changes: 9 additions & 1 deletion add-ons/client/mainwp-time-tracker-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ addonType: extension
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.1.1"
data-version="5.2.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-time-tracker-extension/"
data-owned-by="Jestart LLC"
Expand Down Expand Up @@ -115,6 +115,14 @@ Navigate to the Time Tracker **Logs** page, locate the running task, and from th

Navigate to the Time Tracker **Logs** page, locate the running task, and from the ellipsis menu, select **Delete**, then confirm the deletion.

## Time Tracker Abilities

Version 5.2.0 lets you use 12 Time Tracker abilities with authorized automation tools. You can manage buckets, tasks, and timers, and read reports. The same request ID is returned across responses.

Each operation confirms that you can access the exact bucket, task, timer, client, or site involved. Your time entries, timer state, and billing totals update together. A running timer stays tied to its current generation, so pausing or recovering it gives you the same reconciled state.

Task counters on Sites and Clients reflect the tasks for the respective site or client. Invalid flags or unauthorized attempts return specific errors.

## Payment Statuses

1. **Draft** - The bill has been created but not yet finalized or sent to the recipient. This status is used for bills that are still being worked on.
Expand Down
8 changes: 7 additions & 1 deletion add-ons/development/clone-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ addonType: extension
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.0.1"
data-version="5.1.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-clone-extension/"
data-owned-by="Jestart LLC"
Expand All @@ -45,6 +45,12 @@ The [MainWP Clone Extension](https://mainwp.com/add-on/clone/) provides the abil

The Clone extension requires a preinstalled WordPress site connected to your MainWP Dashboard **(Destination Site)**. Once you install a fresh WordPress website and connect it to your MainWP Dashboard, you will be able to use the clone feature and clone your template site **(Source Site)**.

## Manage Clone Policy with WordPress Abilities

WordPress Abilities can view and manage the Clone policy saved in your MainWP Dashboard. You can enable or disable the Clone feature and allow or disallow individual destination sites.

The settings are saved without starting a clone or syncing a child site. If another change conflicts with your save, MainWP reports that the setting could not be saved.

The Extension allows you to clone websites in two ways:

1. Quick Clone
Expand Down
8 changes: 7 additions & 1 deletion add-ons/development/code-snippets-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ addonType: extension
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="extension"
data-version="5.1"
data-version="5.2"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-code-snippets-extension/"
data-owned-by="Jestart LLC"
Expand Down Expand Up @@ -260,6 +260,12 @@ When you click **Run Snippet**, the Console opens and shows the current process

The Console also shows progress counts, site-level status icons, returned output for **Return Info** snippets, and a **Stop Process** button for stopping queued or in-progress processing.

## WordPress Abilities

Version 5.2 lets you use authorized integrations with WordPress Abilities to manage snippets, validate PHP without executing it, run snippets, apply persistent snippets, remove persistent snippets, and delete Dashboard records.

You can access only snippets and child sites you are authorized to access. Execution results display as plain text.

## Useful Code Snippets

MainWP is not responsible for the code that you run on your sites. Use this tool with extreme care and at your own risk. It is recommended that you run any code on a test site before releasing it on live sites. In case you damage your site by using a bad code snippet, read [Remove a Code Snippet From a Broken Site](#remove-a-code-snippet-from-a-broken-site) to see how to fix it.
Expand Down
4 changes: 3 additions & 1 deletion add-ons/development/mainwp-and-atarim-integration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ thirdPartyPlugin: Atarim
data-pricing-tier="pro"
data-bundle="MainWP Pro"
data-addon-type="integration"
data-version="5.0.1"
data-version="5.2.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-atarim-extension/"
data-integrates-with="Atarim"
Expand Down Expand Up @@ -70,6 +70,8 @@ After connecting with Atarim, MainWP will gain the following features:
- **Pro Reports data note**: Pro Reports Extension version 4.0.11 or newer is required for Atarim data.
- Atarim Data can be included in the Report from the **Report Data** section ![Atarim pro reports settings](/images/add-ons/3e3c796fdd7f.png)
- Atarim data can also be included by using two tokens: `[atarim.all.tasks]` displays all tasks for a site within the selected date range, and `[atarim.billable.tasks]` displays all billable tasks for a site within the selected date range.
- **MainWP Abilities (version 5.2.0)**
- With MainWP abilities, you can read Atarim site, task, and time-entry data and refresh task data.

## Connect MainWP to Atarim Dashboard

Expand Down
11 changes: 9 additions & 2 deletions add-ons/development/mainwp-custom-dashboard-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ addonType: extension
- Where custom code is stored and executed
- Using the built-in code editor (CodeMirror 6) with autocompletion, code folding, and the One Dark theme
- Validating PHP snippets before saving with the built-in syntax check
- Avoiding overwritten drafts when another editor changes a snippet
- Handling PHP errors safely
- Accessing example code snippets

Expand All @@ -26,7 +27,7 @@ addonType: extension
data-pricing-tier="free"
data-bundle="Essentials"
data-addon-type="extension"
data-version="5.1"
data-version="5.2.0"
data-developer="MainWP"
data-changelog-url="https://mainwp.com/changelog/mainwp-custom-dashboard-extension/"
data-owned-by="Jestart LLC"
Expand Down Expand Up @@ -86,6 +87,12 @@ The editor is powered by CodeMirror 6 and ships with productivity features enabl

Use the language tab at the top of the page to switch between the PHP, CSS, and JS editors. Each language is saved independently.

## Saving Snippets

When you save a snippet, the extension checks whether it changed after you opened the editor. If another editor saved a change first, your draft remains in the editor and the extension asks you to reload before saving again. Copy your draft if needed, reload the page, then review and save it.

MainWP abilities can view snippet status, validate PHP, and preview or apply changes to PHP, CSS, and JavaScript snippets. Applying a change requires explicit confirmation.

## Writing PHP Snippets

PHP snippets are saved as **tagless** PHP — write your code without `<?php` or `?>` tags. The extension validates this on save and rejects snippets that contain PHP tags.
Expand All @@ -108,7 +115,7 @@ add_action( 'admin_footer', function () {

### Pre-save syntax validation

Before a PHP snippet is saved, the extension runs a syntax check on the code. If the snippet contains a parse error, the save is rejected and the editor displays the error message so you can fix it before it ever runs.
Before a PHP snippet is saved, the extension runs a syntax check on the code. If the snippet is malformed, the save is rejected without running it.

This catches the most common cause of a broken dashboard — a typo in a snippet — without you having to reload the page to find out.

Expand Down
Loading