Reference
Settings Reference
Retention and server settings, defaults, and what each setting controls.
This page summarizes the settings Arcalotl exposes through the dashboard and
Discord setup flows.
| Setting | Default | What it controls |
|---|
| Currency | Server setup value | Default currency for new plans. See Supported Currencies. |
| Payment recovery | On | Sends failed-payment recovery reminders |
| Cancel saves | On | Starts cancellation-save flows when members use /cancel |
| Term optimization | On | Sends annual upgrade offers when a tier has monthly and annual billing |
| Max recovery attempts | 4 | Maximum failed-payment reminders before recovery stops |
| Recovery reminder interval | 48 hours | Time between failed-payment reminders |
| Payment recovery grace period | 7 days | How long access can remain during unresolved payment recovery |
| Trial role access | On | Grants configured roles while a subscription is trialing |
| Setting | Default | What it controls |
|---|
| Enabled | On | Sends payment recovery reminders |
| Max attempts | 4 | How many reminders Arcalotl can send for one failed renewal |
| Interval | 48 hours | Time between scheduled reminders |
| Grace period | 7 days | When role access is removed if the payment remains unresolved |
| Setting | Default | What it controls |
|---|
| Enabled | On | Starts a save flow after /cancel |
| Reason mapping | See table below | Which offer, if any, each cancellation reason receives |
| Discount percent | 25% | Discount size for discount offers |
| Discount duration | 3 months | How long a discount offer lasts |
| Pause length | 30 days | Maximum pause duration for pause offers |
| Downgrade target | Next lower tier | Which related plan is offered for downgrade saves |
| Tenure threshold | 14 days | Minimum subscription age before discount and downgrade offers can show |
| Repeat cooldown | 180 days | Delay before the same member can receive another save offer |
Default reason mapping:
| Reason | Default offer |
|---|
| Too expensive | Discount |
| Not using it | Pause |
| Missing features | Downgrade when a lower related same-interval plan is available |
| Switching | No offer |
| Other | No offer |
| Setting | Default | What it controls |
|---|
| Enabled | On | Sends annual upgrade offers |
| Minimum tenure | 90 days | Active monthly subscription age before an annual offer can show |
| Offer frequency | 180 days | Cooldown between annual offers for the same subscription |
| Post-recovery cooldown | 30 days | Wait after resolved payment recovery before sending an annual offer |
| Incentive discount | None | Annual offers use the annual billing option's configured price |
These are configured through /arcalotl settings in Discord.
| Setting | What it controls |
|---|
| Admin channel | Operational admin notifications |
| Announcement channel | Public new-subscriber announcements |
| Subscribe channel | Persistent plan display message |
| Subscribe message | The plan display message Arcalotl keeps updated |
