Understanding readiness states and blocker cards
Practical guide for hotel operators reading readiness states, next-step cards, and blocker cards inside hotel-portal.
Overview
Readiness UI exists to answer one question:
"What still needs attention before this property can move forward?"
In hotel-portal, that usually appears as:
- progress cards
- next-step cards
- blocker cards
- status or readiness summaries
These cards are there to help operators decide what to do next without digging through every screen manually.
What a readiness state means
A readiness state is not just decoration. It reflects how structurally complete the property is.
Typical meanings:
Readymeans this part of setup is in acceptable shapeIn progressmeans the work has started but should not be treated as completeBlockedmeans an important gap still prevents the property from moving forward
The portal should make these meanings obvious to non-technical users.
What blocker cards are for
A blocker card should tell you:
- what is missing
- why it matters
- what screen or action should fix it
Good blocker cards reduce confusion. They should not feel like raw backend errors pasted into the UI.
Common blocker categories
In practice, blockers often come from:
- incomplete property profile
- missing room or rate structure
- incomplete inventory coverage
- missing PMS mapping
- failed readiness guard for go-live
The right response is usually to fix the underlying workflow lane, not to keep clicking forward.
How to use next-step cards
Treat next-step cards as the operator's shortest safe path.
If a next-step card points to:
- property
- rooms
- inventory
- PMS setup
that usually means the portal already knows which lane needs attention first.
What not to do
- Do not ignore blocker cards because the page looks almost complete.
- Do not assume a successful import means readiness is complete.
- Do not treat "in progress" as good enough for go-live.
Good Ask AI prompts
Ask AI can help interpret these cards:
- "What is blocking this property?"
- "What should I fix first here?"
- "Which screen should I open next?"
The AI should help explain the UI and route you to the right next action.