Product Messages
Product messages are contextual alerts generated by product bricks during pricing calculations. They inform operators and customers about important conditions, constraints, or requirements related to a transport booking.
Overview
When a product is calculated for a transport request, the underlying product bricks can emit messages to communicate relevant information. These messages appear as colour-coded alerts throughout the booking flow and on order details, giving users immediate visibility into conditions that affect their transport.
Key highlights:
Severity-based — Each message carries a severity level (
info,warning, orerror) that determines its visual treatmentMultilingual — Messages are displayed in the user's selected language
Non-blocking — Messages inform users without preventing the booking from proceeding
Persistent — Messages are preserved on the
Orderand remain visible after booking
Severity Levels
Each product message has one of three severity levels, displayed with a corresponding colour:
Level | Colour | Purpose |
|---|---|---|
| Blue | General information about the offer or transport conditions |
| Yellow | Conditions that may affect the transport but do not prevent booking |
| Red | Critical issues the user should be aware of |
When multiple messages are present, a badge displays the total count and uses the colour of the highest severity message. Hovering over or tapping the badge reveals the full list of messages.
Where Product Messages Appear
Orbit MissionControl
In Orbit MissionControl, product messages appear in two locations:
Product cards in the TransportComposer — When creating or editing a transport, each product card displays a message indicator next to the product name. The indicator shows the number of messages and is coloured according to the highest severity. Hover over the indicator to see the full message list.
Order details — On the order details page, product messages are shown in the pricing section alongside the product name and version. A badge indicates how many messages exist, and hovering reveals the details.
Orbit Hub
In Orbit Hub, product messages appear in two locations:
Booking overview — During the booking process, messages for the selected offer are displayed on the booking confirmation step, helping customers review any conditions before placing the
Order.Order details — After booking, the order details header displays a severity-coloured badge with the message count. Interacting with the badge reveals the full message list.
How Product Messages Are Generated
Product messages are defined within context bricks and feasibility bricks as part of the product configuration. When a product is calculated for a transport, these bricks can include messages in their output to communicate conditions such as route constraints, load limitations, or scheduling notes.
Messages from all bricks of a product are automatically collected, deduplicated, and sorted by severity (errors first, then warnings, then informational messages). For details on configuring bricks to return messages, refer to the Products documentation.
Example
Julia at Orion Industries in London books a next-day delivery through Orbit Hub. During the booking process, she sees a blue info badge on her selected product. Hovering over it reveals the message: "Route includes channel crossing via ferry, transit time may vary." After placing the Order, the same message remains visible on her order details page. Meanwhile, Mohammad, an operator at the logistics company in Berlin, sees the same message on the Order in Orbit MissionControl, along with a yellow warning: "Approaching maximum load weight for this vehicle class." These messages help both parties understand the conditions of the transport without interrupting the booking flow.
FAQ
Can product messages prevent a booking from being placed?
No. Product messages are informational only. To prevent a booking, the product's feasibility bricks must return the transport as not feasible. Messages communicate context but do not block the process.
Do product messages appear in Orbit Cockpit?
Product messages are displayed in Orbit MissionControl and Orbit Hub. They are not shown in Orbit Cockpit.
Can a product have no messages?
Yes. Messages are optional. If no brick returns messages, no badge or indicator is shown.
Are messages visible after the order is placed?
Yes. Messages are stored on the Order and remain visible on the order details page in both Orbit MissionControl and Orbit Hub.
What happens if the same message is returned by multiple bricks?
Duplicate messages with identical content are automatically removed. Each unique message appears only once.