← Back to docs

Web Search Alert run dashboard

Web Search Alert run dashboard

Each Web Search Alert has a dedicated run/result dashboard. A manual Run now action opens this dashboard instead of returning only to the alert editor.

The dashboard keeps the Alert's verified result table, run history and delivery state together. Opening a historical run filters the result table to rows first discovered in that exact run.

Source exclusions

The alert dashboard includes a simple Exclude results control. Enter a domain or URI without requiring http:// or https://, then choose one matching mode:

  • Domain / zone matches the exact DNS zone and its subdomains. x.com matches x.com and news.x.com, but not krax.com.
  • Exact URI matches the exact host, path and query while ignoring the HTTP/HTTPS scheme.

Rules are added and removed with AJAX. Existing matching results are immediately moved out of the main verified-results list and into the separate Excluded results list. Removing a rule restores results that are not still covered by another exclusion rule. Newly stored results are classified against the same rules before notifications are built, so excluded new rows remain available for inspection without being included in new-result delivery payloads.

Result sorting

Verified results are sorted by Published with the newest published item first by default. Results without a known publication timestamp are placed after dated results.

The Published, Discovered, Title, Source and Relevance column headings are sortable. Selecting the active heading toggles ascending and descending order. The selected run and pagination context stay intact while changing result sorting. The administrator run view follows the same result-sorting behavior.

Live progress

While the latest run is active, the dashboard polls a read-only progress endpoint. The displayed stages are based on the Alert Engine's real queue, run and audit state:

  • Queued
  • Starting
  • Searching the web
  • Checking search results
  • Saving verified results
  • Publishing notifications
  • Completed or Failed

The progress display is milestone-based rather than an invented time estimate. Reading progress never starts or retries the provider search. Before an Alert run row exists, the queued state comes from the recorded queue event. Once the worker starts, the real run state and run-specific audit milestones take precedence.

When the run finishes, the dashboard switches to that exact run so its result table and delivery state are immediately visible.

Notification links

A positive Web Search Alert Tools notification links directly to the exact alert and run that produced the new verified results. The administrator Notifications inbox uses an administrator-only run route, while the owner-facing shared notification uses the owner-scoped run dashboard.

Run and result access remains owner-scoped. A signed-in user cannot open another user's Alert or run by changing ids in the URL.

For creation, scheduling, filtering, email/SMS behavior and the API, see the main Web Search Alerts documentation.