> ## Documentation Index
> Fetch the complete documentation index at: https://developers.perform.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delivery Experience Ratings

> Collect star ratings, reasons and comments from shoppers on the Tracking Page and monitor them per Tracking Page in a 14-day dashboard.

**Available to Post-Purchase customers with ratings enabled.** The ratings menu is only visible when the feature is enabled for your account.

## Summary

Delivery Experience Ratings let shoppers rate their delivery on the Tracking Page, pick a reason category and leave a comment. The ratings dashboard shows the average rating, its trend, the most selected categories and the share of shipments rated, per Tracking Page and for the last 14 days.

## Who it’s for

Customer experience and logistics teams that want to hear about a bad delivery from the shopper before it becomes a complaint, and to compare delivery satisfaction across carriers, markets and Tracking Pages.

## Key benefits

* **Feedback at the moment of delivery.** The rating prompt sits on the Tracking Page, and delivery feedback notifications can invite the shopper 2, 12 or 24 hours after delivery.
* **Reasons, not only stars.** Shoppers choose from categories you configure per Tracking Page, so the dashboard shows what went wrong, not only how often.
* **Trends per Tracking Page.** Each Tracking Page reports its own average, number of ratings and change against the previous 14 days.
* **Ratings sit on the shipment.** Score, reason, timestamp and comment appear in the shipment’s parcel details, and Shipment Overview can be filtered by rating and rating category.
* **Act on a rating.** Notifications can tell your team when a new rating arrives, and each comment links to the rated shipment.

## How it works

### The dashboard

The dashboard covers the last 14 days and refreshes when you open or reload the page.

| Section | What it shows |
| - | - |
| Average rating | The average score, a breakdown by number of stars, and the change against the previous 14 days |
| Average rating trend | The average per day; hovering a point shows the date, the average and the number of ratings that day |
| Top 10 categories | The most selected rating categories and how often each was chosen |
| Rating engagement | The number of ratings submitted and the share of shipments that received a rating |
| Useful links | Shortcuts to Shipment Overview, to see rated shipments, and to Notifications, to be told when a rating arrives |

### Per Tracking Page

The Tracking Page overview lists every active Tracking Page with ratings enabled, with its language, the number of ratings in the last 14 days, the average rating and the change against the previous 14 days. You can search by Tracking Page name. Selecting a Tracking Page opens a side panel with its average rating, every configured category with its count, and the 25 most recent comments in chronological order. Selecting a tracking ID in a comment opens the shipment’s parcel details.

### Ratings on the shipment

A shipment’s parcel details show the rating score, the reason category, the timestamp and the comment. In Shipment Overview you can filter and add columns for **Rating** and **Rating categories**, and export the result.

### Asking for a rating

The delivery feedback triggers in Delivery Notifications send a message 2, 12 or 24 hours after a shipment is delivered or collected, inviting the shopper to rate the delivery on the Tracking Page. Rating categories are configured per Tracking Page through your account team.

## Set up in the portal

Go to **Post-Purchase** > **Rate**.

1. Read the dashboard for the last 14 days and select a Tracking Page in the overview to open its categories and recent comments.
2. To change the rating categories or the prompt on a Tracking Page, contact your account team with the Tracking Page name.
3. To be told about new ratings, create a notification in **Post-Purchase** > **Notifications** with a delivery feedback trigger for shoppers, or ask your account team about rating triggers for your team.
4. To analyse ratings beyond 14 days, use **Reports & Analysis** or filter Shipment Overview by rating and export.

## Use via API and MCP

* The rating is part of the shipment: the MCP tool `get_shipment_details` returns it as an extra detail. See [MCP tools](https://developers.perform.ai/mcp/tools.md).

## FAQ

### Where do shoppers rate the delivery?

On the Tracking Page, after the shipment is delivered or collected. A delivery feedback notification can bring them there.

### Can I see ratings for more than 14 days?

The dashboard shows the last 14 days. For a longer range, filter Shipment Overview by rating and export, or use **Reports & Analysis**.

### Can I change the rating categories?

Yes, per Tracking Page, through your account team.

### Why is the ratings menu missing?

Ratings are enabled per account. Ask your account team to enable the feature.

### Can I be notified when a shipment gets a low rating?

Notifications can be sent when a rating arrives. Ask your account team which rating triggers are available for your account.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| No ratings arrive | Ratings are not enabled on the Tracking Page, or shoppers are not invited to rate | Enable ratings for the Tracking Page and set up a delivery feedback notification. |
| A Tracking Page is missing from the overview | Ratings are not enabled for it, or it is inactive | Ask your account team to enable ratings for that Tracking Page. |
| Engagement looks low | Few shoppers return to the Tracking Page after delivery | Add a delivery feedback trigger 2 to 24 hours after delivery. |
| Comments older than the 25 most recent are not shown | The side panel is limited to 25 comments | Filter Shipment Overview by rating and export the comments. |

## Related

* [Tracking Page](https://developers.perform.ai/products/post-purchase/tracking-page.md)
* [Delivery Notifications](https://developers.perform.ai/products/post-purchase/delivery-notifications.md)
* [Shipment Overview](https://developers.perform.ai/products/post-purchase/shipment-overview.md)
* [Post-Purchase overview](https://developers.perform.ai/products/post-purchase/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.