Skip to main content
Documentation

Setup, in six steps and about twenty minutes

Read it through first if you like, but you can also work down it with your Shopify admin open in the next tab. Step five is the one worth not skipping.

  1. 15 minutes

    Connect the app and place the block

    Install from the Shopify App Store, approve the permissions, then drop the SelfServe block onto your Order Status page in the theme editor.

    Installing asks for two scopes: read and write access to orders, and read access to products if you intend to use the add-products module. SelfServe requests nothing else, and it never asks for customer payment scopes because it has no use for them.

    Once installed, open Online Store, then Themes, then Customize, and switch the page selector at the top to Checkout and accounts, then Order status. Add a block, choose SelfServe order editing, and drag it to where you want it. Directly beneath the order summary is the position most merchants pick, because that is where a customer is already reading their own address.

    Save the theme. The block will not do anything visible yet, because editing stays off until you finish step six.

    On a vintage theme without app block support, skip the theme editor and send us your store URL from the contact page. We add the block manually and it costs nothing.

  2. 22 minutes

    Set the edit window

    Choose how long after checkout a customer may still make changes. The right answer is the gap between an order arriving and somebody in your warehouse touching it.

    In the SelfServe admin, open Settings, then Edit window, and pick one of the presets: one hour, three hours, twelve hours or twenty-four hours. Growth and Scale plans can set any value in that range rather than choosing a preset.

    Work out your figure honestly rather than optimistically. If your pickers start at eight in the morning and orders placed overnight are untouched until then, a twelve or twenty-four hour window costs you nothing. If you pick continuously and a label can print eleven minutes after checkout, use one hour and let the fulfilment check do the rest.

    The window always closes early when a fulfilment is created, so a generous setting is not the risk it first appears to be. What it changes is how many customers get to fix their own mistake before your team has to.

  3. 35 minutes

    Choose which changes are allowed

    Switch on the change types you want to handle automatically and leave the rest with your support team.

    Under Settings, then Allowed changes, you will find one switch per change type: email address, phone number, recipient name, delivery address, and delivery instructions. Everything is off when you arrive, so nothing goes live by accident.

    Start with contact details and delivery address if you are unsure. Between them they account for the large majority of the "can you change my order" messages a store receives, and neither has a pricing consequence for you.

    While you are on this screen, set your guard rails. Cap edits per order at three unless you have a reason not to. If you ship internationally, turn on the restriction that keeps address changes inside the original country, so a customer cannot move a domestic delivery abroad at the domestic rate. Add any order tags that should never be editable to the exclusion list, wholesale and subscription being the usual two.

  4. 45 minutes

    Enable add-products, if you want it

    Optional and off by default. Turn it on when you are comfortable with additions merging into orders that are already placed.

    Open Settings, then Add products, and switch the module on. Then choose which products are eligible: either your whole catalogue, or a specific collection, which is the safer starting point.

    Exclude anything that would break your packing assumptions. Oversized items that need their own box, fragile goods that ship separately, made-to-order pieces with their own lead time, and anything that changes the shipping class of the parcel are all worth leaving out of the eligible set.

    Set the cut-off for additions separately from the main edit window if you need to. Many merchants allow contact and address changes for three hours but additions for only one, because an addition physically changes what has to be picked.

    Add-products is a Growth and Scale feature, but it is unlocked during the fourteen-day trial on every plan so you can decide whether you want it.

  5. 510 minutes

    Place a test order and edit it

    Do not skip this. Run one real order through the whole flow before any customer sees the block.

    Use Shopify's Bogus Gateway, or place a small real order and refund it afterwards. Either works. What matters is that the order is created the same way a customer would create it, so the Order Status page you see is the one they will see.

    Open the confirmation email, follow the link to the Order Status page, and check that the SelfServe block appears where you placed it and that the countdown is showing the window you configured. Then make a change: edit the address to something deliberately wrong, such as a real street with a postal code from another city, and confirm the validator refuses it and explains why. Then correct it and confirm it saves.

    Go back to your Shopify admin and open the order. The new address should already be there, and the timeline should show the change with the previous value alongside it. If both are true, the loop is working end to end.

    Finally, test the closed state. Create a fulfilment on the test order and reload the Order Status page. The edit controls should be gone and replaced by your support message.

  6. 62 minutes, then a week of paying attention

    Go live and watch the first week

    Flip the master switch, then use the change log to check that your window and your rules match what customers actually do.

    Under Settings, then Status, switch SelfServe from Test to Live. The block becomes active for every order created from that moment. Orders placed before the switch are not retroactively editable.

    Over the first week, open the change log and look at two things. First, how many edits are landing close to the end of the window, which suggests the window could usefully be longer. Second, how many customers are hitting the expired state and clicking through to support, which is the volume you have not captured yet.

    Adjust the window once, on the strength of that week, rather than guessing again. Most merchants who start at one hour move to three; few who start at three move back down.

    Tell your support team it is live. The most common early confusion is an agent manually making a change a customer could have made themselves, then wondering why the timeline shows two edits.

Permissions

What the install screen asks for, and why

Shopify shows you a list of scopes when you install any app, and the list is worth reading rather than clicking past. Here is every one SelfServe requests and the reason it needs it.

read_orders, write_orders
To read the current contact details and shipping address on an order, and to write the customer’s change back to it.
read_products
Only requested if you intend to use the add-products module. Needed to show eligible products and check stock.
read_themes, write_themes
To register the Order Status app block so it appears in your theme editor. SelfServe does not modify any other part of your theme.

SelfServe does not request payment scopes, customer list access or analytics access, because none of the six steps above need them. What it stores and for how long is set out in the data handling answer on the FAQ.

Read the merchant FAQ
Get started

Stuck on a step, or on a theme that will not take the block?

Send us the store URL and tell us which step you are on. Vintage themes without app block support are the usual sticking point, and we add the block manually at no cost on any plan.