# checkly switch - Checkly Docs

> Switch between multiple Checkly accounts.

Source: https://www.checklyhq.com/docs/cli/checkly-switch/

---

- Usage
- Command Options
- Examples
- Troubleshooting No Alternative Accounts
- Account Not Listed

- Related Commands

CLI Commands

# checkly switch

Switch between multiple Checkly accounts.

The `checkly switch` command switches between multiple Checkly accounts that you have access to with your current credentials. Useful when you need to manage monitoring across different organizations or environments.

Prerequisites

Before using `checkly switch`, ensure you have:

- Valid Checkly account authentication (run `npx checkly login` if needed)

- Access to multiple Checkly accounts (team memberships, client projects, etc.)

If you only have access to one account, this command will indicate no alternative accounts are available.

## ​ Usage

The basic command displays available accounts and provides an interactive selection interface.
Terminal

```
npx checkly switch [options]
```

Option Required Description

`--account-id, -a` - The id of the account you want to switch to.

## ​ Command Options

​

string

The `switch` command asks you to select an account interactively by default. Use this option to switch accounts non-interactively by specifying the target account ID directly. **Usage:** Terminal

```
npx checkly switch --account-id="a43....."
npx checkly switch -a="a43....."
```

## ​ Examples

- Standard Switch
- Automatic Switch

Terminal

```
# Standard account switching
npx checkly switch

# Output
? Which account do you want to use?
Production
Staging
Demo
...
```

Terminal

```
# Verbose account switching with details
npx checkly switch --account-id="a43....."

# Output
Account switched to "a43....."
```

## ​ Troubleshooting

### ​ No Alternative Accounts

If you see “No alternative accounts available”:

- You only have access to one Checkly account

- Contact account administrators to request access to additional accounts

- Consider using separate authentication for different accounts

### ​ Account Not Listed

If an expected account doesn’t appear:

- Verify you have active access to that account

- Check that your user hasn’t been removed from the account

- Try logging out and back in to refresh account permissions

## ​ Related Commands

- [`checkly login`](https://www.checklyhq.com/docs/cli/checkly-login) - Sign in to your Checkly account

- [`checkly whoami`](https://www.checklyhq.com/docs/cli/checkly-whoami) - Display current account information

Was this page helpful?

[Suggest edits](https://github.com/checkly/docs/edit/main/cli/checkly-switch.mdx)[Raise issue](https://github.com/checkly/docs/issues/new?title=Issue%20on%20docs&body=Path:%20/cli/checkly-switch)

[checkly status-pages Previous](https://www.checklyhq.com/docs/cli/checkly-status-pages)[checkly sync-playwright Next](https://www.checklyhq.com/docs/cli/checkly-sync-playwright)

[x](https://x.com/checklyhq)[github](https://github.com/checkly)[linkedin](https://linkedin.com/company/checkly)

[Powered by This documentation is built and hosted on Mintlify, a developer documentation platform](https://www.mintlify.com/?utm_campaign=poweredBy&utm_medium=referral&utm_source=checkly-422f444a)