Skip to main content

​
Prerequisites

  • Active PlayerZero account with project access
  • Editor or Owner permissions in that project
  • Google Chrome browser (version 88 or later)

​
Step 1: Install the Extension

  1. Open Google Chrome
  2. Visit the Chrome Web Store and search for PlayerZero
  3. Click Add to Chrome
  4. Click Add Extension when prompted
  5. The PlayerZero icon will appear in your Chrome toolbar

​
Step 2: Create a Personal Access Token

  1. Open Token Settings
    • Log in at playerzero.ai
    • Choose your organization and project
    • Navigate to Settings → User Settings → Personal Access Tokens
  2. Generate Token
    • Click New Token
    • Give it a descriptive name, e.g. Chrome Extension - [Your Name]
    • Click Create Token
    • Copy and store the token immediately — it won’t be shown again
  3. Token details
    • Tokens start with pz_pat
    • Expires in 90 days
    • Scoped to one project
    • Each team member should create their own token

​
Step 3: Connect the Extension

  1. Open the side panel
    • Click the PlayerZero icon in your Chrome toolbar to open the side panel
  2. Enter your token
    • You’ll land on the Settings screen
    • Paste your Personal Access Token into the token field
    • Click Save
  3. Select a project
    • After saving your token, the extension loads your available projects
    • Use the project dropdown at the top to select which project you’re working in
    • Your selection is saved and persists across browser sessions
  4. Verify connection
    • Navigate to any webpage
    • The floating toolbar should appear near the bottom of the page when the side panel is open
    • The extension badge may show a number if you have active Players needing input

​
Step 4: Verify It’s Working

Try a quick test to confirm everything is connected:
  1. Open any webpage you’d like to analyze
  2. Open the side panel (click the PlayerZero icon)
  3. Click the full page capture button on the floating toolbar (page icon with a plus)
  4. Type a question like “What does this page do?” in the side panel
  5. Click Submit — a new AI Player session will be created
If the Player starts successfully, you’re all set.

​
Best Practices

  • Rotate tokens regularly — they expire after 90 days
  • Use descriptive names to track which token is used where
  • Each team member should have their own token
  • Delete unused tokens from Settings → User Settings → Personal Access Tokens
  • Capture before asking: Attach page context to give the AI Player more to work with
  • Use partial capture to focus on a specific error message, component, or section rather than the full page
  • Check the badge — the orange badge count tells you how many Players need your input
  • The extension needs access to all URLs to render the floating toolbar and capture page content
  • It communicates only with playerzero.ai — no data is sent to third parties
  • Page content is converted to a readable format locally in the browser before being sent to the API

​
Troubleshooting

The toolbar only appears when the side panel is open. Click the PlayerZero icon in your Chrome toolbar to open it. If the side panel is already open and you still don’t see the toolbar, try refreshing the page.
  • Ensure the token starts with pz_pat — tokens without this prefix will be rejected
  • Check that the token hasn’t expired (90-day lifetime)
  • Verify you have Editor or Owner permissions on the project
  • Generate a new token if needed from Settings → User Settings → Personal Access Tokens in the web app
You’re in partial capture mode. Press Escape to exit and return to normal browsing.
Some websites have strict Content Security Policies that may interfere with the extension’s ability to read page content. This is a browser-level restriction. Try using full page capture instead of partial capture, or manually describe the page content in your question.
The badge updates every 30 seconds and requires a valid token. If your token has expired or been removed, the badge will clear. Re-enter a valid token in the extension settings.

​
Security

  • Token security: Store your Personal Access Token securely and never share it
  • Project scope: Tokens only provide access to the specific project they were created for
  • Data handling: Captured page content is processed locally in the browser and sent to PlayerZero over HTTPS
  • Expiration: Tokens automatically expire after 90 days

​
Learn More

👉 Chrome Extension features 👉 AI Player overview 👉 Jump to the app