KeyCrate Docs

Appearance

Licenses ​

Licenses are the core authentication units in your application.
Each license is tied to a subscription plan, which defines its tier or access level.

Licenses can have a duration, HWID lock, metadata, tags, and other configurable options.
You can create, edit, extend, pause, or delete licenses at any time.

🪜 Creating a License ​

  1. Go to your application’s Licenses tab.
  2. Click “New License” and fill out the form.

🔢 Number of Keys ​

Set how many licenses to generate at once.

🔠 Key Format Configuration ​

  • Key Format Pattern: Define how your license keys are structured.
    Use * for random characters.
    Example: **-**-** or ABC-**-DEF
  • Character Types: Choose which characters to include:
    • Uppercase (A–Z)
    • Lowercase (a–z)
    • Numbers (0–9)

🧾 Subscription Plan ​

Select the subscription this license belongs to.
This determines the license’s tier and permissions.

⏱️ License Duration ​

Set how long the license remains valid:

  • Unit: Minutes, Hours, Days, Months, Years, or Lifetime
  • Value: Duration amount (e.g., 30 days)

💻 Hardware ID Settings ​

  • Enable HWID Lock: Bind the license to a specific hardware ID (used during validation).
  • Allow HWID Reset: Permit users to reset their own HWID.
  • Reset Interval (Days): How many days must pass before a user can reset again.

Note: If the selected subscription has “Single Key per HWID” enabled, only one license can be used per hardware ID under that subscription.

Developers can also manually reset or clear HWID values directly from the dashboard.

🧠 Metadata ​

Each license supports a metadata field where you can store custom JSON data.
This can include anything relevant to your software or integration logic.

Example:

json
{
    "discord_id": "1234",
    "user_tag": "Tester",
    "notes": "Pre-release access"
}

Maximum size: 2000 characters total.

🏷️ Tags ​

Tags are used to organize and filter licenses inside your dashboard.
They don’t affect behavior — they’re just labels.

Examples:

  • trial
  • test
  • important
  • giveaway

🔁 Extending a License ​

You can extend an existing license’s duration:

  • If unused, the extra time is added to the base duration.
  • If already used, the extension pushes the expiration date forward.

✏️ Editing a License ​

You can modify the following fields anytime:

  • Username
  • Metadata
  • HWID (manual reset)
  • Subscription plan
  • Tags

All changes apply instantly.

⏸️ License Status ​

Licenses are active by default.
If the related subscription or team is paused, the license will fail validation until reactivated.

🗑️ Deleting a License ​

Deleting a license permanently removes it from your application.
This cannot be undone.