Installation & setup

Install Stork Credit, review the permissions it asks for, and switch on the cart and checkout widgets.

Install the app

1. Open Stork Credit on the Shopify App Store and click Install.

2. Review the permissions (below) and approve.

3. Stork Credit opens on the Plans page and asks you to choose a plan. This is step 1 of 2, and the rest of the app stays closed until you've picked one — Continue on Free is a perfectly good answer and keeps you on the free plan indefinitely.

4. You land on the Stork Credit home page inside your Shopify admin.

Step 2 is a short survey asking what you plan to use the app for. It takes a few seconds and helps us prioritise what to build next — you can dismiss it.

Permissions

Permission	Why it is needed
Read customers	Find the customer to credit, and resolve segments for scheduled rules
Write customers	Create a customer when an email address has no account yet
Read orders	Read line items, discounts, and totals when an order-value rule runs
Read products	Check whether an order's products are in a targeted collection
Manage store credit transactions	Issue the credit itself
Read store credit accounts	Read balances for the Customers' Store Credit report and reminder emails
Manage metaobjects and definitions	Store your automation rules in your shop, so they survive app reinstalls

Turn on the storefront widgets

The widgets are optional — automations work whether or not they are visible. They exist to tell customers what an order will earn before they buy.

Cart widget (theme block)

Open Storefront widgets in the app navigation. Each button opens the theme editor in a new tab with the change already made, so all you do is save.

1. Click Turn on app embed. The theme editor opens on App embeds with Stork Credit switched on. Click Save.

2. Click Add to cart page. The theme editor opens with the Automatic Store Credit block added to your cart page, showing a sample amount so you can see it.

3. Drag the block where you want it, and set the background, text, and accent colours to suit your theme.

4. Click Save.

The block shows nothing until the app embed is enabled — the embed is what tells the block the current cart contents and customer.

Prefer to do it by hand? In the Shopify admin go to Online Store → Themes → Customize, open your Cart page, choose Add block → Apps → Automatic Store Credit, then open App embeds in the left sidebar and enable Stork Credit. Save.

Checkout widget

The Checkout widget needs a store on Shopify Plus — Shopify only allows app blocks in checkout on that plan. On any other plan, skip this step. The Cart widget above works on every plan.

1. On the Storefront widgets page, click Open checkout editor, or go to Settings → Checkout → Customize.

2. Add app block → Automatic Store Credit.

3. Position it where you want and Save.

Full detail on both widgets, including when they stay hidden: Cart & checkout widgets.

Pick a plan

You choose your plan the first time you open the app (see Install the app above). The Free plan allows one active automation and 20 rows per CSV import — enough to test the app end to end.

Open Plans in the app navigation to move up or down at any time. See Plans & billing.

Verify it works

The fastest end-to-end check:

1. Create a rule that credits a small flat amount on every order — see the Quickstart.

2. Place a test order on your store with a customer account attached.

3. Mark the order as paid.

4. Open the automation's Runs tab. A run should appear within a few seconds.

5. Open that customer in the Shopify admin and confirm the store credit balance.

Rules run when an order is paid, not when it is placed. An unpaid or pending order will not trigger anything.

Uninstalling

Uninstalling stops all automations immediately. Credit already issued stays with your customers — it is native Shopify store credit and belongs to the customer accounts, not to the app.