# Timeline FAQ

> An FAQ laid out as a vertical timeline, walking visitors through questions in order. Suited to onboarding or step by step guides where sequence matters.

A shadcn/ui block from the [@shadcn-ui-blocks](https://www.shadcn-ui-blocks.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/shadcn-ui-blocks/marketing-faq-sections-timeline-faq).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/marketing-faq-sections-timeline-faq
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/marketing-faq-sections-timeline-faq-light-89149240ce9db76b.png
- Registry item: https://www.shadcn-ui-blocks.com/r/marketing-faq-sections-timeline-faq.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://www.shadcn-ui-blocks.com/r/marketing-faq-sections-timeline-faq.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `class-variance-authority`, `lucide-react`, `radix-ui`

## Files

### `components/blocks/marketing/faq-sections/timeline-faq.tsx`

```tsx
import { Button } from '@/components/ui/button';
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from '@/components/ui/card';
import { ArrowRight, CheckCircle } from 'lucide-react';

const timelineFaqs = [
  {
    title: 'Getting Started',
    description: 'How does the onboarding process work?',
    steps: [
      {
        title: 'Create an account',
        description:
          'Start by signing up for an account using your email address or by connecting with Google, Microsoft, or Apple accounts for faster registration.',
        additionalInfo:
          "We'll send a verification email to confirm your email address. Personal information is only used to identify your account and is never shared with third parties.",
      },
      {
        title: 'Complete your profile',
        description:
          'Add your basic information including your name, organization, role, and profile picture to help others identify you on the platform.',
        additionalInfo:
          'Your profile information helps us personalize your experience and provide relevant recommendations. You can update your profile at any time from your account settings.',
      },
      {
        title: 'Set up your workspace',
        description:
          'Create or join a workspace for your organization. This is where all your projects, tasks, and team collaborations will live.',
        additionalInfo:
          'Workspaces allow you to organize different areas of work. You can be part of multiple workspaces and switch between them easily.',
      },
      {
        title: 'Invite team members',
        description:
          'Add colleagues to your workspace by sending invitation emails. Set appropriate permission levels for each team member.',
        additionalInfo:
          'Team members can have different roles including Admin, Editor, and Viewer. Only workspace admins can invite new members and manage permissions.',
      },
      {
        title: 'Start your first project',
        description:
          'Create a new project, set goals and deadlines, and assign team members to specific tasks within the project.',
        additionalInfo:
          'Projects can be organized using boards, lists, or timelines depending on your preferred workflow. You can also import existing projects from other tools.',
      },
    ],
  },
  {
    title: 'Billing Cycle',
    description: 'How does your subscription and billing process work?',
    steps: [
      {
        title: 'Choose a plan',
        description:
          'Select from our Free, Pro, or Enterprise plans based on your needs. Each plan includes different features and user limits.',
        additionalInfo:
          'You can start with our 14-day free trial of any paid plan to explore all features before committing. No credit card required for the trial.',
      },
      {
        title: 'Enter payment details',
        description:
          'Provide your credit card or PayPal information. We use industry-standard encryption to protect your payment information.',
        additionalInfo:
          'We accept all major credit cards including Visa, Mastercard, American Express, and Discover. Enterprise plans can also pay via invoice.',
      },
      {
        title: 'Billing cycle begins',
        description:
          "Your subscription starts immediately, and you'll be charged according to your chosen billing cycle (monthly or annual).",
        additionalInfo:
          'Annual plans come with a significant discount compared to monthly billing. You can change your billing cycle at any time.',
      },
      {
        title: 'Receive invoices',
        description:
          "After each payment, we'll email you a receipt and you can access all invoices from your billing dashboard.",
        additionalInfo:
          'Invoices include detailed information about your plan, any add-ons, applicable taxes, and payment method used.',
      },
      {
        title: 'Renewal or cancellation',
        description:
          'Subscriptions automatically renew at the end of each billing cycle. You can cancel anytime from your account settings.',
        additionalInfo:
          "If you cancel, you'll maintain access until the end of your current billing period. We don't offer prorated refunds for unused time.",
      },
    ],
  },
];

export default function TimelineFAQ() {
  return (
    <div className="container mx-auto max-w-[85rem] px-4 py-24 md:px-6 lg:py-32 2xl:max-w-[1400px]">
      {/* Title */}
      <div className="mx-auto mb-10 max-w-2xl text-center lg:mb-16">
        <h2 className="text-2xl font-bold md:text-4xl md:leading-tight">
          How It Works
        </h2>
        <p className="text-muted-foreground mt-4">
          Step-by-step guides to common processes
        </p>
      </div>
      {/* End Title */}

      <div className="space-y-20">
        {timelineFaqs.map((faq, faqIndex) => (
          <div key={faqIndex}>
            <div className="mx-auto mb-10 max-w-3xl text-center">
              <h3 className="mb-2 text-xl font-semibold md:text-2xl">
                {faq.title}
              </h3>
              <p className="text-muted-foreground">{faq.description}</p>
            </div>

            <div className="relative mx-auto max-w-4xl">
              {/* Timeline line */}
              <div className="bg-border absolute top-0 bottom-0 left-12 z-0 hidden w-0.5 md:block" />

              {/* Timeline steps */}
              <div className="relative space-y-8">
                {faq.steps.map((step, stepIndex) => (
                  <div key={stepIndex} className="relative">
                    <div className="grid gap-6 md:grid-cols-[96px_1fr]">
                      {/* Timeline marker */}
                      <div className="flex md:justify-center">
                        <div className="bg-primary text-primary-foreground border-background z-20 flex h-12 w-12 items-center justify-center rounded-full border-4">
                          <span className="font-semibold">{stepIndex + 1}</span>
                        </div>
                      </div>

                      {/* Content */}
                      <Card>
                        <CardHeader>
                          <CardTitle>{step.title}</CardTitle>
                          <CardDescription>{step.description}</CardDescription>
                        </CardHeader>
                        <CardContent>
                          <div className="text-muted-foreground text-sm">
                            {step.additionalInfo}
                          </div>
                        </CardContent>
                        {stepIndex === faq.steps.length - 1 && (
                          <CardFooter className="flex items-center justify-between border-t pt-4">
                            <div className="text-primary flex items-center text-sm font-medium">
                              <CheckCircle className="mr-1.5 h-4 w-4" />
                              <span>Process complete</span>
                            </div>
                            <a href="#">
                              <Button
                                variant="ghost"
                                size="sm"
                                className="gap-1"
                              >
                                <span>Learn more</span>
                                <ArrowRight className="h-3.5 w-3.5" />
                              </Button>
                            </a>
                          </CardFooter>
                        )}
                      </Card>
                    </div>
                  </div>
                ))}
              </div>
            </div>
          </div>
        ))}
      </div>

      {/* Additional Help */}
      <div className="mx-auto mt-20 max-w-xl text-center">
        <h3 className="mb-2 text-lg font-semibold">Still have questions?</h3>
        <p className="text-muted-foreground mb-6">
          Our support team is here to help with any specific questions you might
          have about our services or processes.
        </p>
        <div className="flex flex-col justify-center gap-4 sm:flex-row">
          <a href="#">
            <Button variant="outline">Browse FAQs</Button>
          </a>
          <a href="#">
            <Button>Contact Support</Button>
          </a>
        </div>
      </div>
    </div>
  );
}
```

### `components/ui/button.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const buttonVariants = cva(
  "group/button inline-flex shrink-0 items-center justify-center rounded-md border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground hover:bg-primary/80",
        outline:
          "border-border bg-background shadow-xs hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
        secondary:
          "bg-secondary text-secondary-foreground hover:bg-secondary/80 aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
        ghost:
          "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
        destructive:
          "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
        link: "text-primary underline-offset-4 hover:underline",
      },
      size: {
        default:
          "h-9 gap-1.5 px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        xs: "h-6 gap-1 rounded-[min(var(--radius-md),8px)] px-2 text-xs in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
        sm: "h-8 gap-1 rounded-[min(var(--radius-md),10px)] px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5",
        lg: "h-10 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        icon: "size-9",
        "icon-xs":
          "size-6 rounded-[min(var(--radius-md),8px)] in-data-[slot=button-group]:rounded-md [&_svg:not([class*='size-'])]:size-3",
        "icon-sm":
          "size-8 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-md",
        "icon-lg": "size-10",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Button({
  className,
  variant = "default",
  size = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"button"> &
  VariantProps<typeof buttonVariants> & {
    asChild?: boolean
  }) {
  const Comp = asChild ? Slot.Root : "button"

  return (
    <Comp
      data-slot="button"
      data-variant={variant}
      data-size={size}
      className={cn(buttonVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Button, buttonVariants }
```

### `components/ui/card.tsx`

```tsx
import * as React from "react"

import { cn } from "@/lib/utils"

function Card({
  className,
  size = "default",
  ...props
}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
  return (
    <div
      data-slot="card"
      data-size={size}
      className={cn(
        "group/card flex flex-col gap-6 overflow-hidden rounded-xl bg-card py-6 text-sm text-card-foreground shadow-xs ring-1 ring-foreground/10 has-[>img:first-child]:pt-0 data-[size=sm]:gap-4 data-[size=sm]:py-4 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
        className
      )}
      {...props}
    />
  )
}

function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-header"
      className={cn(
        "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-6 group-data-[size=sm]/card:px-4 has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-6 group-data-[size=sm]/card:[.border-b]:pb-4",
        className
      )}
      {...props}
    />
  )
}

function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-title"
      className={cn(
        "font-heading text-base leading-normal font-medium group-data-[size=sm]/card:text-sm",
        className
      )}
      {...props}
    />
  )
}

function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-description"
      className={cn("text-sm text-muted-foreground", className)}
      {...props}
    />
  )
}

function CardAction({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-action"
      className={cn(
        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
        className
      )}
      {...props}
    />
  )
}

function CardContent({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-content"
      className={cn("px-6 group-data-[size=sm]/card:px-4", className)}
      {...props}
    />
  )
}

function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-footer"
      className={cn(
        "flex items-center rounded-b-xl px-6 group-data-[size=sm]/card:px-4 [.border-t]:pt-6 group-data-[size=sm]/card:[.border-t]:pt-4",
        className
      )}
      {...props}
    />
  )
}

export {
  Card,
  CardHeader,
  CardFooter,
  CardTitle,
  CardAction,
  CardDescription,
  CardContent,
}
```