Skip to main content
A package is the template a customer subscribes to: your subscription plan. Create and edit packages to define what customers can subscribe to. To view your packages:
  1. Log in to your Marzipan account
  2. Click on Subscriptions in the main navigation menu
  3. Select Packages
Subscription package detail screen

Creating and editing a package

1

Choose the type

A package starts with its Type:
  • Variable - you choose the products in each shipment, and shipments go out on the dates you set
  • Pick & Mix - the customer chooses their own products, within the limits you set, and each shipment goes out on the anniversary of their first order
  • Fixed - one product on repeat. Subscribers choose how many and how often, and it is sent with each payment. See Product subscriptions
A package’s type can’t be changed once it has subscribers. From then on the form shows the type with a note saying so.
2

Set the basics

  • Name - the package name shown to customers
  • Slug - the URL-friendly identifier
  • Summary and Description - short and long copy for the storefront
  • SKU - the package’s stock-keeping unit
  • Minimum no. of required items - for a saved pick & mix package, the fewest items a customer must choose
  • Collections - the collections the package belongs to
  • Availability - Everyone, or subscribers only
  • Status - Active, Draft, Archived, Out of Stock or Unavailable
On a multi-market store you also choose which markets the package is visible in.
3

Add images

The Images gallery is the package’s storefront gallery, and can hold video as well as images.
4

Set the pricing

Set the package’s Price. For multi-market stores, per-market pricing tabs let you override it for each market.A pick & mix package also has a Pricing Type:
  • Fixed Price - customers pay the same price whichever items they pick
  • Per-Item Pricing - customers pay for each item they pick. There is no package price to set, and the package page shows the price as Per item
5

Choose the billing frequency

Under Billing frequency, choose the frequencies you want to allow: Monthly, Quarterly, Bi-Annually or Annually.If you offer more than one, set a Default billing frequency. Customers pick their frequency on the storefront, shown as boxes or a dropdown, with your default pre-selected. See Product. The default is also what’s used anywhere the choice isn’t offered.
The frequency a customer chooses is recorded on their cart, so the subscription is created on the terms they were shown rather than on whatever the package defaults to by the time the order lands.
6

Configure the renewal options

Renewal options control how and when subscriptions renew, and for a variable package how billing and shipments fit together. See Shipment dating and Renewal options below.
7

Choose what subscribers can do

Decide whether customers can skip, move or bring forward a shipment from their account, and which packages they can switch to. See What subscribers can do and Switching package below.
8

Set the inventory

Under Inventory Management, leave Quantity blank to not track stock. The package stays in stock unless you set its status to Out of Stock.
9

Save the package

Review the package and save it. Set the Status to Active when you are ready for customers to subscribe.

Shipment dating

A Variable package chooses, under Billing and shipments, how payments and shipments fit together:
  • Scheduled dates - every subscriber is billed together on the shipment’s processing date. Each shipment carries a processing and shipping date
  • Availability window - each subscriber is billed on their own anniversary and sent whichever shipment is available on that date. Each shipment carries an available-from date and an optional available-to date
  • Shipments on their own dates - each subscriber is billed on their own anniversary, and every subscriber is sent the package’s dated shipments, with nothing sent in between. See Shipments on their own dates below
The form explains whichever option you choose.
The Billing and shipments setting on a variable package, set to Shipments on their own dates

Availability windows

Use an availability window when what you send is “whatever is in the package right now” rather than a dated release. Leave the available-to date empty and the window stays current until a later one supersedes it, so you simply open a new window when the contents change.
Windows for the same product may not overlap, and an open-ended window blocks any later one. Marzipan rejects an overlapping window when you enter it rather than picking between them at renewal.
Windowed packages drop the parts of the scheduled flow that have no meaning without a processing date: the First order cut off window and the initial shipment. A new subscriber simply gets whichever window is current, the same shipment a renewal would get.
Editing a window never moves anyone’s billing date, so you can correct or extend one without disturbing your subscribers.

Shipments on their own dates

Choose this when payments and shipments don’t line up: a monthly payment for a shipment every quarter, say, or a membership that sends a few shipments a year.
  • Payments - each subscriber pays on their own anniversary at the frequency they chose. A payment sends nothing on its own
  • Shipments - on each dated shipment’s processing date, every active subscriber is sent it, however recently they joined. Those who skipped it are left out, and so is anyone whose payment is failing, until they’ve paid
  • Joining - the first order sends nothing, so checkout charges no delivery for it. It still asks where shipments should go (and a gift recipient’s address), and quotes what each shipment will be charged for delivery when it ships. The wording is on the Labels tab
  • Delivery - each shipment is charged delivery on its own order, at the rate at the time, unless you turn on Delivery included or the subscriber collects
  • Extras - items a subscriber adds go in their next dated shipment, and are charged on its order with its delivery
  • Skipping - holds back the shipment only. Their payments carry on as normal
A package like this has no initial shipment. You can also run one with no dated shipments at all, where the payment buys the package’s benefits. This option adds three settings to the renewal options: Delivery included, Minimum term and Shipment notice. Requires shipping isn’t shown, since every shipment is posted. A shipment that can’t be sent to a subscriber is held rather than lost. See Held shipments.

Renewal options

Renewal options control how and when subscriptions renew:
  • First order cut off window - the first order is processed and dispatched immediately, unless it is placed within this many days of the next scheduled shipment. Only on scheduled dates
  • Auto renew - renew subscriptions automatically
  • Requires shipping - turn off if renewals don’t need shipping. See A package that sends nothing
  • Delivery included - send each shipment with no delivery charge. Off, your delivery rates apply to each shipment. On fixed packages and packages with shipments on their own dates
  • Minimum term - how many months subscribers commit for before they can cancel from their account. Leave it empty to let them cancel at any time. Only on packages with shipments on their own dates
  • Shipment notice - email subscribers this many days before each shipment, so they can check their address or skip it. Leave it empty to send nothing. Only on packages with shipments on their own dates
  • Grace period - the number of days after the subscription expires when renewal is still allowed
  • Free renewal - conditions that, when met in the current period, renew the subscription for free
  • Send renewal emails - reminders sent 30, 21, 14, 7 or 3 days before the next processing date, and 1 day into the grace period
The shipment notice is the Subscription shipment email, editable under Settings > Notifications. Only subscribers the shipment will actually go to are sent it.
Within a minimum term, the customer’s account says the date they can cancel from instead of offering the button. Staff can always cancel from the admin.
If a renewal payment fails, Marzipan retries it before cancelling the subscription. See Failed renewals.

What subscribers can do

Each package decides what a customer may do to their own subscription from the account area. Not every package can honour every action: a twice-yearly package has no stock to send early, while a monthly one does.
  • Customers can skip a shipment - miss the next shipment. The payment moves on with it, except on a package with shipments on their own dates, where payments carry on as normal. On by default
  • Shipments they can skip at once - how far ahead they can skip before the next one has to come, from 1 to 12. One shipment at a time unless you say otherwise
  • Customers can move a delivery - push the next shipment back to a later date. Off by default
  • Customers can send a shipment early - charge and send the next shipment immediately. Only worth offering where there is stock to send. Off by default
Cancelling is deliberately not on the list. It is always available (after any minimum term), and an account that cannot cancel is a trap. The account asks for a reason before it confirms, and offers whichever of the above answers what the customer said, so it never offers a save this package would then refuse. See Cancelling and reactivating.
Pausing has been withdrawn in favour of skipping. Subscriptions already paused come back on the day they said.

Switching package

Customers can switch to lists the packages a subscriber on this package may move to from their account. Leave it empty and switching isn’t offered, which is where every package starts.
The Customers can switch to list on a package
Any other subscription package can be listed, including drafts, so you can line up a new package before it goes live. Subscribers are only ever offered the ones that are active.
List packages in both directions if you want subscribers to be able to move back. Listing a smaller package on your larger one doesn’t offer the larger one to subscribers of the smaller.
The Change package chooser in the customer account
When a subscriber switches:
  • Nothing is charged on the day. The change applies from their next payment, at the new package’s price, and that payment is never brought forward: it falls a whole billing period after their last one, at the new frequency
  • Their frequency is kept where the new package sells it. Otherwise it moves to the new package’s default, and they’re told so before they confirm
  • A variable package with scheduled dates starts on its first shipment from that date. Where it has a shipment sooner, the subscriber may choose to start with that one instead, which brings their payment forward to it
  • Extras follow onto the next shipment, and pick & mix choices are cleared when they leave a pick & mix package
Switching isn’t offered on a gift subscription, or while the next shipment is already being processed. The customer is sent a Subscription Package Changed email, editable under Settings > Notifications, saying what their next payment will be and when. Team members can opt into a Customer changed subscription package notification under Settings > Team.
The account also offers a switch when a customer goes to cancel: a cheaper package where they say it costs too much or they’re cutting down, and any listed package where they don’t enjoy it. See Cancelling and reactivating.

A package that sends nothing

Turn off Requires shipping on a package that is never posted anything, such as a local membership paid for its perks. Subscribers then aren’t asked to choose delivery or collection, in their account or in the admin, and their subscription has no Shipments tab or Next shipping date. Its highlights show the next payment instead.

Benefits

A package’s Benefits are the discounts its subscribers get. They are listed on the package’s Overview, and each is a discount that requires the customer to have an active subscription, either to this package or to any package. Click Add on the Benefits card to create a discount with this package already chosen under Package must be one of. See Creating a discount. Each benefit shows its status, the code to use or applied automatically, and any per-customer allowance. One open to every subscriber is marked every package. Running benefits are listed first. The New Subscription, Gift Subscription Revealed and Subscription Package Changed emails carry a Benefits block listing the running benefits, with the code to use or a note that they apply automatically at checkout. It shows nothing when the package has none.
To introduce the benefits in your own words, put a line inside the has benefits condition in those emails, under Settings > Notifications. It only shows when there is a benefit below it. The default emails start with “As a subscriber, these are yours too:”.

The package page

Click a package to open it. Its Overview shows:
  • Highlights - active, paused and cancelled counts, Total Revenue, Average LTV (per subscriber lifetime value) and Recurring Revenue
  • Latest subscribers - the 10 most recent, with View all opening the Subscribers tab
  • Package Details - the package’s settings at a glance, with Edit
  • Benefits - see Benefits
Depending on the package type, extra tabs are available: The Subscribers tab lists everyone on the package, filtered by status and searchable by name or email.

Package shipments

A variable package’s Shipments tab is in three sections:
  • On joining - the initial shipment a new subscriber is sent. Only on scheduled dates
  • Upcoming - the shipments to come, with their dates and status
  • Completed - shipments already sent, newest first. Five are shown, with Show all for the rest

Available items

For pick & mix packages, the Available Items tab is where you choose which items customers can pick from. For each item you set:
  • The default quantity
  • The minimum quantity
  • The maximum quantity