Billing and subscriptions
This page explains how to manage your subscription. For numerical limits, see Plans and limits. For prices, see the pricing page.
- What you can do: Change plans and add-ons, check payment methods and invoices, cancel or resume a subscription, and delete a workspace
- Required role: Owner or Admin. Only the Owner can delete a workspace
- Where: In the console, go to Settings → Billing and usage. To delete a workspace, go to Settings → Dangerous actions
When billing starts
Section titled “When billing starts”- Each account can use a 14-day free trial once. Starter and Plus can start without a card. If you do not add a card before the trial ends, it ends automatically without a charge. Team requires a card when starting the trial (cancel during the trial to avoid a charge)
- If you have added a card, the trial end date is your first billing date. Subsequent charges occur monthly based on your subscription date
- If an account that has already used its trial creates a second workspace, billing starts as soon as payment is completed
- Your billing country determines the currency (JPY including tax for Japan, USD excluding tax elsewhere). The currency is fixed when you first subscribe; contact support to change it later
- Payment by invoice or bank transfer is not supported
The number of App Users does not affect the price.
Trial limits and what happens when it ends
Section titled “Trial limits and what happens when it ends”During the trial, every plan uses these limits: up to 3 stored apps (apps already deployed as static sites do not count), up to 3 concurrent apps, and up to 7 builds per day and 30 in total. See Plans and limits.
| Status at the end of the trial | What happens |
|---|---|
| Card added | Your subscription converts to a paid plan and the first charge is made. The stored-app limit is removed, and concurrent-app slots return to your plan’s allowance |
| No card added (Starter / Plus) | The trial ends automatically without a charge. New deployments, app starts, and scheduled jobs are blocked. Apps and data are not deleted (see “Apps and data after cancellation” below) |
During the trial, both upgrades and downgrades take effect immediately without a charge.
Change your plan
Section titled “Change your plan”Go to Billing and usage → Change plan. The amount is shown before you confirm.
| Change | Takes effect | Billing |
|---|---|---|
| Upgrade | Immediately | The unused portion of your current plan is deducted from the cost of the remaining period on the new plan, and the difference is charged when you change plans. The full new price applies from the next billing date |
| Downgrade | At the end of the current billing period | No prorated adjustment. You can keep using your current plan until then |
A downgrade appears as a scheduled change. Use “Cancel scheduled change” to cancel it before it takes effect.
A warning appears if your current usage exceeds the new plan’s limits. If you switch while still over a limit:
- Concurrent apps: Sleeping apps cannot start until usage falls within the limit
- Developers seats: Invitations and role changes to Developer or higher are blocked until usage falls within the limit
- Scheduled job runs: Runs are skipped for the rest of the month
- Storage: This is a soft limit. Exceeding it does not immediately stop service; a warning appears at deployment and support will contact you. Sustained, significant overages may result in restrictions
- Custom domains (Team only): Existing registrations remain, but you cannot add or re-register domains
Change add-ons (paid Team plans and above)
Section titled “Change add-ons (paid Team plans and above)”Go to Billing and usage → Add-ons to set quantities for extra app slots (+1), extra Developers seats (+1), and extra storage (+50 GB). You cannot change add-ons during the trial; you can add them after it ends. The prorated amount is charged immediately to your saved payment method. Reductions are credited toward future invoices.
Payment methods and invoices
Section titled “Payment methods and invoices”Recent invoices appear under Invoices on the Billing and usage page. Each row links to the Stripe invoice page and PDF.
Use the “Manage billing” button to open the Stripe customer portal in a new tab to change your payment method, edit billing details, or view older invoices. You can also cancel in the portal, but cancelling in the Keelson console lets you review the end date and impact first.
If a payment fails and becomes overdue, service continues as usual while Stripe retries. If payment is still outstanding after retries finish, the subscription is suspended and new deployments, app starts, and scheduled jobs are blocked. Use “Update payment method” to update your details.
Cancel your subscription
Section titled “Cancel your subscription”Go to Billing and usage → Cancel plan, review the details, then select “Confirm cancellation”.
- Your plan remains active until the end of the current billing period. Nothing stops immediately when you confirm, and the remaining period is not refunded
- You can undo the cancellation with “Resume” at any time before the period ends
- After the period ends, new deployments, app starts, and scheduled jobs are blocked. Cancellation itself does not delete apps or data
Apps and data after cancellation
Section titled “Apps and data after cancellation”When a workspace’s subscription ends—after cancellation takes effect, suspension for nonpayment, or a trial ending without a card—apps can no longer start, but they are not deleted immediately.
- When affected apps are identified, the Owner and Admins receive an advance deletion notice in the console and by email. The notice includes the scheduled deletion date
- The grace period is 30 days from the notice. Usage restrictions remain in place, but you can sign in to the console and download database backups
- Resubscribing by choosing a plan during the grace period cancels the notice and keeps your apps. This is the only way to retain them
- After the grace period, apps are deleted automatically. They receive the same treatment as a user-approved deletion: only database backups, Files, and non-sensitive configuration notes are retained in isolation for 7 days. Recovery is not guaranteed
Export any data you want to keep during the grace period (see “Export your data” below).
Delete a workspace
Section titled “Delete a workspace”Go to Settings → Dangerous actions → Delete this workspace. Only the Owner can do this, and confirmation requires entering the workspace name.
- The workspace and all its apps are deleted, and members lose access. This cannot be undone
- Each app’s database backups, Files, and non-sensitive configuration notes are retained in isolation for 7 days, but this does not guarantee recovery
- Deletion signs you out
- If you have an active subscription, deleting the workspace also cancels it. You do not need to cancel first. As a precaution, check the Stripe portal (open it through “Manage billing” before deletion) or invoice emails to confirm that billing has stopped
You can delete your Keelson account yourself from the account menu at the top right of the console → Account settings → Security → Delete account. This deletes your Keelson account, not the Google or Microsoft account you used to sign in. Apps and data in workspaces you belonged to also remain.
Export your data
Section titled “Export your data”Before cancelling or deleting, export the following. The steps differ for databases and Files / Media.
| Data | How to export |
|---|---|
| Managed SQLite data | Download any available point in time as a SQLite dump from Restore points on the app’s console page. This remains available during the grace period after your subscription ends |
| Files SDK / Media SDK files | Downloads are not available through the console or CLI. Implement authenticated download endpoints in your app for listing and retrieving files, and export them while the app is running. Apps cannot start after the subscription ends, so do this before cancelling |
| Source code | From Git, or download it from an individual deployment in the Deployments tab |
| Environment variables and secrets | Secret values are not displayed in the console. If needed, record them from their original source |
| Access logs and app logs | Export from the Logs tab (up to 5,000 lines for app logs) |
The terms of service allow us to delete data after a period we specify following the end of the subscription (generally within 30 days). Export your data yourself before the subscription ends.
Related pages
Section titled “Related pages”- Plans and limits — Numerical limits and what happens when you reach them
- Update and restore — App deletion and what to export first
- Pricing page