Client Guide

Browser extension guide

The extension owns its own sign-in handoff and Device Session. Treat the popup as the source of truth for extension setup.

What to expect

A healthy extension flow signs in from the popup, reconnects its own Device Session, and then creates a `web_selection` Clip that appears in product state.

Expected button flow

Run these checks in order when the extension does not behave as expected.

  1. 1

    Start sign-in from the popup, not from a disconnected browser tab.

  2. 2

    Confirm `App URL` before you retry auth or Capture.

  3. 3

    Use `Load Current Selection` or `Save Selection Capture` only after the Device Session is healthy.

Related pages

Use these shortcuts when you need setup help or a failure-specific support path.

Setup steps

Return to the extension step in Getting Started.

Capture troubleshooting

Open the support path for repeated capture failures.

Open troubleshooting

Run self-serve diagnosis before opening Support.