Plan & usage
Mergify needs a plan to merge orders. Plan & usage is where you choose one, see how much of it you have used and what each merge cost, raise your usage cap and cancel.
Plan amounts (monthly price, included merges, price per shipment saved, usage cap) change over time and are not written here. Plan & usage shows the current numbers for your store.
Shopify handles the billing. You approve each plan and each cap change on Shopify’s own page, and Shopify bills Mergify’s charges on your Shopify invoice.
Your plan at a glance
Section titled “Your plan at a glance”When you have a plan, the page opens with a card for it:
- the plan’s name, a Current plan badge (and Free trial during the trial) and its price;
- a bar showing how many included merges you have used in the last 30 days;
- the price you pay for each shipment saved once the included merges are used, and how many extra merges you made;
- your Usage cap, and how much of it is used once you are close to it (see Usage cap);
- a worked example, such as a merge of 3 orders, saying whether it is included or what it costs.
Below it come How charges work, the list of merges of the last 30 days with what each cost, and the plans you can choose.
Choosing a plan
Section titled “Choosing a plan”Each plan card shows its monthly price, the included merges (“In any 30 days”), what you pay per shipment saved after them, who the plan suits and what it includes: manual merges and Smart Suggest on every plan, Automerge and Orders up to 180 days old only where the card lists them. Starter’s card also tells you roughly how many shipments a month it takes before a paid plan costs less.
To choose a plan:
- Compare the cards. Look at the monthly price together with what you would pay after the included merges, not at the monthly price alone. The more orders you merge in a month, the more the included merges are worth. If you need unattended merging, pick a plan whose card lists Automerge.
- Select Choose plan on the plan you want (on a store with no plan yet, Starter’s button reads Start free instead).
- Approve it on Shopify’s page. Nothing changes until you approve.
If you come back from Shopify without approving, the page says Approve {plan} on Shopify to start it and keeps your current plan until you do. Select Continue on Shopify to reopen the approval page, or Choose another plan to go back to the cards.
When you approve a new plan, your previous plan ends and the new one starts. A few things carry over:
- Usage. Changing plan doesn’t reset anything. Mergify counts the included merges you used in the last 30 days against the new plan’s allowance, so a bigger plan gives you its allowance minus what you already used.
- Automerge. If the new plan includes it, your schedule stays as it is. If it doesn’t, Automerge turns off, and it stays off when you later choose a plan that has it: turn it on again in Automation.
- Order history window. The longer window in Advanced needs a plan that lists Orders up to 180 days old.
If your plan is no longer offered, Plan & usage still shows your plan’s own terms on its card, and the list is headed Choose a plan. You can stay on it or choose one of the plans shown.
Promo codes
Section titled “Promo codes”Enter a code in Promo code and select Apply. The plan cards then show the discounted price, how many months it lasts and the price after. The code applies to the plan you choose next, not to a plan you already have, and not to the free plan. Select Remove to drop it. If someone sent you a link with a code in it, the code is applied when the page opens.
Mergify answers This code isn’t valid for a code it doesn’t know, and This code isn’t available for your store for one your store can’t use.
How charges work
Section titled “How charges work”- A merge uses one included merge, whether it combines 2 orders or 20. Included merges are counted merge by merge.
- After the included merges, a merge is charged the plan’s price per shipment saved, for each shipment it saves: the number of orders minus one. A merge of 3 orders saves 2 shipments, so it costs twice the price per shipment.
- Included merges count over the last 30 days. A merge frees its included merge 30 days after it ran. There is no reset date: not your billing date, not the start of the month.
- The monthly price and the per-shipment charge are separate. The monthly price is the subscription. The per-shipment charge is added only to merges made after the included ones, and Starter has no monthly price.
- Previews are free, and so are failed merges. Mergify charges only when a merge finishes.
- Undo doesn’t refund the charge.
- Merges from Automerge and from your AI assistant are charged like any other merge.
- At your usage cap, merges that would be charged pause until your billing cycle renews or you raise the cap. Included merges keep working.
Before you create a merge, Review merge shows what it costs. The charge is recorded as a step of the merge and shows in its details in History.
Usage in the last 30 days
Section titled “Usage in the last 30 days”Under Usage in the last 30 days, every merge of the last 30 days is a row with its date, the merged order, Originals, Shipments saved and Charge. Select a row, or View in History, to open the merge. The line under the table adds them up: merges, how many were included, how many were extra and what they cost, how many were not charged and how many failed.
Charge reads:
- Included when an included merge covered it;
- an amount when it was charged;
- Not charged when the merge went through but Shopify refused its charge;
- No charge when the merge finished without a charge, and No charge (failed) when it failed.
Usage cap
Section titled “Usage cap”Shopify limits what an app can charge you in each billing cycle: your usage cap. It is set on your Shopify subscription, and your merges’ per-shipment charges count toward it. The cap starts over when your billing cycle renews, which is not the same as the 30 days for included merges. A plan that never charges per shipment has no usage cap.
When you have used a large part of it (80%), Plan & usage warns you with You’ve used {used} of your {cap} USD usage cap this billing cycle, and the Usage cap line shows how much is used and when it renews.
When a merge would cost more than what is left under your cap, Mergify doesn’t run it. Nothing is created and you aren’t charged:
- Before you merge, the review says Can’t merge: this merge would cost {amount} USD and your usage cap is reached, and no button to create the merge is offered. You can select Raise your cap or go back.
- A merge that was already queued ends as Failed · nothing was created. Its steps read Usage cap reached: this merge would have cost {amount} USD, so nothing was created and you weren’t charged, and your orders are left as they were.
- Automerge skips the groups that would be charged. Automation counts them (“skipped at the usage cap”) and they stay in Smart Suggest.
- Merges your plan includes keep working.
Once the cap is reached, Smart Suggest in Orders shows a banner, and so does Automation while Automerge is on. The Overview adds a row to Needs attention that opens the raise window.
Raise your cap
Section titled “Raise your cap”- Select Raise your cap. It shows when you are close to your cap (about 80% used) or have reached it: on Plan & usage, on those banners, in the Needs attention row and in the blocked review. Below that, Plan & usage shows only a plain Usage cap line. While a raise waits for your approval, it offers Continue on Shopify instead.
- In Raise your usage cap, enter the New cap. It is filled in with twice your current cap, and it must be higher than the current one.
- Select Continue on Shopify and approve the new cap there.
Raising the cap doesn’t charge you anything, and the price per shipment saved stays the same. Paid merges resume once Shopify confirms the new cap. Until then Plan & usage says Approve the new {amount} USD cap on Shopify to resume paid merges; select Continue on Shopify on that banner to reopen the approval. If you don’t approve, your cap stays as it was, and the notice goes away after two days. If Shopify doesn’t answer, the window says so; try again in a moment.
Free trial and Starter
Section titled “Free trial and Starter”Free trial. The paid plans start with a free trial. Their cards show {n}-day free trial with the days left, and your plan card shows Free trial, the date it ends and a First charge line with the date and the monthly price. The next charge follows every 30 days.
The trial covers the subscription only. Merges after your included ones are charged during the trial as usual.
Merges during the trial are real merges. Your merge settings still cancel or archive the originals, refund shipping and email your customers. Check Merge settings before your first merge.
Starter has no subscription fee. It includes free merges every month (counted over any 30 days, like the other plans), and merges after those are charged per shipment saved. Plan & usage shows how many are included. A store with no plan chooses it with Start free; with a plan, the button reads Choose plan.
Two older versions of Starter still exist on some stores, and their plan card says an older version of Starter:
- One counts its included merges in total and never resets them. When they are used up, merging is paused: the page tells you to choose a plan to keep merging, and See plans takes you to the cards. Smart Suggest, History and undo keep working. This version never charges per shipment and has no Cancel subscription button.
- The other counts its included merges in any 30 days, then charges per shipment saved, like today’s Starter. Its plan list doesn’t offer today’s Starter.
Cancelling
Section titled “Cancelling”Select Cancel subscription on your plan card. The window Cancel your {plan} subscription? tells you what happens:
- your plan ends now;
- Automerge turns off (if your plan had it), and choosing a plan again doesn’t turn it back on;
- per-shipment charges stop, on Starter;
- charges already made stay: cancelling doesn’t refund usage;
- your settings and history are kept;
- to merge again, you choose a plan.
Select Keep plan to leave things as they are, or Cancel subscription to confirm. If Mergify can’t cancel, it says so and your plan is unchanged: try again.
If a charge looks unexpected
Section titled “If a charge looks unexpected”- Open Plan & usage and find the merge in Usage in the last 30 days. Check its Originals and Shipments saved: the charge is per shipment saved, not per merged order.
- Check whether it was included. Included merges free up one at a time as older merges pass 30 days, not on your billing date.
- Check your plan’s terms on its card, and the trial dates if you are in a trial.
- If it still looks wrong, contact support (see Getting started) with the merge, the plan name, the dates and the amount you expected. Don’t send card details or passwords.
