# Application Help and Support: Guided Troubleshooter

A troubleshooting wizard with a progress bar, an answered steps summary, the current question as selectable option rows, and step actions.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/guided-troubleshooter
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Help and Support](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/guided-troubleshooter.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-help-support-guided-troubleshooter
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: button
- Installs to: `@/components/blocks/application-pro/help-support/guided-troubleshooter`

## About this block

Guided Troubleshooter is a step by step wizard inside a
single card: a progress header naming the flow with a
Step 3 of 5 count and a fill bar, a summary of the two
already answered steps each with a check dot and a
Change button, then the current question presented as
four selectable option rows with one chosen. Each
option shows a radio dot, a label, and a one line
detail clarifying the symptom. A footer carries Back and
Continue actions plus an escape hatch line that opens a
ticket with the answers so far attached.

Answered steps and current options are two typed const
arrays, and the selected option is a plain boolean on
the data rather than client state, so the block renders
on the server. The escape hatch that opens a ticket with
context attached is what keeps a stuck user from
abandoning the flow.

## When to use

Reach for this block on a fix a problem route or inside
a help drawer, wired to your troubleshooting decision
tree. Advance the step, fill the progress bar, and carry
the collected answers into the ticket if the user hands
off to a human.

A natural flow around it on an Application Pro page:

**Before**

- [Help center home](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support)
- [Diagnostics report panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support)

**After**

- [Contact support panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support)
- [Submit request form](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support)

## What you can display

One strong use is the self serve troubleshooting flow.
Other configurations:

- **Returns wizard.** The same steps for a refund or
  exchange with reason options.
- **Onboarding setup.** Guided questions that configure
  a workspace on first run.
- **Bug report builder.** Steps that shape a structured
  report before it reaches your queue.

> Tip: always give the current step an escape hatch to a
> human and attach the answers so far; a stuck user
> should never restart from scratch in a ticket.

## More in Application Help and Support

- [Article Reader](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/article-reader)
- [Canned Responses Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/canned-responses-blueprint)
- [Community Q&A Thread](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/community-qa-thread)
- [Contact Support Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/contact-support-panel)
- [Contextual Help Drawer](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/contextual-help-drawer)
- [CSAT Survey Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/csat-survey-panel)
- [Diagnostics Report Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/diagnostics-report-panel)
- [Faq Accordion Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/faq-accordion-panel)
- [Getting Started Checklist](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/getting-started-checklist)
- [Help Center Home](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/help-center-home)
- [Help Search Results](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/help-search-results)
- [Known Issues Board](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/known-issues-board)
- [Product Glossary](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/product-glossary)
- [Shortcuts Reference](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/shortcuts-reference)
- [SLA Response Matrix](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/sla-response-matrix)
- [Submit Request Form](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/submit-request-form)
- [Ticket Detail](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/ticket-detail)
- [Ticket List](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/ticket-list)
- [Ticket Status Tracker](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/ticket-status-tracker)
- [Video Tutorials Library](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support/video-tutorials-library)
