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

# SSL Monitor

> MainWP SSL Monitor Extension allows you to keep an eye on your Child Site(s) SSL Certificates and sends email alerts when monitored certificates are nearing expiration.

## What You'll Learn

* Checking SSL certificate status for HTTPS child sites
* Viewing detailed certificate information
* Scheduling automated SSL checks
* Overwriting general settings for individual sites
* Reading certificate status through MainWP Abilities

***

> [!NOTE]
>
> **Extension Add-on** - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.

[SSL Monitor - Video Tutorial](https://www.youtube.com/embed/HYb9xZ7Lxe0)

The SSL Monitor extension allows you to check information about SSL certificates for your HTTPS child sites. The table on the **Dashboard** page of the SSL Monitor extension gives you insight into the most important information, such as the expiration date, who the issuer is, and the common name.

![Screenshot of SSL Monitor dashboard showing certificate expiration dates, issuers, and common names](https://mintcdn.com/mainwp/4f1gyeWHSqPS10n_/images/add-ons/ssl-monitor-settings.png?fit=max\&auto=format\&n=4f1gyeWHSqPS10n_\&q=85\&s=c955d72daea42199125b5ea9b9d428db)

The extension also provides all the detailed information about the SSL certificates that you may need.

## Browse Certificate Status

On **MainWP > Add-ons > Monitoring > SSL Monitor > Dashboard**, search by site name or URL, sort supported column headings, and use the page and page-size controls to browse your sites. Results load as you change the table controls; wait for the loading indicator to finish before selecting rows or starting a check.

The **SSL Monitor** widget on the main **Overview** page also supports search, sorting, and paging. Click **SSL Monitor Dashboard** in its footer to open the full table. An individual site's **Overview** widget shows its saved certificate details and links to that site's SSL Monitor page.

`N/A` or **Not checked** indicates that certificate data is unavailable or has not been collected. Run **Check SSL Certificate** for the site and review any reported error before relying on its expiration information. The table and widgets show saved results; browsing them does not perform a new certificate check.

## Install the SSL Monitor extension

**1. Go to your MainWP Dashboard**

**2. Go to the MainWP > Add-ons > Manage Add-ons page**

**3. Click the Install Add-ons button**

Click the **Install Add-ons** button ![Screenshot highlighting the Install Add-ons button on the Add-ons page](https://mintcdn.com/mainwp/9Fi7dKBCIriTb92d/images/add-ons/2833252556cc.png?fit=max\&auto=format\&n=9Fi7dKBCIriTb92d\&q=85\&s=a8cef4a17468ae3d301a5c1e41e3fa6d)

**4. Locate the SSL Monitor extension and select it**

**5. Click the Install button**

**6. Once the installation process is complete, click the Activate Add-ons button.**

Once the installation process is complete, click the **Activate Add-ons** button. ![Screenshot showing the Activate Add-ons button after SSL Monitor installation](https://mintcdn.com/mainwp/PMb515K3nlj7x2jI/images/add-ons/578da5c7dc89.png?fit=max\&auto=format\&n=PMb515K3nlj7x2jI\&q=85\&s=c381ceab5b9dff6da69a292b5ac0045c)

## Check SSL Certificates

### For all Sites

**1. Go to the MainWP > Add-ons > Monitoring > SSL Monitor > Dashboard page.**

**2. Click the Check SSL Certificate on All Sites button in the top right**

![Screenshot showing Check SSL Certificate on All Sites button](https://mintcdn.com/mainwp/2rlXQ4CNzTqDCqtT/images/add-ons/34e0cb37356d.png?fit=max\&auto=format\&n=2rlXQ4CNzTqDCqtT\&q=85\&s=a297aebff346972e7574cbd43eff9132)

### For individual Sites

**1. Go to the MainWP > Add-ons > Monitoring > SSL Monitor > Dashboard page.**

**2. Locate the desired site in the table.**

**3. Click the Check SSL Certificate action in the ellipsis menu.**

![Animated screenshot showing Check SSL Certificate action in ellipsis menu](https://mintcdn.com/mainwp/4f1gyeWHSqPS10n_/images/add-ons/ssl-monitor-overview.gif?s=9ccfd11162dd277ddf3ead6cda1a2b04)

## View Detailed Certificate Information

**1. Go to the MainWP > Add-ons > Monitoring > SSL Monitor > Dashboard page.**

**2. Locate the desired site in the table**

**3. Click the SSL Certificate Info action in the ellipsis menu.**

![Animated screenshot showing SSL Certificate Info action and detailed certificate view](https://mintcdn.com/mainwp/9Fi7dKBCIriTb92d/images/add-ons/0906be47c99b.gif?s=6bba7ef407150d6be0425291be5640dc)

## Adjust the SSL Monitor Settings

![Screenshot of SSL Monitor settings page with notification threshold and automated check options](https://mintcdn.com/mainwp/4f1gyeWHSqPS10n_/images/add-ons/ssl-monitor-settings.png?fit=max\&auto=format\&n=4f1gyeWHSqPS10n_\&q=85\&s=c955d72daea42199125b5ea9b9d428db)

**1. Go to the MainWP > Add-ons > Monitoring > SSL Monitor > Settings page.**

Go to the **MainWP > Add-ons > Monitoring > SSL Monitor > Settings** page.

1. **Notifications threshold (days):** you will be notified by email if an SSL Certificate for any monitored site reaches the threshold you define here.
2. **Automated Checks:** you can enable automatic SSL certificate checks and set the frequency for those checks

**2. After you've adjusted the settings, click the Save Settings button**

## Automatic Inclusion of New Sites

SSL Monitor 5.3 automatically adds a monitoring record when you connect a new HTTPS site to MainWP Dashboard. It does not perform a certificate lookup during site connection. With **Automated Checks** enabled, the scheduler performs the first check and subsequent checks at the configured frequency.

Automatic checks apply only to sites whose saved URL starts with `https://`. HTTP sites are excluded. Existing individual overrides remain in effect, including sites where automated checks are disabled.

## Adjust the SSL Monitor settings on a Single Site

![Animated screenshot showing how to overwrite general SSL Monitor settings for a single site](https://mintcdn.com/mainwp/2rlXQ4CNzTqDCqtT/images/add-ons/4f9770763ce7.gif?s=c8938182ca1a39a13320efdb93f39c3a)

**1. Login to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Manage Sites page**

**3. Locate the Child site, open its Dashboard, and go to SSL Monitor > Settings page**

Locate the Child site, open its Dashboard, and go to **SSL Monitor > Settings** page

1. Overwrite the general settings by enabling the **Overwrite general settings** toggle
2. Adjust the Notifications threshold (days) and whether you want to automatically check SSL certificates for this specific site

**4. Click the Save Settings button**

## Check Sites via WP CLI

If you prefer running SSL checks from the command line, or want to trigger them from a script or cron job outside of the MainWP Dashboard's built-in scheduler, use the WP-CLI commands the extension registers under `wp mainwp-ssl-monitor`.

Both commands accept either a comma-separated list of child site IDs or the `--all` flag to target every child site.

Check the SSL certificate for one or more sites:

```bash theme={null}
wp mainwp-ssl-monitor check 2
wp mainwp-ssl-monitor check 2,5
```

Check all sites:

```bash theme={null}
wp mainwp-ssl-monitor check --all
```

View saved SSL certificate information for one or more sites without triggering a new check:

```bash theme={null}
wp mainwp-ssl-monitor info 2
wp mainwp-ssl-monitor info 2,5
wp mainwp-ssl-monitor info --all
```

## SSL Monitor Abilities API

SSL Monitor registers three read-only MainWP abilities in the `mainwp-ssl-monitor` category. Use them to list stored certificate summaries for your monitored HTTPS sites, read one site's certificate details and automatic check times, and read a site's effective notification threshold and check schedule. These abilities return stored data only. They do not run certificate checks.

The abilities require WordPress 6.9 or later on the MainWP Dashboard site, MainWP Dashboard with Abilities API support, and an SSL Monitor release with Abilities support. The user needs `manage_options`, access to the SSL Monitor Add-on, and access to each site.

See [SSL Monitor Abilities](https://docs.mainwp.com/api-reference/abilities-api/ssl-monitor.md) for request examples, response fields, status values, and error handling.

## SSL Monitor REST API

All MainWP REST API calls, including full documentation and examples, are publicly available on [Postman](https://www.postman.com/mainwp/workspace/mainwp/overview). For more details about enabling the MainWP REST API and managing keys, see [REST API Overview](https://docs.mainwp.com/api-reference/rest-api/overview.md).

***

## Related Resources

* [Database Health Check](https://docs.mainwp.com/dashboard/overview/mainwp-database-health-check.md) - Check the Add-on's Dashboard database table and column definitions
* [Monitoring Add-ons](https://docs.mainwp.com/add-ons/monitoring.md) - Browse all monitoring tools
* [Domain Monitor](https://docs.mainwp.com/add-ons/monitoring/mainwp-domain-monitor-extension.md) - Track domain expiration
* [Advanced Uptime Monitor](https://docs.mainwp.com/add-ons/monitoring/advanced-uptime-monitor-extension.md) - Monitor site uptime
* [SSL Monitor Abilities](https://docs.mainwp.com/api-reference/abilities-api/ssl-monitor.md) - Read stored certificate status and monitoring settings


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