What it means
A customer has licences but cannot complete the core workflow because a data integration keeps failing. Customer success adoption blocker resolution lag measures how long it takes to remove a verified obstacle to the agreed use of a product.
Define an adoption blocker as an issue that stops or materially limits a named customer role from completing a relevant workflow, since general dislike of a feature is not automatically a blocker. Gainsight distinguishes deployment, depth and breadth of adoption and describes different tactics when usage changes, so first identify whether the obstacle is access, training, process or product behaviour.
HubSpot's onboarding guidance discusses challenges that can interrupt the path to using a product, and a clear customer outcome keeps the team focused on the obstacle that actually matters. Start the clock when the qualifying problem is first reliably reported or observed, not when a specialist later creates a ticket.
Define resolution as a verified ability to complete the agreed workflow, or an accepted alternative route, because a code deployment alone may not restore use, and preserve a clear record of the user task tested at closure. If a workaround is temporary, label the issue mitigated rather than permanently resolved and track the durable fix separately.
For training gaps, verify that the intended users can perform the task after training, since attendance does not prove the obstacle is gone. For access failures, check permissions with the right customer contact and do not request or share passwords in ordinary project notes.
If the customer must supply data or approvals, record that dependency and a next owner action, and avoid assigning blame based on an incomplete record. When the product cannot support the promised workflow, escalate scope or expectation correction rather than changing the customer goal silently, and remember that an escalation owner cannot unilaterally alter commercial terms such as promised credits or contract changes without separate approval.
Separate individual blockers from a broader incident, since an outage may affect many accounts and should follow the incident process as well. For a multi-stage project, define which milestone is blocked, because a feature that is not yet in the rollout may not be an immediate adoption blocker.
If several root causes combine, keep one customer-facing blocker record and linked technical work, since restarting the timer for each handoff hides the delay, and choose calendar time or working time explicitly to match the impact and any relevant service commitment. Report time to first workable route and time to permanent resolution separately where the difference matters, and for a customer who stops responding after a proposed fix, state verification pending instead of closing the blocker as resolved by assumption.
If the customer declines a workaround, do not count it as accepted; understand the reason and revisit the proposed path. Segment by severity, customer role and cause, keep long-open blockers visible alongside the completed-case distribution, audit selected cases from first signal through escalation, attempted fixes, customer test and final status, and pair lag with adoption recovery, since closing a blocker and seeing no change in the intended workflow may point to another obstacle.
In practice
Real-world examples.
Example
A broken integration blocks daily reporting from Monday to Thursday, when the customer successfully tests the fix. The lag is three days, measured to the customer's test and not to the code deployment. The user task tested is recorded in the case.
Example
A workaround allows temporary reporting by manual export, but the underlying problem remains open. Mitigation and final resolution are reported separately. The customer success manager schedules a check on the durable fix.
Example
A training session is held for a finance team, but users still cannot complete the approval step. The blocker is not verified resolved because attendance does not prove the users can do the task. The team adds a supervised practice session and tests again.
Formula
Calculation
Resolution lag = Verified workable-use timestamp - First reliable qualifying-blocker timestamp
Worked example. A broken integration blocks daily reporting from the first reliable report on Monday at 09:00. A fix is deployed on Wednesday, but the customer only completes a successful test on Thursday at 09:00.
- Resolution lag = Monday 09:00 to Thursday 09:00 = 3 days, not the 2 days to deployment.
- If a temporary export workaround was accepted on Tuesday at 09:00, time to first workable route = 1 day and time to permanent resolution = 3 days, reported separately.
Cohort example. An invented vendor resolves 10 blockers in a quarter with lags of 1, 2, 2, 3, 3, 4, 5, 6, 8 and 16 days, and two blockers remain open at 21 and 30 days.
- Median of completed blockers = (3 + 4) / 2 = 3.5 days.
- Completed-only average = (1 + 2 + 2 + 3 + 3 + 4 + 5 + 6 + 8 + 16) / 10 = 50 / 10 = 5 days.
- The two open blockers are older than any completed case and must be shown beside these figures.Case study
Seen in the real world.
This fictional case follows Oak Harbor Systems. The customer's analysts could log in but an incorrect role stopped export approvals. The team corrected access, watched an analyst complete an approved export and then closed the blocker; a prior permission-change attempt was not counted as resolution. Earlier in the quarter, the vendor had closed similar tickets as soon as a configuration change was made, and some customers returned a week later still unable to complete the workflow.
By requiring a customer test before closure, the team found that two further roles had the same permission fault. The team also began reporting long-open blockers beside the closed-case distribution, so the hardest cases stayed visible. The case is invented.
Watch out
Common mistakes.
- Starting the clock when a technical ticket is created after the customer reported the issue.
- Calling a code deployment a verified customer fix.
- Hiding unsolved blockers by reporting only closed cases.
Questions
People also ask.
Can a workaround resolve the blocker?
Count it as mitigation or resolution only under a clear, accepted definition.
Is a drop in usage itself a blocker?
No. Investigate the cause and identify the obstructed workflow.
What if the customer has not tested the fix?
Mark verification pending and track the next step.
From the founder's library

Take it further with the book.
Build your financial confidence beyond this definition. Shihan's full-length guide, Accounting Fundamentals, takes the same plain-English approach and turns it into a complete, practical playbook for non-finance managers, business owners and students - with chapter-end quiz answers and presentation slides included.
25% off with code MMHQ25, applied at checkout. Priced in USD - checkout may show the equivalent in your local currency.
View the book and save 25%Related
