For the complete documentation index, see llms.txt. This page is also available as Markdown.

Settings reference

Every setting in Stork Credit and where to find it.

Stork Credit keeps very little global configuration — most behaviour lives on the individual automation. This page is the map.

Shop settings

Found under Settings in the app navigation.

Promotion stacking

Controls what happens when one order qualifies for several order-value automations.

Option
Behaviour

Stack promotions (default)

Every qualifying rule issues credit; the customer gets the total

Best value only

Only the single highest-value rule issues credit

Full detail: Promotion stacking.

Retry seeding

Appears only when you have a threshold automation that has not finished recording its existing customers. Records every customer that is still missing a position, at their current lifetime spend, and reports the result. No store credit is issued, and customers already recorded are left alone. Use it if a rule stays on "Existing customers are still being recorded" for more than a few minutes. The rule must be active.

Re-baseline threshold progress

Appears only when you have a threshold automation. Re-records every eligible customer at their current lifetime spend, so their next reward is measured from today. No store credit is issued, and past rewards are not reversed — but a customer part-way to their next reward starts that step again. Use it after changing a threshold rule's threshold amount or cap (required before the rule can be reactivated), or if progress ever looks wrong. Runs in the background; the result shows in the rule's run history.

Full detail: Threshold automations.

Per-automation settings

These live on each rule, not on the shop.

Order-value automations

Setting
Options

Credit type

Fixed amount · Percentage

Calculation base

Amount before discounts (default) · Amount after discounts

Applies to

All products · Specific collections · Specific products

Eligibility

All customers · Specific customer segments · Specific customers · Customers with specific tags (tag is exactly · tag starts with)

Uses per customer

Every qualifying order (default) · Once per customer

Minimum requirement

None · Minimum purchase amount · Minimum quantity of items

Maximum purchase amount

Optional ceiling, independent of the minimum

Active dates

Optional start and end, each with time and timezone

Store credit expiry

Never · After a period · On a fixed date

Notify customers by email

On by default · Shopify's store credit email (default) · Stork Credit email

Full detail: Order-value automations.

Scheduled automations

Setting
Options

Amount

A fixed amount per customer

Notify customers by email

On by default · Shopify's store credit email (default) · Stork Credit email

Audience

Customer segment · Specific customers · Customer query · All customers

Schedule

Start date, time, and timezone; optional repeat every n days/weeks/months/years

After issuing

Nothing · Clear a customer metafield · Roll a date metafield forward

Priority

Lower numbers run first when several rules are due together

Store credit expiry

Never · After a period · On a fixed date

Full detail: Scheduled automations.

Threshold automations

Setting
Options

Issue credit every

The lifetime-spend interval between rewards, e.g. $500

Credit amount

Issued each time a threshold is passed

Stop after

Optional lifetime-spend cap. A rule rewards at most 100 levels: with a cap, that is the cap ÷ the threshold; left blank, the rule still stops at first threshold × 100 of lifetime spend. The form shows the exact amount

Notify customers by email

On by default · Shopify's store credit email (default) · Stork Credit email

Audience

All customers · Specific customers · Customer segment · Customer query

Schedule

Start date, time, and timezone; repeats every n days/weeks/months/years

Wait before issuing

Off by default; when on, a hold of n hours or days, up to 180 days

Store credit expiry

Never · After a period · On a fixed date

Only one threshold automation per store — all threshold rules share a single record of each customer's progress.

Full detail: Threshold automations.

Referral code settings

Found under Referral codes. Each code has:

Setting
Description

Code

What customers type at checkout. Can't be changed after creation

Label

Optional note, such as the influencer the code belongs to

Success message

Shown at checkout when the code is accepted. Default: Code Successfully Applied

Status

Active or inactive. Inactive codes are rejected at checkout

Full detail: Referral codes.

External trigger settings

Found under External triggers.

Setting
Description

Enabled

Turns the webhook endpoint on or off without deleting it

Secret

The shared secret; can be regenerated at any time

Full detail: External triggers.

Theme settings

Set in the Shopify theme editor, not in the app. The Storefront widgets page in the app navigation has buttons that open the right editor for you: one turns on the app embed, one adds the cart block, one adds the Referral Code block, and on Shopify Plus one opens the checkout editor.

Setting
Where

Cart block colours

Theme editor → your cart page → Automatic Store Credit block

Stork Credit app embed

Theme editor → App embeds

Referral Code block text and colours

Theme editor → your cart page (or any page) → Referral Code block

Checkout block placement

Settings → Checkout → Customize

Thank you page Referral Code block placement

Settings → Checkout → Customize → page menu: Thank you

Show progress bar (Threshold Store Credit block)

Settings → Checkout → Customize → Threshold Store Credit block

Show earned credit in order confirmation email (Automatic Store Credit block)

Settings → Checkout → Customize → Automatic Store Credit block

Checkout blocks are available only on stores on Shopify Plus. Full detail: Cart & checkout widgets.

Defaults at a glance

Behaviour
Default

Promotion stacking

Stack promotions

Calculation base

Amount before discounts

New automation status

Inactive

Order-value customer notification

Sent, unless turned off

Scheduled customer notification

Sent, unless turned off

Threshold customer notification

Sent, unless turned off

Automation notification email

Shopify's store credit email

Threshold credit for past spending

Not issued — activation records current spend

CSV import notification

Off, unless send_email is set

Flow and external trigger notification

Not sent

Show earned credit in order confirmation email

Off

Order-value uses per customer

Every qualifying order

Referral code success message

Code Successfully Applied

Store credit expiry

Never expires

Currency

Your shop's primary currency

Last updated