Skip to main content

​
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: If the add-on cannot retrieve your domain information automatically, you can enter it manually as described below.

​
Install and Set Domain Monitor Extension

1

Go to your MainWP Dashboard

2

Go to Add-ons > Manage Add-ons

3

Click the Install Add-ons button

Click the Install Add-ons button
4

Locate the Domain 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 Activate Add-ons button after installation
7

After successful installation, proceed to the add-on settings

8

Set your preferences, Save Settings, and you are ready to audit your sites.

​
Check Domains

1

Go to Add-ons > Monitoring > Domain Monitor > Dashboard

2

Locate the Check All Sites Domains button

Locate the Check All Sites Domains button
3

Click it, and wait until the add-on completes the process.

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. Screenshot showing Manual Domain information entry toggle in settings
1

Go to Add-ons > Monitoring > Domain Monitor > Dashboard

2

Choose Domain Info from the site's Actions menu

3

Open the Settings tab

4

Toggle on the Manual Domain information entry option and click Save Settings

Toggle on the Manual Domain information entry option and click Save Settings
5

Open the Edit Domain Info tab

6

Enter or change the desired information, and click Save Settings

​
See Domain Info

1

Go to Add-ons > Monitoring > Domain Monitor > Dashboard

2

Locate the site or domain and choose Domain Info from the Actions menu

Locate the site/domain you want to check in the list and use the Domain Info action from the Actions menu.Screenshot of Domain Info action in site Actions menu
3

Once redirected to the report page, you can review all details

​
Schedule Automated Checks

1

Go to Add-ons > Monitoring > Domain Monitor > Settings

2

Locate the Automatically check domains option and enable it

3

Locate the Automated domain checks frequency option and set how often you want checks to run

Choose Once a Day, Once a Week, Twice a Month, or Once Monthly.
4

Click Save Settings

​
Domain Monitor Settings

Screenshot of Domain Monitor settings showing notification threshold and automated check options
  • 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:
1

Go to Add-ons > Monitoring > Domain Monitor > Dashboard

2

Choose Domain Info from the site's Actions menu

3

Open the Settings tab

4

Enable the Overwrite general settings option

Once enabled, the Notifications threshold, Automatically check domains, and Automated domain checks frequency options appear for this site only.
5

Set your preferences and click Save Settings

The same tab also contains the Manual domain information entry toggle described above.

​
Check Sites via WP CLI

Check one or more sites:
Check all sites:
View saved domain profiles for one or more sites:

​
Domain Monitor REST API

MainWP REST API calls, including Domain Monitor endpoints, full documentation, and examples, are available in the MainWP Postman workspace. Refer to our REST API documentation 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.