Skip to content

[wrangler] Add multi-account profile support #11780

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
LukasMurdock wants to merge 1 commit into from
Closed

[wrangler] Add multi-account profile support #11780

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions .changeset/profile-support.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
"wrangler": minor
---

Add profile support for multi-account management.

Profiles allow you to store and switch between multiple Cloudflare user identities (OAuth tokens or API tokens), enabling seamless work across different Cloudflare accounts without re-authenticating.

## New Commands

- `wrangler profile list` - List all configured profiles
- `wrangler profile current` - Show the currently active profile
- `wrangler profile use <name>` - Set the project-level profile
- `wrangler profile use <name> --global` - Set the global profile
- `wrangler profile use --clear` - Clear the project-level profile
- `wrangler profile delete <name>` - Delete a profile

## Updated Commands

- `wrangler login --profile <name>` - Login and save credentials to a specific profile
- `wrangler auth token --profile <name>` - Get token from a specific profile
- `wrangler whoami` - Now shows the active profile

## File Locations

- Credentials file: `~/.wrangler/credentials` (stores all profiles)
- Global current profile: `~/.wrangler/current-profile`
- Project-level profile: `.wrangler/profile`

## Profile Resolution Precedence

1. `--profile` CLI flag (highest)
2. `WRANGLER_PROFILE` environment variable
3. `.wrangler/profile` (project-level)
4. `~/.wrangler/current-profile` (global)
5. `default` profile

## Example Workflow

```bash
# One-time setup for multiple clients
wrangler login --profile client-a
wrangler login --profile client-b

# Per-project profile (one-time per project)
cd ~/projects/client-a-worker
wrangler profile use client-a

cd ~/projects/client-b-worker
wrangler profile use client-b

# Daily workflow - just works
cd ~/projects/client-a-worker && wrangler deploy
cd ~/projects/client-b-worker && wrangler deploy
```

## Migration

Existing credentials in `~/.wrangler/config/default.toml` are automatically migrated to the new credentials file as the `default` profile.
Loading