Retrieving blueprint status in Zoho CRM lets you see exactly which stage a record occupies within a defined process flow, and how transitions are progressing across your team. This guide walks you through the key methods — from reading status on a record detail page to pulling usage reports and building a criteria viewer.
Why this matters
Blueprint in Zoho CRM models your business process as a series of States (stages) and Transitions (the actions that move a record between stages). [4] When a deal, lead, or custom-module record is inside a Blueprint, knowing its current state tells you whether the process is on track or stalled. Managers need this visibility to spot bottlenecks — for example, discovering that deals are stuck in an approval step for an average of 48 hours — and to take corrective action. [2] Without a reliable way to check Blueprint status, those blind spots remain invisible.
---
Step-by-step
Step 1. Confirm your edition supports Blueprint.
Blueprint is available from the Professional edition of Zoho CRM onwards; the Ultimate plan provides the largest number of Blueprints and the fullest feature set. [1][3] Before troubleshooting status visibility, verify your subscription tier inside Setup → Subscription.
Step 2. Open the record and read its current State.
Navigate to the module where your Blueprint is active (Leads, Deals, Quotes, Sales Orders, or a custom module). [2] Open any individual record. The Blueprint panel appears on the record detail page, showing the current State the record occupies and the available Transition buttons the assigned user can click to advance it. [4] The State label maps directly to the picklist value of the field you chose when designing the Blueprint. [1]
Step 3. Check which Transitions are available (and why some are blocked).
Each Transition button visible on the record represents a permitted move from the current State. If a Transition is not shown or is greyed out, it means the record does not yet satisfy the criteria configured for that Transition. [6] To understand nested AND/OR blocking conditions without leaving the record, you can build a Blueprint Criteria Viewer using the Zoho CRM REST API source inside Queries — this surfaces exactly which conditions are preventing a Transition from appearing. [6]
Step 4. Use Blueprint Usage Reports for a portfolio-level status view.
For a bird's-eye view across all records in a process, go to Reports and open the Blueprint reports section. Two report types are available: built-in reports and customised reports. [1] The built-in reports include:
- Duration Analysis — shows the average time a record spends moving between States, highlighting which stage consumes the most time. [2]
- Blueprint Usage — provides detailed information about how your organisation is using each Blueprint across records. [2]
- Bottleneck identification — surfaces stages where records are consistently delayed, giving you actionable data to redesign or delegate approval steps. [2]
Step 5. Leverage the mobile app for field-team status checks.
The Zoho CRM mobile application fully supports Blueprint. Sales staff working remotely can view the current State of a record, execute Transition steps, capture check-in photos, and enter required data — all from their phone, following the same process flow enforced on desktop. [3]
Step 6. For developers — query Blueprint state programmatically.
If you are building an integration or a custom module extension, Blueprint states and transitions can be defined and queried via the Zoho CRM REST API. The API allows you to model a state machine, embed validation rules in transitions, and trigger automated actions such as notifications or updates to related records. [7] Use the Zoho CRM REST API source in Queries to surface transition criteria directly on the record detail page without custom code overhead. [6]
---
Common pitfalls
- Record does not enter the Blueprint at all. Blueprint only applies to records that satisfy the configured Entry Criteria at the time of activation. Existing (older) records will not be enrolled unless you explicitly choose to apply the Blueprint to them when they match the entry conditions. [2]
- Transition buttons are missing. This usually means nested criteria are blocking the transition. Use the Blueprint Criteria Viewer approach (REST API Queries) to decode which AND/OR condition is unmet, rather than guessing inside the Blueprint editor. [6]
- Blueprint not available in your module. Blueprint can be applied to Leads, Deals, Quotes, Sales Orders, and custom modules — but it must be explicitly configured for each module separately. [2]
- Draft vs. published Blueprint. A Blueprint saved as a draft will not enrol any records. Records only begin entering a Blueprint once it is published. If you are seeing no status on records, confirm the Blueprint is in a published state, not still in draft. [1]
---
What to check
- Verify the record's current State label matches the expected stage in your process flow by opening the record detail page and reviewing the Blueprint panel. [4]
- Run a Blueprint Usage Report to confirm records are progressing through States at an acceptable pace and no single stage is creating a systemic bottleneck. [1][2]
- Confirm the Blueprint is published (not in draft) and that the record meets the Entry Criteria — both are required before any status information will appear on a record. [1][2]
---
*Beam Help is an independent expert support resource for Zoho products and is not official Zoho support. For platform-level issues, always verify with your Zoho account representative.*