License Keys

License keys allow team administrators to distribute SN Utils access without sending individual invitations.

Key Types

SN Utils supports two types of license keys:

Individual Keys

• Format: SNU-XXXX-XXXX
• Use: One-time activation by a single user
• Best for: Specific team members, contractors, or trial users

Domain Keys

• Format: DOM-XXXX-XXXX
• Use: Multiple activations by users with matching email domain
• Best for: Self-service onboarding for entire departments

Creating License Keys

Step 1: Navigate to License Keys

1. Go to your team dashboard
2. Navigate to License → Manage License Keys
3. Or visit /home/[team]/license/keys directly

<!-- TODO: Screenshot of license keys page -->

Step 2: Create a New Key

1. Click Create License Key
2. Select the key type:
   • Individual for single-user keys
   • Domain for email domain-restricted keys
3. Optionally add a friendly name (e.g., "Marketing Team Key")
4. For domain keys, enter the allowed email domain (e.g., acme.com)
5. Click Create Key

<!-- TODO: Screenshot of create key dialog -->

Step 3: Share the Key

1. Copy the generated key code
2. Share it with your team via:
   • Email
   • Slack/Teams
   • Internal wiki
   • Onboarding documentation

Managing Keys

View All Keys

The license keys page shows:

• All created keys organized by type
• Key status (Active, Claimed, Inactive)
• Usage statistics
• Creation date

Key Actions

How Users Claim Keys

When a user receives a license key:

1. They visit your team's signup/activation page
2. Enter the license key
3. Create their account (or sign in)
4. The key is claimed and they gain access

For domain keys, the user's email must match the allowed domain.

Best Practices

Security

• Don't share keys publicly — They grant access to your subscription
• Deactivate unused keys — Clean up keys that weren't used
• Use domain keys for large groups — Easier to manage than many individual keys

Organization

• Use descriptive names — "Sales Team Q1 2026" is better than "Key 1"
• Set max uses for domain keys — Prevent unlimited signups
• Review key usage monthly — Ensure only intended users are joining

Limits

• Individual keys count as 1 seat when claimed
• Domain keys consume seats per claim
• Keys respect your subscription seat limit
• Deactivating a key doesn't free up claimed seats

FAQ

Can I see who claimed a key?

Yes! Domain keys show usage statistics including which emails claimed the key.

What happens if I run out of seats?

New key claims will be rejected. Either upgrade your subscription or remove unused team members.

Can users share keys?

Individual keys can only be used once. Domain keys are restricted by email domain, preventing unauthorized sharing.

How do I revoke access for someone who used a key?

Remove them from your team members list. Deactivating the key only prevents new claims.