Search Alerts Reference

This document is a reference for the Search Alerts screen of the ADP Car Market Hub plugin (Car Market Hub → Search Alerts). It explains the alert profile model, how the table works, and how to create, edit, pause and delete subscriptions.

When to use this document

Use this reference when you want to manage automated email alerts that notify subscribers when new vehicles match their saved search criteria, or when you want to import / export an alerts list.

Overview

A Search Alert (also called an Alert Profile) is a saved combination of:

• A Recipient Email.
• A set of Filter Criteria (make, model, body type, fuel type, condition, color, price range, max mileage).
• A Notification Frequency (Immediate, Daily, Weekly).
• A Status (Active, Pending Confirmation, Paused, Unsubscribed).

When new vehicles match an active alert's criteria, the plugin sends an email to the subscriber according to the chosen frequency. The screen lists every configured alert with bulk actions, search/status filters, CSV export, and a modal-based create/edit form.

Requirements or prerequisites

• Permission to manage the plugin.
• Working WordPress mail. The plugin uses standard WordPress email; configure SMTP separately if your site cannot send mail.
• Imported vehicles for the alerts to match against.

Step by step instructions

Create an alert profile

1. Open Car Market Hub → Search Alerts.
2. Click Create Alert Profile in the header.
3. In the modal, fill in: - Alert Name (optional, used as a friendly label in the table). - Recipient Email (required). - Notification Frequency (Immediate / Daily / Weekly). - Status — you can set the alert's status directly here (it defaults to Active).
4. Add any Filter Criteria values. Leave a field empty to match all values for that criterion.
5. Click Create Alert Profile. The new alert appears in the table with the status you selected (Active by default).

Edit an existing alert

1. In the table, click the Edit action on the row.
2. The modal opens prefilled with the alert's current values; change anything — including the Status — and click Save Changes.

Pause, activate or delete

1. To pause or re-activate a single alert, click the Pause / Activate icon on the row.
2. To delete a single alert, click the Delete (trash) icon and confirm.
3. To act on several alerts at once, tick the rows, choose Activate selected, Pause selected or Delete selected in the bulk action dropdown, then click Apply.

Search, filter and export

1. Use the search field to filter by alert name, email or criteria.
2. Use the status filter to narrow to Active, Pending Confirmation, Paused or Unsubscribed.
3. Click Export CSV to download all alerts matching the current search and filter.
4. Click Clear to reset the search and status filter.
5. Use the per-page selector to change how many alerts are shown at once. The chosen value is saved as a per-user preference, so it persists for your account across visits.

Rows without an explicit Alert Name display a derived name with an auto-generated name tag, so you can tell at a glance which alerts were never given a custom label. Rows with no filter criteria show an All vehicles label, indicating the alert matches the entire inventory.

Configuration reference

Alert profile

Filter criteria fields (modal)

Status values

Table toolbar

Operational notes

• The notification frequency only affects when emails are sent; it does not change which vehicles match the criteria.
• Alerts in Pending Confirmation or Unsubscribed state never send emails until they become Active.
• Subscribers can typically opt out via a link in the notification email; doing so moves the alert to Unsubscribed status. Verify behavior in the current plugin version before publishing.
• The alert matching engine respects published vehicles in the inventory. Hidden, unpublished or deleted vehicles are not considered matches.
• Deletion is permanent and cannot be undone — the confirm dialog states this explicitly. Use Pause if you only want to suspend an alert temporarily.
• All admin actions on alerts are logged through the standard plugin logging surface; see Logs Reference for details.

Troubleshooting

• Subscribers are not receiving emails. Confirm the alert's status is Active, that WordPress can send mail, and that the recipient address is correct. For Immediate alerts, also confirm new vehicles have actually been imported recently.
• An alert never matches. Filter criteria are combined with AND. Try removing fields one at a time to find the criterion that excludes everything.
• A subscriber complains about too many emails. Lower the frequency from Immediate to Daily or Weekly, or pause the alert until the criteria are refined.
• Bulk action does nothing. Select at least one row before clicking Apply; the screen will warn you otherwise.
• CSV export is missing alerts. The export respects the current search and status filter — clear them to export everything.
• Delete confirm is skipped or fails silently. Ensure JavaScript is enabled in your browser. The destructive action requires confirming the modal/dialog.

Related documents

• Leads Reference
• Settings Reference
• Analytics Reference
• Logs Reference