Submarine subscription configuration options

These configuration options target the subscription behaviour of Submarine, and are configured as part of the initial installation and set-up process. If any of the configuration options need to change following Submarine's launch on the store, a support request is needed for Disco Labs to action.

Subscription configuration

Note: default configuration option is denoted in bold

Name	Description	Options
allow_free_subscriptions	Whether carts with a $0 value can be converted to free subscriptions.	- true - false
allow_subscription_credit	Whether subscription credit can be used when charging for subscription orders.	- true - false
always_recalculate_shipping_rates	Before processing subscription orders, allows reach out to Shopify to get up-to-date shipping and tax rates.	- true - false
automatic_unpause_enabled	A daily cron job finds all customer payment methods that have been created in the last day, looks for a corresponding subscription that has failed capture and swaps out the failing payment method with the new one. This option opts in to that behaviour.	- true - false
code_discounts_recurrence	Indicating whether discounts applied from a discount code to the first order a customer places will be applied to future subscription orders (optionally allowing for ongoing validation). If the validation option is chosen, Submarine will validate the code against its' expiry date and if there is a usage limit in place.	- all_items - all_items_with_validation - no_items
enforce_one_subscription_policy	Describing whether customers can have more than one active subscription. Default is to allow multiple subscriptions (ignore option). If set to pause or cancel, whenever a subscription becomes active, all other subscriptions for that customer will be automatically paused/cancelled. This will be triggered on the creation of a new subscription and on resuming a subscription.	- ignore - pause - cancel
exclude_unavailable_variants	Indicating whether unavailable items (caused by either the Shopify variant has been deleted or the parent product unpublished) should be excluded from subscription orders.	- true - false
failed_capture_retry_frequency	The period between attempts to capture failed payments. Defaults to: 7_days.
failed_capture_retry_limit	The maximum number of times Submarine attempts to capture payment for a subscription order. If the final attempt fails, the subscription is paused. This setting is the total number of payment failures allowed on a subscription order, not the number of ‘retries’. Defaults to 3.
failed_capture_retry_time	The time of day that failed payments should be retried, in the shop's time zone. If not set (the default), the retries correspond to when the last payment attempt failed.
free_shipping_code_filter	If a discount code matching this filter is found on the source order (and `shipping_discounts_recur` is true), the subscription shipping discount percentage will be set to 100%.
include_all_items_in_subscription	If all items in a cart should be included in a subscription when a frequency is defined, then this should be set to true. This setting needs to be confirmed via a checkout note attribute.	- true - false
item_status_tracking_whitelist	To avoid a slew of unnecessary Flow triggers being fired, the `subscription_item_status_updated` trigger is opt-in. This setting defines a whitelist of variant IDs that should be considered when firing the trigger.
line_item_property_filter	A regular expression defining which line-item properties should be persisted from the original order to each generated subscription order. Defaults to all of them.
note_attributes_filter	A regular expression defining which note attributes should be persisted from the original order to each generated subscription order. Defaults to none of them.
order_hour_of_day	If set, ensures that subscription orders are scheduled for the given hour of the day (in the shop's time zone).
reminder_hour_of_day	The hour of day (in the shop's time zone) that the upcoming subscription-order reminder notifications will be scheduled for. Defaults to 0.
reminder_lead_time_days	How many days before the order is scheduled that the upcoming subscription-order notifications will be fired. Multiple values are allowed. Defaults to 2.
script_discount_filter	A regular expression defining what text a script discount title should match. Defaults to *''** (match anything)
script_discounts_message_delimiter	Defines a character or string that is used to separate the script discount message/description between text for the customer and information to pass through to Submarine E.g. `message: "10% off until the end of May! \| ends_at: '2021-05-31', usage_limit: '5', value_type: 'percentage', value: '10'"` The `\|` character can be used as the delimiter and Submarine will parse the information that comes after it. NB. Message is the term used in the Shopify Script Editor app. In Submarine, its equivalent is description.
script_discounts_recurrence	Indicating whether discounts applied by Shopify Scripts to the first order a customer places will be applied to future subscription orders.	- no_items - original_items - all_items
shipping_discounts_recur	Indicates whether discounts applied to shipping lines will be applied to future subscription orders.	- true - false
subscription_frequency_policy	Determines how the subscription frequency is defined for carts that contain at least one subscription item. Either one frequency is set for all items (as a note attribute) or frequencies are defined at the line-item level (via a line-item property). For the latter case, merchants have the option of Submarine creating a subscription for each individual line item, or grouping the items by the frequency and building subscriptions for each unique value.	- order - single_item - grouped_items
subscription_order_prices_synchronised	If true, Submarine will update subscription-order items whenever the price of the associated Shopify variant changes. Note that prices can go in either direction.	- true - false