first candidate for launch

content/docs/enterprise/domains/domain-renewal.md

@@ -0,0 +1,28 @@
+---
+weight: 173
+title: "Domain Renewal"
+description: "How custom domain renewal works, including auto-renewal and failure handling."
+icon: "article"
+date: "2025-05-27T00:00:00-00:00"
+lastmod: "2025-05-27T00:00:00-00:00"
+draft: false
+toc: true
+---
+
+Custom domains are registered for one year at a time. Federated Enterprise automatically handles renewal so your domains stay active without manual intervention.
+
+## Auto-Renewal
+
+By default, all custom domains are set to **auto-renew**. Before a domain expires, the platform will charge the renewal fee to your account (balance first, then card) and renew the registration for another year.
+
+You can toggle auto-renewal on or off for individual domains from the Domains page. Only **Owners** and **Admins** can change this setting.
+
+> **Warning:** If you disable auto-renewal, you are responsible for renewing the domain before it expires. An expired domain may become available for registration by others and can disrupt your Cores and services.
+
+## Renewal Failures
+
+If a renewal charge fails (e.g., due to an expired card or insufficient balance), you'll receive a notification email. The platform will attempt the renewal again, but it's important to ensure your payment method is up to date to avoid service interruption.
+
+## Federated Domains
+
+Federated-managed domains (`federatedcomputer.cloud`, `federatedcomputer.net`, `fedcom.net`) are maintained by Federated Computer and never expire or require renewal from your side.