> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit a subscription

> Learn how to add a membership or resource to a customer's existing subscription, change or remove its items, schedule changes for the next renewal or a specific future date, add a seat for a new company member, and understand when each change takes effect and how a mid-cycle change is billed

As your members' needs evolve, you can update their subscriptions at any time:

* Change a customer's membership, resource, or rental plan
* Adjust subscription products or quantities when company members join or leave
* Add extra memberships or resources to a subscription the customer already has, so they are billed together with its other items.

## Edit a subscription

1. Go to **Customers** > open the customer's profile.
2. Press **(...)** next to the relevant subscription > **Edit**.

![](https://mintcdn.com/spacebring/GkdaLooFbk7HzWgy/images/billing-subscriptions-edit-a-subscription-1.png?fit=max\&auto=format\&n=GkdaLooFbk7HzWgy\&q=85\&s=ccb9779616c68dc42a312b665b71f8bf)

The exact steps depend on:

* When the change should take effect:
  * Immediately
  * On the next renewal date
  * On a specific future date
* Whether the customer is staying on the same billing cycle or switching to a different one.

## Add an item or create another subscription

* [Add an item to the existing subscription](#subscriptions-with-the-same-cycle) when the charge should be added to the same invoice, on the same billing date as its other items — for example, a seat for a new company member, an extra desk, or a [recurring add-on](https://www.spacebring.com/docs/guides/recurring-add-ons.md).
* [Create a second subscription](#subscriptions-with-different-cycles-billing-dates-or-invoices) when the customer keeps their current one and the charge needs its own invoice, a different billing date, or a different cycle — for example, an annual membership alongside a monthly one.
* [End the current subscription and create another](#subscriptions-with-different-cycles-billing-dates-or-invoices) when the customer moves off their billing cycle — for example, from monthly to annual.

## Subscriptions with the same cycle

This applies when a customer keeps the same renewal cycle (e.g., remaining on a weekly, monthly, or annual subscription). Choose the tab for when the change should take effect.

> [tab] Immediately
>
> A change may need to take effect today — for example, a customer upgrades their membership mid-cycle, or a new company member joins and needs access right away:
>
> 1. Edit the existing subscription item, or add/remove a subscription item.
>
> ![Edit subscription window with the subscription items on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/HXwgu-OYpQnS7jw8/images/billing-subscriptions-edit-a-subscription-apply-an-immediate-change-subscription-items.png?fit=max\&auto=format\&n=HXwgu-OYpQnS7jw8\&q=85\&s=63174377885431cf317def8bc8f818e9)
>
> 2. If adding a new item, keep the item's **Start date** set to **Subscription default**.
>    * Resource assignment, discounts, door, printing, and exclusive resource access are updated immediately.
>
>    * Price, credits, and day passes are updated from the next renewal, when the new amount appears on the subscription's invoice alongside its other items. The current period has already been invoiced, so the days left in it aren't charged automatically.
>
> > [!WARNING]
> >
> > Spacebring doesn't prorate or charge the remaining part of the current period when a change takes effect mid-cycle. Add the charge yourself — put it on the [upcoming invoice](https://www.spacebring.com/docs/billing/invoices/upcoming.md) so the customer pays for those days on their next invoice, or [issue a separate invoice](https://www.spacebring.com/docs/billing/invoices/issue.md) for them now.
>
> 3. If pricing, credits, or day passes must change immediately:
>    * If it's an upgrade, add the charge for the remaining part of the current period to the [upcoming invoice](https://www.spacebring.com/docs/billing/invoices/upcoming.md) to bill it on the customer's next invoice, keeping everything on one invoice, or [issue a one-off invoice](https://www.spacebring.com/docs/billing/invoices/issue.md) to collect it right away.
>    * If it's a downgrade, [issue a credit note](https://www.spacebring.com/docs/billing/invoices/credit-notes.md) for the current month's invoice to refund the necessary amount.
>    * Manually add or deduct [credits](https://www.spacebring.com/docs/billing/credits-and-day-passes/credits.md#view-customer%E2%80%99s-credit-balance) or [day passes](https://www.spacebring.com/docs/billing/credits-and-day-passes/day-passes.md) in the customer's profile.
> 4. If an already invoiced period prevents you from setting the item dates you need, [cancel the subscription](https://www.spacebring.com/docs/billing/subscriptions/cancel.md) and create a new one with the updated items, starting on the date the change should take effect.
>
> **Adding a new company member**
>
> A new person in a company uses the company's subscription, so they don't need one of their own: a personal subscription would give them separate allowances and its own invoice instead of the company's.
>
> 1. Add the person to the company. They get [everything the company's subscription grants](https://www.spacebring.com/docs/customer-management/companies/members-and-managers.md#subscription-related-permissions) — door, printing, exclusive resource access, discounts, and resource assignments — as soon as they are added.
> 2. Add a subscription item for their seat and keep its **Start date** set to **Subscription default**, so it applies now instead of from a future date.
> 3. Bill the remaining part of the current period yourself, as above: that period has already been invoiced, so put the charge on the [upcoming invoice](https://www.spacebring.com/docs/billing/invoices/upcoming.md), or [issue a separate invoice](https://www.spacebring.com/docs/billing/invoices/issue.md) for it now. The item's own price is billed from the next renewal.
> 4. If the company needs more [credits](https://www.spacebring.com/docs/billing/credits-and-day-passes/credits.md#view-customer%E2%80%99s-credit-balance) or [day passes](https://www.spacebring.com/docs/billing/credits-and-day-passes/day-passes.md) for the current period, add them to its balance manually in the company's profile. The item's own credits and day passes arrive at the next renewal.

> [tab] From the next renewal date
>
> If the subscription products remain the same, and you only need to update the price, credit, or day pass allowance, tax rate, or apply a discount coupon starting from the next renewal:
>
> 1. Click the existing subscription item and edit it directly.
>
> 2. These changes will take effect at the next subscription renewal by default.
>
> > [!WARNING]
> >
> > If the customer rents a specific resource (such as a desk, office, parking space, or equipment) and you need to change it to a different resource, change quantity, or remove it starting from the next renewal, schedule it on the **From a specific future date** tab instead of editing the existing item directly. Otherwise, the changes will apply immediately.
>
> **Adding a new company member**
>
> * Add a subscription item for their seat, or edit an existing item, and leave its dates as they are.
> * The new allowances and the new amount both take effect on the renewal date and are billed on that invoice, so there is nothing to bill manually.
> * Add the person to the company on the renewal date. They get [everything the company's subscription grants](https://www.spacebring.com/docs/customer-management/companies/members-and-managers.md#subscription-related-permissions) the moment they are added, so adding them earlier gives them access before their seat is paid for.

> [tab] From a specific future date
>
> If you want changes to take effect on a specific date or month, follow these steps:
>
> **Change membership, resource, rental plan, price, quantity, credits, or day passes**
>
> 1. Click the existing subscription item.
> 2. Set its **End date** to **Custom**.
> 3. Choose the date until which the current subscription item should remain active.
>
> ![Edit subscription item window with the End date set to Custom on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/2b6osWtaz7k-8cpi/images/billing-subscriptions-edit-a-subscription-schedule-changes-for-a-specific-future-date-item-end-date.png?fit=max\&auto=format\&n=2b6osWtaz7k-8cpi\&q=85\&s=86ff22281b70a18095faee39f37a9673)
>
> 4. Add a new subscription item.
> 5. Set up the updated subscription details, and set its **Start date** to **Custom**.
> 6. Choose when the change should take effect (e.g., the day after the old item's end date).
>
> ![New subscription item window with the Start date set to Custom on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/2b6osWtaz7k-8cpi/images/billing-subscriptions-edit-a-subscription-schedule-changes-for-a-specific-future-date-item-start-date.png?fit=max\&auto=format\&n=2b6osWtaz7k-8cpi\&q=85\&s=9bea9959d5fda5c1bdf1cadc08418972)
>
> **Add new products to a subscription**
>
> 1. Click to add a new subscription item.
> 2. Select the new membership or resource, and set its **Start date** to **Custom**.
> 3. Choose when the new product should take effect. ​
>
> **Remove products from a subscription**
>
> 1. Click on a subscription item.
> 2. Set its **End date** to **Custom**.
> 3. Choose when the product should be removed from the customer's subscription.
>
> **Custom item start and end date rules**
>
> When editing subscription item start and end dates, keep the following rules in mind:
>
> * An existing item's end date can't be set earlier than the last day of the current subscription period.
> * A new item's start date can't be set earlier than the first day of the next subscription period. To have the change apply now instead, use the **Immediately** tab.
> * If the next period has also already been invoiced (by advance invoicing or manually by an administrator):
>   * The existing item's end date can't be earlier than the last day of the next period.
>   * The new item's start date can't be earlier than the first day of the period after next.
> * If you set an item's start or end date to mid-cycle, charges are prorated.
>
> **Adding a new company member**
>
> * Add a subscription item for their seat with its **Start date** set to **Custom**, and choose the date the seat should start.
> * The allowances and the amount both take effect on that date, and the amount is prorated when the date falls mid-cycle.
> * Add the person to the company on that same date. They get [everything the company's subscription grants](https://www.spacebring.com/docs/customer-management/companies/members-and-managers.md#subscription-related-permissions) the moment they are added.

## Subscriptions with different cycles, billing dates, or invoices

A subscription's billing cycle can't be changed, and its items are always billed together on its own invoice and renewal date. Two subscriptions are still invoiced separately even when they renew on the same date. To give a customer a different cycle, billing date, or invoice, create a second subscription from the **Subscriptions** section of their profile.

When the customer moves off their current cycle instead of keeping it (for example, from monthly to annual), schedule the old subscription to end first:

1. Click **(...)** next to the necessary subscription > **Edit**.
2. Set **End renewal** to **On date** and choose the date until which the current subscription should remain active.
3. Save the change.
4. In the **Subscriptions** section, click **Create** to set up a new subscription.
5. Set the date when the new subscription should take effect.

![Billing Subscriptions Edit A Subscription Subscriptions With Different Cycles](https://mintcdn.com/spacebring/da8gZ-MMUZ5BvWdS/images/billing-subscriptions-edit-a-subscription-subscriptions-with-different-cycles.png?fit=max\&auto=format\&n=da8gZ-MMUZ5BvWdS\&q=85\&s=e1e59a1644b75a46d2a467b47cb9ebbf)

## Other changes

| Change | How it takes effect |
| - | - |
| Start date | Can only be changed if the subscription has yet to start and the first invoice hasn't been issued. Otherwise, [cancel](https://www.spacebring.com/docs/billing/subscriptions/cancel.md) the subscription and recreate it. |
| [End renewal](https://www.spacebring.com/docs/billing/subscriptions/cancel.md) | Can be set or changed at any time. End date can't be earlier than the last date of the current subscription period. To end immediately, [cancel the subscription](https://www.spacebring.com/docs/billing/subscriptions/cancel.md). |
| Minimum commitment | Takes effect immediately. Its cycles are counted from the subscription's start date, not from the date you edit it or the item's start date. To commit the customer for a number of cycles from today, add the cycles that have already passed, and check the **Commitment period end date** shown below **Cycles**. |
| Auto-update from membership | Takes effect immediately and defines if all the subsequent membership changes apply to this subscription. |
| Auto-update from plan | Takes effect immediately and defines if all the subsequent rental plan changes apply to this subscription. |
| One-off item | When adding a one-off item to an existing subscription, the charge applies to the [upcoming invoice](https://www.spacebring.com/docs/billing/invoices/upcoming.md). The item will be automatically removed from the subscription once the invoice is issued. |
| [Advance invoicing](https://www.spacebring.com/docs/billing/subscriptions/advance-invoicing.md) | Takes effect immediately and affects all the next subscription invoices. |
| [Pause payment collection](https://www.spacebring.com/docs/billing/subscriptions/invoice-issuance.md) | Takes effect immediately and affects all the next subscription invoices. |

## FAQs

> [accordion] Why do I get an error when adding a subscription item with another date?
>
> You may get an error when adding a subscription item with another date because of the following rules:
>
> * A new item's start date cannot be set earlier than the first day of the next subscription period. If the next period has already been invoiced, the new item's start date can't be earlier than the first day of the period after next.
> * If you want to schedule a change (like switching memberships or resources), you must end the current item and add the new one with a start date that follows the end date of the previous item.
> * Subscription item dates must fall within the general subscription period; to schedule a change, set an end date for the specific item only, not the entire subscription.
>
> If you try to add a subscription item outside these rules, the system will show an error. When an already invoiced period leaves no date that works, [cancel the subscription and create a new one](#subscriptions-with-the-same-cycle) instead.

> [accordion] Why is the customer's invoice prorated?
>
> An invoice is prorated when a subscription item's start or end date doesn't align with the full billing cycle — for example, it doesn't start on the first of the month, or it ends before the cycle completes. The customer is then charged only for the portion of the cycle during which the item is active.
>
> For example, if the subscription is set for a 5-day period on a weekly membership (which is normally 7 days), the system calculates a partial charge for those 5 days instead of the full week.
>
> Proration applies to invoices that haven't been issued yet. A period the customer was already invoiced for isn't reopened or recalculated, so [bill its remaining days yourself](#subscriptions-with-the-same-cycle).

> [accordion] How can I automatically apply a surcharge or additional fee to a member's subscription starting from a specific future date (e.g., after a commitment period ends)?
>
> You can schedule their subscription change as follows:
>
> 1. Add a new subscription item for the desired percentage of surcharge to their subscription.
> 2. Set this item's **Start date** to **Custom** and choose the necessary date. ([Detailed guide](https://www.spacebring.com/docs/billing/subscriptions/edit.md))
>
> This subscription item will take effect on the selected start date, increasing their subscription fee until they re-sign another commitment and you remove it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.