Guides are interactive in-product walkthroughs. Instead of asking your users to read a doc, watch a video, or open a support ticket, a Guide highlights the next element they need to click, explains what it does in one sentence, and advances as they actually use the product. By the end of a Guide, the user has completed the task, not just read about it. You manage Guides from Studio → Guides in your dashboard.Documentation Index
Fetch the complete documentation index at: https://docs.helpalive.com/llms.txt
Use this file to discover all available pages before exploring further.
Status today. The Guide runtime — the part that runs Guides in your users’ browsers — is shipped and battle-tested. The Studio Guide editor (record-mode authoring) is in active development. Until that lands, HelpAlive will author Guides for early-access customers on request.
What a Guide looks like
When a Guide runs, your user sees:- A spotlight that dims everything on the page except the element to focus on (a button, an input, a tab).
- A tooltip anchored to that element, with a short instruction — “Click here to invite a teammate” — and a step counter (“Step 2 of 5”).
- Automatic advancement — the moment the user clicks the highlighted element, the Guide moves to the next step. No “Next” button to click.
- Graceful exits — the user can dismiss at any time, jump back to a previous step, or restart from the beginning.
What you can do with Guides
Onboard new users
Walk every new signup through their first three meaningful actions — connect their first integration, invite a teammate, ship their first thing. Time-to-first-value drops because the product itself is showing them the way.
Surface underused features
A user just discovered a feature exists but doesn’t know how to use it. A Guide shows them the next two clicks, the difference becomes obvious, and they adopt it.
Walk through complex flows
Multi-step tasks (configuring a workflow, setting up a pipeline, mapping fields) are the hardest things to learn and the most expensive to support. A Guide turns “read the docs and try” into “click through and finish.”
Recover from errors
A user just rage-clicked or saw a DOM error. The Agent can launch a Guide that walks them through a working alternative — turning friction into completion instead of an abandoned session.
Announce new releases
Ship a feature, then ship a Guide that walks current users through what’s new. Announcements that respect the user’s time — they show up in the right place, at the right moment.
Plan-aware paths
Free users see Guides that lead to upgrade-worthy features. Pro users see Guides that go deeper into Pro-only flows. Same product, different paths — driven by
plan and role from your identify() call.Concrete examples
Example 1 — First-day onboarding
Your SaaS is a billing tool. A new admin signs up and lands on an empty dashboard.- Step 1. “Welcome — let’s set up your first invoice template.” Spotlight on the New Template button.
- Step 2. “Give it a name.” Spotlight on the name input.
- Step 3. “Pick which fields to include.” Spotlight on the field-selector menu.
- Step 4. “Save.” Spotlight on the Save button.
- Step 5. “You can now generate invoices from this template — try it on the dashboard.” No spotlight; finishing message.
Example 2 — Feature discovery
A pro-tier user has been on your product for two weeks but never used the workflow automation feature.- The Agent notices via session signals (lots of repeated clicks the automation would handle).
- It offers a Guide: “I see you do this every day — want me to show you how to automate it?”
- If accepted, the Guide walks them through creating their first workflow.
Example 3 — Error recovery
A user is configuring an integration and hits an error: “Invalid API key.”- The Agent reads the page context and recent events; sees the form submit failed.
- It opens with: “Looks like the key you entered isn’t valid yet. Want me to walk you through where to find the right one?”
- If accepted, a Guide walks them to the integration provider’s API key page (in a new tab if needed) and back to your form to paste it.
How Guides stay accurate as your product ships
A common problem with traditional onboarding tools: they break the moment your UI changes. A button moves, a class name gets renamed, and the walkthrough points at nothing. HelpAlive’s resolver matches elements by their meaning (role, label, position in the page hierarchy) rather than fragile selectors. A button labelled “Save” stays findable even if its CSS class changes. Reordering a sidebar doesn’t break a Guide that points at a tab. This is what lets you author a Guide once and trust it to work as you keep shipping. If something does ever break (rare), the failure is graceful: the Guide pauses with a recoverable state instead of crashing the page or leaving an orphan tooltip.Authoring Guides
The Studio Guide editor is in active development. Two ways to think about it:Record mode
Click through your product. HelpAlive captures the steps you took, the elements you interacted with, and the page transitions. Edit copy, polish step order, publish.
Manual mode
Define steps explicitly — page URL, element to highlight (identified by role + label), step copy, advance condition. For Guides that don’t need to be recorded.
- Tell us which flow you want a Guide for.
- We author it for you (typically within a business day for early-access customers).
- It appears in your Studio → Guides list, ready to publish.
How Guides integrate with the Agent
The Agent and Guides are designed to reinforce each other:- Agent identifies a goal → launches a Guide. During a chat, the Agent recognizes that the user wants to do a specific multi-step task. Instead of writing out the steps in text, it launches the matching Guide.
- Guide encounters a question → invites the Agent. Inside a Guide, if the user clicks “I’m stuck”, the Agent opens with full context — including which Guide step they were on.
- Agent learns from Guide outcomes. Every Guide step emits a lifecycle event (started, advanced, completed, abandoned). The Agent uses those signals over time to know which Guides actually help, for which users.
Targeting and rollout
Every Guide can be targeted to specific:- Workspaces. Roll out to one customer first, then expand.
- Roles. Admins see different Guides than viewers.
- Plans. Free-tier and enterprise customers see different paths.
- Pages. A Guide attached to
/billingonly triggers when users are on that page. - Behavior signals. Coming soon — trigger a Guide based on rage clicks, abandoned forms, or other real-time signals.
Measurement
Every step a user takes inside a Guide flows back into your analytics. From the Studio detail view of any Guide, you can see:- Completion rate — what percentage of users who started the Guide finished it.
- Drop-off step — which step is the most common exit point. (This is usually where your real product needs improvement.)
- Friction inside the Guide — rage clicks, errors, or back-tracking that happened while the Guide was running.
- Adoption lift — for Guides tied to a feature, how usage of that feature changed for users who completed the Guide vs. those who didn’t.
What’s in active development
| Capability | Status |
|---|---|
| Spotlight runtime, lifecycle events, draft / publish, per-workspace exclusions | Shipped |
| Programmatic launch from your code | Shipped |
| Studio Guide editor (record-mode authoring) | In active development |
| Agent-launched Guides (chat → matching Guide) | In active development |
| Auto-suggested Guides (HelpAlive proposes Guides based on what users actually try) | In design |
| Behavioral triggers (rage clicks, abandoned forms) | In design |
Next steps
Get Early Access
Tell us which flow needs a Guide and we’ll author it within a business day.
Agent overview
The AI assistant that will trigger Guides for you.
Topics inbox
See which questions a Guide could deflect.
Studio overview
All the places where Studio acts on what users do.