User Management

Users are the people who use Metrognome—customers booking studios and staff running operations. This guide covers finding users, creating accounts, and handling common tasks like approvals and troubleshooting.

Finding a User

Most tasks start by finding the right account. Go to Staff → Users to see everyone in the system.

Quick search: Press ⌘K from anywhere in the app to open the command palette, then type a name or email to jump directly to a user.

From the users list:

1. Use the search bar to filter by name or email
2. Use the Role filter to narrow to customers, staff, or admins
3. Use the Approved filter to find pending accounts

Click any row to open that user's detail page.

Creating an Account

Sometimes you need to set up an account for someone rather than having them self-register. This is useful when onboarding a new customer in person or setting up a staff member.

To create an account:

1. Go to Staff → Users → New
2. Enter their email, first name, and last name
3. Click Create User

The system sends them a setup email with a link to set their password. The account is approved by default, so they can start booking as soon as they complete setup.

Viewing User Details

The user detail page shows everything about an account. You'll find their profile info at the top, followed by their credit balances, reservations, and transaction history.

What you can edit:

• Name, phone, bio
• Notes (internal—the user won't see these)
• Approved status

What's read-only:

• Reservations, transactions, access codes
• System IDs and timestamps

Use the Actions menu (top right) for approve, ban, impersonate, and Stripe actions.

Approving a User

New accounts are approved by default, but you may encounter users who need manual approval—either because they registered during a restricted period or were previously banned.

Unapproved users can sign in but can't make purchases or bookings.

To approve:

1. Find the user (filter by Approved: Pending to see them quickly)
2. Open their detail page
3. Click Actions → Approve User

You can also approve directly from the list using the row action menu.

Banning a User

Banning prevents a user from making new purchases or reservations. Their existing reservations stay intact—you'll need to cancel those separately if needed.

To ban:

1. Find the user
2. Click Actions → Ban User

Only admins can ban users. Staff can approve but cannot ban.

Troubleshooting with Impersonation

When a user reports a problem, sometimes the fastest way to understand it is to see exactly what they see. Impersonation signs you in as that user so you can experience the app from their perspective.

To impersonate:

1. Find the user
2. Click Actions → Impersonate User

You'll be signed in as them. Use this to troubleshoot booking issues, verify what they can see, or test their experience.

Adjusting Stripe Balance

The Stripe balance is credit that applies to a customer's next payment—separate from prepaid studio credits. Use this for refunds, promotional credits, or correcting billing issues.

This option only appears for users who have made at least one purchase (which creates their Stripe customer record).

To adjust:

1. Open the user's detail page
2. Scroll to Stripe Balance
3. Choose Add Credit or Remove Credit
4. Enter the amount and reason
5. Review the preview and submit

Add Credit reduces what they owe on their next invoice. Remove Credit increases what they owe (use this to reverse a credit added in error).

---

Reference

User List Columns

Column	Description
ID	Truncated system identifier
Name	Full name
Email	Primary email address
Phone	Phone number
Status	Approved or Pending badge
Last Sign In	Most recent login
Created	When account was created
Updated	Last modification

Permissions

Action	Permission Required
View users	users.list.any
Create users	users.create.any
Edit users	users.update.any
Approve users	users.approve.any
Ban users	users.ban.any
Delete users	users.delete.any
Adjust Stripe balance	credits.adjust.any