first candidate for launch

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

@@ -0,0 +1,37 @@
+---
+weight: 197
+title: "Managing Coupons"
+description: "How to create coupons, set usage limits, and control what they apply to."
+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.**
+
+Coupons can be created and managed from **Admin → Coupons**. Coupons are currently applied at checkout only.
+
+## Creating a Coupon
+
+Click **Create Coupon** and fill in the following fields:
+
+- **Code** — The code customers will enter at checkout. Codes are stored in uppercase and must be unique. Letters, numbers, and hyphens are recommended.
+- **Type** — One of three discount types:
+  - `percent` — Percentage discount. Set *Value* to the percentage (e.g., `20` for 20% off).
+  - `fixed` — Fixed dollar discount. Set *Value* to the amount in cents (e.g., `5000` for $50 off).
+  - `free` — Covers the full charge. Value is ignored.
+- **Value** — The discount amount (percentage or cents, per type above). Set to 0 for free-type coupons.
+- **Max Uses** — Optional. Maximum number of times this coupon can be used. Leave blank for unlimited uses.
+- **Covers Domains** — If checked, the discount also applies to domain registration costs at checkout. If unchecked, the discount applies to the plan fee only.
+
+## Toggling a Coupon
+
+Any coupon can be activated or deactivated. Deactivated coupons are rejected at checkout even if they haven't reached their usage limit. Use this to quickly disable a coupon without deleting it.
+
+## Viewing Coupon Usage
+
+The Coupons list shows each coupon's current use count alongside its limit. You can also see coupon history on individual account pages — this shows which coupon was applied, when, and whether it was later removed.
+
+> **Note:** Coupons cannot currently be applied to post-signup billing. If a customer needs a recurring discount, use balance adjustments (credits) as an alternative.