> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testdino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# What's Changing

> What to do after the TestDino update: sign in again, create a new API key, and switch to the @testdino/playwright package.

TestDino has been updated. Your test run history, dashboards, and analytics all carried over. Nothing is lost.

<Warning>
  Your **API keys** and **personal access tokens** stopped working, and the old `tdpw` upload commands are removed. Follow the steps below to get running again.
</Warning>

## What you need to do

Follow these 4 steps in order once the update is done.

<Steps>
  <Step title="Sign in again">
    If you were signed out, open [app.testdino.com](https://app.testdino.com) and sign back in. Your password and single sign-on still work.
  </Step>

  <Step title="Create a new API key">
    Your old API keys stopped working. Create a new one:

    1. Open your project and go to **Project Settings → API Keys**.
    2. Click **New → API Key**, name it, and click **Create**.
    3. Copy the key and save it. It is shown only once.
    4. Delete your old API keys.

    A personal access token (PAT) is optional. Create one only if you use the public API or MCP: open **User Settings → Personal Access Tokens → Generate new token**, name it, select the organizations and projects it may reach, then create it.

    Full walkthrough: [Generate API Keys](/guides/generate-api-keys) and the [API Quickstart](/api-reference/quickstart).
  </Step>

  <Step title="Install the new package and add it to your config">
    Install `@testdino/playwright`. It streams test results live as a run executes.

    ```bash theme={null}
    npm install @testdino/playwright
    ```

    <Danger>
      The old `tdpw` package is deprecated. Replace it with `@testdino/playwright`.
    </Danger>

    Add TestDino to the `reporter` array in your Playwright config. This is the only entry TestDino needs. Other reporters (`html`, `list`) are optional and yours to keep.

    ```typescript playwright.config.ts theme={null}
    import { defineConfig } from '@playwright/test';

    export default defineConfig({
      reporter: [
        ['@testdino/playwright', {
          token: process.env.TESTDINO_TOKEN,
          serverUrl: "https://reporter.testdino.com",
        }],
      ],
    });
    ```

    Set your new token and run your tests. No upload step is needed.

    ```bash theme={null}
    export TESTDINO_TOKEN="your-new-api-key"
    npx playwright test
    ```

    <Accordion title="Prefer not to edit your config?">
      Skip the `reporter` step above and run `tdpw test` instead. Same result, no config change. Pass your token with `-t`, or set `TESTDINO_TOKEN` first and omit it.

      ```bash theme={null}
      npx tdpw test -t "your-new-api-key" --server-url https://reporter.testdino.com
      ```

      It wraps `npx playwright test`, so any Playwright flag passes through, for example `npx tdpw test -t "your-new-api-key" --project=chromium --shard=1/3`.
    </Accordion>
  </Step>

  <Step title="Update your CI">
    Replace the old token in your CI secrets with the new API key, under the name `TESTDINO_TOKEN`. Keep `@testdino/playwright` in your Playwright config and run `npx playwright test` in the pipeline. Until the new token is in place, test runs fail with an authentication error.

    ```yaml theme={null}
    - name: Run Playwright tests with TestDino
      env:
        TESTDINO_TOKEN: ${{ secrets.TESTDINO_TOKEN }}
      run: npx playwright test
    ```
  </Step>
</Steps>

Full setup and every CLI flag is in the [Node.js CLI guide](/cli/testdino-playwright-nodejs).

## SSO admins

If your organization uses single sign-on, org owners and admins have 2 extra steps.

<Steps>
  <Step title="Re-enter your identity provider secret">
    Go to **Settings → Single Sign-On** and enter the secret again.
  </Step>

  <Step title="Allow the new IP address">
    Support sends you a new IP address. Add it to your identity provider's allowlist when they tell you to.
  </Step>
</Steps>

## What's new

| Feature              | What it does                                                                                                                        |
| :------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
| Real-time streaming  | Test results appear live as a run executes, with no upload step.                                                                    |
| Custom dashboards    | Build project and organization dashboards around your metrics.                                                                      |
| Redesigned interface | Updated navigation and layouts across the product.                                                                                  |
| Shard-level views    | See per-shard breakdowns for sharded runs.                                                                                          |
| Anomaly detection    | Flags unusual behavior at the test run level.                                                                                       |
| Expanded MCP tools   | 33 MCP tools now cover audits, error grouping, and issue-tracker integrations. See the [MCP Tools Reference](/mcp/tools-reference). |

## Get help

Something not working after the update? Email [support@testdino.com](mailto:support@testdino.com).

<CardGroup cols={3}>
  <Card title="Generate API Keys" icon="key" href="/guides/generate-api-keys">
    Create and manage API keys for the CLI and CI
  </Card>

  <Card title="API Quickstart" icon="user-lock" href="/api-reference/quickstart">
    Create a personal access token for the API
  </Card>

  <Card title="Support" icon="headset" href="/support">
    Contact the team for help
  </Card>
</CardGroup>