Dashboard & Filters
The top of the Failed Messages page shows summary cards and a filter bar that help you quickly understand and navigate your failed messages.
Summary Cards
Four cards at the top give you an instant overview:
2. Capture the four summary cards at the top of the page
Save to:
static/img/screenshots/failed-messages/dashboard/summary-cards.png| Card | Color | What it shows |
|---|---|---|
| Total Failed | Gray | The total number of failed messages across all categories |
| Retryable | Green | Messages that can be retried — temporary issues that may resolve |
| Non-Retryable | Red | Messages that cannot be retried — permanent failures |
| Business Logic | Yellow | Messages that failed due to business rules being violated |
Use the summary cards to get a quick picture. If you see a high number of Retryable messages, it's a good time to run a bulk retry. If Non-Retryable keeps growing, you may have contact list issues to address.
Filter Bar
Below the summary cards, the filter bar lets you narrow down the message list. You can combine multiple filters to find exactly the messages you need.
2. Show the age filter tabs, error code dropdown, category dropdown, and retry status dropdown
Save to:
static/img/screenshots/failed-messages/dashboard/filter-bar.pngAge Filter
The age filter lets you focus on messages by how recently they failed. This is shown as a set of tabs:
| Tab | Time Range | Indicator | Description |
|---|---|---|---|
| Recent Failures | Less than 24 hours ago | Red | Messages that just failed — may still be waiting for the recommended retry window |
| Ready for Retry | 24 to 48 hours ago | Green | Messages that have waited long enough and are ready to be retried (selected by default) |
| Older Failures | More than 48 hours ago | Yellow | Older failures that haven't been resolved yet |
| Custom Date Range | You choose | — | Pick your own start and end dates |
2. Show the Ready for Retry tab selected by default with its green indicator
Save to:
static/img/screenshots/failed-messages/dashboard/age-filter-tabs.pngWhen you first open the Failed Messages page, the Ready for Retry tab is selected by default. These are the messages most likely to succeed if you retry them now.
When you select Custom Date Range, two date pickers appear so you can choose your own start and end dates.
2. Capture the date pickers that appear
Save to:
static/img/screenshots/failed-messages/dashboard/custom-date-range.pngError Code Filter
A dropdown that lets you filter messages by a specific error code. The dropdown is populated with the actual error codes found in your failed messages, so you only see codes that are relevant.
2. Capture the expanded dropdown showing the list of available error codes
Save to:
static/img/screenshots/failed-messages/dashboard/error-code-filter.pngError Category Filter
Filter by the type of error:
| Option | What it shows |
|---|---|
| All | All categories (default) |
| Retryable | Only messages with temporary, retryable errors |
| Non-Retryable | Only messages with permanent failures |
| Business Logic | Only messages that failed due to business rules |
Retry Status Filter
Filter by whether messages have been retried:
| Option | What it shows |
|---|---|
| All | All messages regardless of retry status (default) |
| Not Retried | Messages that haven't been retried yet |
| Retried | Messages that have been retried at least once |
Applying and Resetting Filters
After selecting your filters:
- Click Apply to update the message list with your selected filters
- Click Reset to clear all filters and return to the default view
2. Capture the Apply and Reset buttons
Save to:
static/img/screenshots/failed-messages/dashboard/apply-reset-buttons.pngYou can use multiple filters at the same time. For example, you could filter for Ready for Retry age + Retryable category + Not Retried status to find all messages that are eligible for a first retry.