first candidate for launch

content/docs/enterprise/admin/managing-tiers.md

@@ -0,0 +1,51 @@
+---
+weight: 196
+title: "Managing Tiers"
+description: "How to create, modify, and toggle plan tiers."
+icon: "article"
+date: "2025-05-27T00:00:00-00:00"
+lastmod: "2025-05-27T00:00:00-00:00"
+draft: false
+toc: true
+---
+
+> **Internal use only.**
+
+Admins can view, create, modify, and toggle the active status of plan tiers from **Admin → Tiers**. Changes to tier pricing or limits affect new billing cycles going forward; they do not retroactively change existing invoices.
+
+## Viewing Tiers
+
+The Tiers page shows all tiers — both active and inactive — with their pricing and current settings.
+
+## Editing an Existing Tier
+
+Click on a tier to edit its details:
+
+- **Name** — Display name shown to customers
+- **Membership fee** — Monthly flat fee in cents
+- **Per-Core price** — Monthly per-Core charge in cents
+- **Credit cents** — Account credit included at signup (charged at checkout, loaded to balance)
+- **Max Cores** — Maximum Cores allowed (0 = unlimited)
+
+## Toggling Tier Availability
+
+Each tier can be set to **active** or **inactive**. Inactive tiers are not visible or selectable by customers during checkout or plan changes. Existing accounts on an inactive tier are not affected — they remain on their current tier; only new sign-ups and tier changes are blocked.
+
+## Creating a New Tier
+
+Use the **Create Tier** button to define a new tier. You'll need to provide:
+
+- A unique key (lowercase, no spaces — used internally and in the database, e.g. `enterprise_plus`)
+- A display name
+- Membership fee, per-Core price, credit cents, and max Cores
+
+After creating a tier, you'll also need to configure its add-on pricing via the Add-on admin tools if you want that tier to support per-Core or subscription add-ons.
+
+## Changing an Account's Tier (Admin Override)
+
+From an account's detail view, admins can change that account's tier directly. This is separate from the customer-facing plan change flow. Admins can choose to apply the change **immediately** or **at the next billing cycle**.
+
+- **Immediate** — Takes effect right away; new pricing applies from the current date.
+- **Next billing cycle** — Behaves like a customer-initiated plan change.
+
+> **Caution:** Immediate tier changes can affect an account's mid-cycle billing calculations. Use this sparingly and document the reason when performing immediate overrides.