On this page

Amplitude Quickstart

Get from zero to insights in minutes with three easy ways to get Amplitude up and running.

Pick the best path for you

Choose the setup path that fits how you work. All three options send data to the same Amplitude project. You can switch paths later if your needs change.


Wizard CLI

Full SDK setup for developers. The wizard authenticates you with Amplitude, detects your framework, proposes custom events, and confirms that data reaches your project before it exits.

What you get

  1. Run

    Run the setup wizard

    Run the command in your terminal, or run it from Claude Code inside your terminal.

    bash
    npx @amplitude/wizard
    
  2. Add

    Add your API key

    Paste the API key for the project you want to track when the wizard prompts you.

    Where to find your API key

    Go to Settings > Projects and copy the API key for the project you want to track. Need an API key? Create a free Amplitude account.

  3. Verify

    Verify that data is flowing

    Open the Amplitude Debugger to confirm that the wizard's test events arrive in real time.

Tips

  • Use --menu to pick your framework instead of relying on auto-detection.
  • Requires Node.js 20.
  • Press tab during the wizard to ask questions or send feedback.

AI Prompt

Low-code setup with an AI assistant. Copy this prompt into an AI coding tool to set up the Amplitude Browser SDK for a JavaScript web app without running the full wizard flow.

Set up with an AI prompt

Use this option when you want an AI tool to make the code changes for you. If you want Amplitude to detect your framework and propose events automatically, use Wizard CLI instead.

What you get

  1. Copy

    Copy the prompt into your AI tool

    Paste it into Cursor, Claude Code, Copilot, or another coding assistant that can edit your project.

    text
    Install and configure Amplitude for this JavaScript web application.
    
    Use API key: AMPLITUDE_API_KEY
    
    Requirements:
    - Run the implementation only on the client.
    - Initialize Amplitude once during app load.
    - Install the correct browser package for this project.
    - Enable fetchRemoteConfig: true.
    - Enable autocapture for attribution, page views, sessions, element interactions, form interactions, and file downloads.
    - Enable Session Replay with sampleRate: 1.
    - Preserve the project's existing TypeScript and framework patterns.
    
  2. Review

    Review the generated changes

    Confirm that the assistant installed the SDK, initialized it in the right client entry point, and kept the code client-side.

  3. Verify

    Verify that events arrive

    After the changes land, open the Amplitude Debugger and confirm that page views and session data reach your project.

Tips

  • Click the API key button in the code block to insert your key before you copy the prompt.
  • Create a free Amplitude account if you still need a project and API key.

Browser Snippet

Paste-and-go install for websites. Paste this script into the <head> of your site when you want the fastest possible browser install without a build step or npm package.

Set up with a browser snippet

Use this option for static sites, CMS-driven sites, or any project where a script tag is easier than an SDK install. If you want framework-aware setup, use Wizard CLI instead.

What you get

  1. Paste

    Paste the snippet into your site's `<head>`

    Add it to every page you want to track.

    html
    <script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>
    <script>
      window.amplitude.add(window.sessionReplay.plugin({ sampleRate: 1 }));
      window.amplitude.init("AMPLITUDE_API_KEY", {
        fetchRemoteConfig: true,
        autocapture: {
          attribution: true,
          fileDownloads: true,
          formInteractions: true,
          pageViews: true,
          sessions: true,
          elementInteractions: true,
          networkTracking: true,
          webVitals: true,
          frustrationInteractions: true,
        },
      });
    </script>
    
  2. Set

    Set your API key and load the page

    Replace the placeholder with your project's API key, then load a tracked page in your browser.

  3. Confirm

    Confirm data in Amplitude

    Open the Amplitude Debugger and check for page view, session, and interaction events.

Tips

  • Click the API key button in the code block to insert your key before you copy the snippet.
  • Use the EU CDN host if your project uses EU data residency.
  • Create a free Amplitude account if you need a project and API key.

Take the next step

After data starts flowing, use these guides to expand your implementation.

More in this section

Was this helpful?