> ## Documentation Index
> Fetch the complete documentation index at: https://mainwp-mintlify-b537ecc3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Domain Monitor
> MainWP Domain Monitor Extension lets you keep a watchful eye on your domains. It alerts you via email when monitored domains are nearing expiration.
## What You'll Learn
* Checking domain expiration dates across all sites
* Reading expiration status in the dashboard and Overview widgets
* Entering domain info manually for unsupported TLDs
* Scheduling automated domain checks
* Overriding general settings for individual sites
* Using Pro Reports tokens for domain data
***
## Supported TLDs
**Integration Add-on** - This add-on connects MainWP Dashboard to domain registry data through RDAP and WHOIS. No third-party WordPress plugin is required.
**Domain lookup may fail or return incomplete data for some TLDs due to restrictions or a lack of available information from RDAP or WHOIS services.**
### TLD lookup support
Domain Monitor attempts lookups through RDAP first. If RDAP does not return usable domain data, the add-on falls back to its built-in WHOIS server map for TLDs with a configured WHOIS server.
For current TLD lookup references, use these maintained external sources:
* [IANA RDAP DNS bootstrap data](https://data.iana.org/rdap/dns.json) - Current RDAP service coverage by TLD.
* [IANA Root Zone Database](https://www.iana.org/domains/root/db) - Current TLD registry records, including WHOIS server details where available.
If the add-on cannot retrieve your domain information automatically, you can enter it manually as described [**below**](#enter-domain-info-manually).
## Install and Set Domain Monitor Extension
Once the installation process is complete, click the **Activate Add-ons** button
## Check Domains
Alternatively, you can use the **Bulk actions** menu to check selected sites, or use the **Check Domain** action from the site **Actions** menu to audit just one site.
### Unscanned Sites
Sites that have not been checked yet are highlighted in the Domain Monitor dashboard so you can spot them at a glance:
* The row is shaded yellow.
* The **Expires** column shows a **Not checked** button instead of remaining days. Click it to run a check for that site.
* Domain fields with no data display **N/A**.
* The **Domain Info** action is disabled until the first successful check completes.
Once a check completes, the row returns to its normal style and the remaining-days indicator (green, yellow, or red hourglass) appears based on how close the domain is to expiration.
### Expiration Status
Domain Monitor uses hourglass icons and short status messages to show how close each domain is to expiration:
* **Green hourglass** - The domain expires in 30 or more days.
* **Yellow hourglass** - The domain expires in fewer than 30 days.
* **Red hourglass** - The domain expires today or has already expired.
* **Grey hourglass** - No expiration data is available for the domain.
The Overview widgets pair the icons with a relative status message: **Expires in X days**, **Expires today**, **Expired today**, or **Expired X days ago**. Domains without expiration data show **Expiration information unavailable**.
## Overview Widgets
Domain Monitor adds widgets to your MainWP Dashboard Overview pages:
* The main **Overview** page widget lists all monitored domains with their expiration dates and status icons.
* The individual site **Overview** page widget shows the site's domain, its expiration status, and the saved domain profile. If no domain data is saved yet, the widget prompts you to recheck the domain or add the data manually.
## Enter Domain Info Manually
If your domain is not on the list of supported TLDs, you can add information manually by following the steps below.
Toggle on the **Manual Domain information entry** option and click **Save Settings**
## See Domain Info
Locate the site/domain you want to check in the list and use the **Domain Info** action from the **Actions** menu.
## Schedule Automated Checks
Choose **Once a Day**, **Once a Week**, **Twice a Month**, or **Once Monthly**.
## Domain Monitor Settings
* **Notifications threshold** - Set the threshold for notifications. If the domain expiration is less in the set number of days, an email will be sent.
* **Automatically check domains** - If you want the add-on to automatically run checks, enable this feature.
* **Automated domain checks frequency** - If automated checks are enabled, here you can set how often you want them to run.
Expiration notifications require a successful latest check and a valid expiration date. If the latest automatic lookup fails, Domain Monitor does not send an expiration alert based on previously saved data. Eligible failed lookups are normally retried after one hour, subject to the Dashboard's background job processing.
### Individual Site Settings
You can override the general settings for a specific child site:
Once enabled, the **Notifications threshold**, **Automatically check domains**, and **Automated domain checks frequency** options appear for this site only.
The same tab also contains the **Manual domain information entry** toggle described [**above**](#enter-domain-info-manually).
## Check Sites via WP CLI
Check one or more sites:
```bash theme={null}
wp mainwp-domain-monitor check 129
wp mainwp-domain-monitor check 129,130
```
Check all sites:
```bash theme={null}
wp mainwp-domain-monitor check --all
```
View saved domain profiles for one or more sites:
```bash theme={null}
wp mainwp-domain-monitor results 129
wp mainwp-domain-monitor results 129,130
wp mainwp-domain-monitor results --all
```
## Domain Monitor REST API
MainWP REST API calls, including Domain Monitor endpoints, full documentation, and examples, are available in the [MainWP Postman workspace](https://www.postman.com/mainwp/workspace/mainwp/overview). Refer to our [REST API documentation](/api-reference/rest-api/overview) for more details on enabling REST API and managing API keys.
## Available Reports Tokens
* `[domain.monitor.domain.name]` - Displays the domain name.
* `[domain.monitor.registrar]` - Displays the domain registrar.
* `[domain.monitor.updated.date]` - Displays the domain updated date.
* `[domain.monitor.creation.date]` - Displays the domain creation date.
* `[domain.monitor.expiry.date]` - Displays the domain expiry date.
* `[domain.monitor.expires]` - Displays the number of days left before the domain expires.
* `[domain.monitor.status]` - Displays the domain status.
* `[domain.monitor.last.check]` - Displays the last check timestamp.
***
## Related Resources
* [Monitoring Add-ons](/add-ons/monitoring) - Browse all monitoring tools
* [SSL Monitor](/add-ons/monitoring/mainwp-ssl-monitor-extension) - Monitor SSL certificates
* [Pro Reports Extension](/add-ons/agency/pro-reports-extension-overview) - Include domain data in reports
* **Notifications threshold** - Set the threshold for notifications. If the domain expiration is less in the set number of days, an email will be sent.
* **Automatically check domains** - If you want the add-on to automatically run checks, enable this feature.
* **Automated domain checks frequency** - If automated checks are enabled, here you can set how often you want them to run.
Expiration notifications require a successful latest check and a valid expiration date. If the latest automatic lookup fails, Domain Monitor does not send an expiration alert based on previously saved data. Eligible failed lookups are normally retried after one hour, subject to the Dashboard's background job processing.
### Individual Site Settings
You can override the general settings for a specific child site: