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

# Wordfence

> The Wordfence Integration combines the power of your MainWP Dashboard with the Wordfence Security plugin. It allows you to scan child sites for security issues, monitor live traffic, and manage Wordfence settings across your network from the MainWP Dashboard.

## What You'll Learn

* Installing the Wordfence Integration and plugin on child sites
* Configuring global and per-site Wordfence settings
* Scanning child sites for security issues
* Monitoring live traffic across your network

***

> [!NOTE]
>
> **Integration Add-on** - This add-on extends MainWP to work with Wordfence. Wordfence Security must be installed and activated on each child site you want to manage.

Installing the Wordfence Integration requires two steps:

* Install and activate the add-on on your MainWP Dashboard site.
* Install and activate Wordfence Security on your child sites.

### 1. Installing the Add-on

The Wordfence Integration is a WordPress plugin. Follow these steps on your MainWP Dashboard site, not on a child site:

**1. Go to WP Admin > Plugins > Add Plugin**

**2. Click Upload Plugin**

**3. Click Choose File**

**4. Select mainwp-wordfence-extension.zip and click Install Now**

**5. Click Activate Plugin after installation**

**6. Go to MainWP > Add-ons > Manage Add-ons**

**7. Locate Wordfence Integration and click Enable**

The add-on is now ready for use. Alternatively, upload the extracted `mainwp-wordfence-extension` directory to `wp-content/plugins` on the MainWP Dashboard site, then activate and enable it.

### 2. Installing Wordfence Security

Install and activate Wordfence Security on each child site that you want to manage through the integration.

**1. Go to WP Admin > Plugins > Add Plugin on the child site**

**2. Search for Wordfence**

**3. Locate Wordfence Security and click Install Now**

**4. Click Activate Plugin**

**5. Sync the child site with your MainWP Dashboard**

The Wordfence Integration can now detect and manage Wordfence Security on that child site.

## Wordfence Settings

### Global Settings

Go to **MainWP > Add-ons > Security > Wordfence**. The integration provides these network-level tabs:

* Wordfence Overview
* Options
* Live Traffic
* Blocking
* Firewall
* Scan
* Diagnostics

Use the settings tabs to define network defaults. Saving a network settings section synchronizes that section to child sites that are not using individual overrides. Sites with **Override general settings** enabled keep their individual settings.

If you install Wordfence Security on additional child sites, sync them and re-save each relevant network settings tab to apply the defaults.

### Settings Added in 5.2

Wordfence Integration 5.2 adds these controls to the existing settings tabs. Configure them globally or from a site's Wordfence settings when individual overrides are enabled, then click **Save Settings**.

| Tab | Setting | Purpose |
| - | - | - |
| Options | **Display "Audit Log" menu item** | Show the Wordfence Audit Log menu item in the Child site's WordPress admin |
| Options | **Trusted Proxy Preset** | Choose **None**, **Amazon CloudFront**, **Ezoic**, or **Quic.cloud** to configure trusted proxy handling |
| Options | **Look up visitor IP locations via Wordfence servers** | Enable Wordfence's remote visitor IP location lookup |
| Scan | **Monitor Web Application Firewall status** | Include the firewall's status in scan checks |
| Scan | **Use only IPv4 to start scans** | Use IPv4 when starting a scan |
| Scan | Scan resume attempts | Set the maximum number of scan resume attempts from `0` through `5` |

> [!NOTE]
>
> In Wordfence Integration 5.2.2, the Scan tab's `0`-`5` resume-attempt selector is labeled **Alert me with scan results of this severity level or greater**. That selector controls scan resume attempts.

### Individual Site Settings

The integration also provides per-site Wordfence settings.

**1. Go to MainWP > Sites > Manage Sites**

**2. Select the child site and open Wordfence in the site navigation**

**3. Open the Wordfence Options tab**

**4. Enable Override general settings**

**5. Configure the Wordfence Options, Live traffic, Blocking, Firewall, Scan, or Diagnostics tabs**

**6. Click Save Settings**

## Wordfence Dashboard

Go to **MainWP > Add-ons > Security > Wordfence** and open the **Wordfence Overview** tab. The sites table shows child sites where Wordfence Security is installed, including plugin status, version, visibility, last scan, and update availability.

* If the plugin is inactive, the **Activate Plugin** action appears in the site row.
* If an update is available, the **Update Plugin** action appears in the site row.

### Available Actions

The row action menu includes **Overview**, **Edit**, **Open Wordfence**, and **Hide Plugin** or **Unhide Plugin**. For active installations, it also includes **Scan Site**, **Live Traffic**, **Blocking**, **Scan Results**, and **Deactivate Plugin**. Inactive installations offer **Activate Plugin**. **Update Plugin** appears when an update is available.

To deactivate Wordfence Security on several sites, select their checkboxes in **Wordfence Overview**, choose **Deactivate** from **Bulk Actions**, and click **Apply**. The integration processes selected active installations. Use **Activate** to enable selected inactive installations again. Deactivation turns off Wordfence Security on those Child sites.

#### Important Notes

If you know that you have the plugin installed on a child site, but the child site doesn't appear in the list, try to re-sync your sites.

## How to Scan Child Sites With the Wordfence Integration

The Wordfence Integration enables you to trigger the scanning process on child sites directly from your dashboard. To do this,

**1. Go to MainWP > Add-ons > Security > Wordfence**

**2. On Wordfence Overview, locate the site and click Scan Site in its row action menu**

![Screenshot highlighting the Scan Site action in the Wordfence Integration](https://mintcdn.com/mainwp/RPovfYRqnTPYvuIf/images/add-ons/wordfence-scan-site-action.png?fit=max\&auto=format\&n=RPovfYRqnTPYvuIf\&q=85\&s=136706fef429637ce3df6b51c200b854)

## Monitor Child Sites Live Traffic

To monitor live traffic for one child site from your MainWP Dashboard:

* Open the **Wordfence Overview** tab.
* Locate the child site and click **Live Traffic** in its row action menu.
* The integration opens the live traffic view for that site.

![Screenshot of Live Traffic view showing requests to a child site](https://mintcdn.com/mainwp/9Fi7dKBCIriTb92d/images/add-ons/21f0fedceb53.png?fit=max\&auto=format\&n=9Fi7dKBCIriTb92d\&q=85\&s=0b14d27df2461b333122d7b77b00cf15)

If live traffic is disabled, open the network-level **Live Traffic** tab, set **Enable live traffic logging** to **All Traffic**, and click **Save Settings**. If the site uses individual overrides, configure the same option from the site's **Wordfence > Live traffic** tab instead.

## Monitor Network Live Traffic

Open the **Live Traffic** tab on the Wordfence page to view traffic from active child sites in one place.

![Screenshot of Network Live Traffic showing combined traffic from all child sites](https://mintcdn.com/mainwp/9Fi7dKBCIriTb92d/images/add-ons/08fa187ac3f6.png?fit=max\&auto=format\&n=9Fi7dKBCIriTb92d\&q=85\&s=381316b66fea2e9e2b06f6a48fd41ec7)

***

## Read Stored Data Through MainWP Abilities

The Wordfence Integration provides three read-only abilities for a site's stored scan status, issue summary, and selected non-secret settings. They do not start a scan, contact the Child Site, or change settings. Stored data can be older than the site's current state, and `unknown` scan status does not establish a clean scan.

See [Wordfence Abilities](https://docs.mainwp.com/api-reference/abilities-api/wordfence.md) for discovery, access requirements, request examples, and response limits.

## Related Resources

* [Security Add-ons](https://docs.mainwp.com/add-ons/security.md) - Browse all security tools
* [Vulnerability Checker Extension](https://docs.mainwp.com/add-ons/security/vulnerability-checker-extension.md) - Scan for known vulnerabilities
* [Sucuri Extension](https://docs.mainwp.com/add-ons/security/sucuri-extension.md) - Alternative security integration


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.