Manage shipment status reason codes

Updated May 31, 20261 min read

Use shipment status reason codes to record specific reasons for status changes, for example, a cancellation or a failed delivery attempt. They also support internal reporting. Reason codes are optional.

Each reason code links to a list of allowed statuses that defines when you can apply it. For example, a reason code linked to the Cancelled status is available when you update a shipment to that status.

Carriyo has two types of reason codes:

  • Native reason codes, built into Carriyo, set up by default, and cannot be edited or deleted.
  • User defined reason codes, created by Admin users and fully customizable.

Creating a reason code

1. Navigate to Settings > Administration > Reason Codes on the Carriyo Dashboard. The Type column distinguishes native from user-defined reason codes. Click the add button in the top-right corner to create a new reason code.

2. The Add Reason Code dialog opens. The Allowed Statuses field sets which shipment statuses this reason code applies to.

Carriyo creates every new reason code with type User Defined. This cannot be changed.

3. Click Save when done.

Reason codes appear as an option when you update a shipment to a linked status.

After the shipment is updated, the reason code appears in the Reason column.

Editing or deleting a reason code

Edit and delete actions are only available for user-defined reason codes.

1. Click the three-dot menu to edit or delete. You can also click the reason code name directly to edit it.

2. Click Save when done.

Concepts behind this