Editing blocks reference
Editing blocks are the customer actions managed inside the main Order Editing experience. You choose which blocks are enabled, configure each one, and arrange the order customers see.
Open App Settings > Editing blocks to manage them.
Available editing blocks
Editing block | What it lets customers do |
|---|---|
Change the shipping address and use address verification when configured | |
Switch an option or replace an ordered product | |
Product Quantities | Increase or decrease quantities and remove products when allowed |
Search for eligible products and add them to the order | |
Choose an eligible shipping method and, when configured, another delivery date | |
Update the order email address or phone number | |
Download a PDF invoice | |
Request or complete a cancellation using the configured refund behaviour | |
Add or update a gift message | |
Customer-Editable Metafields | Update the supported order metafields and attributes you configured |
Switch an eligible uncaptured payment method | |
Product Carousel | Browse products that can be added to the existing order |
Post-Purchase Discount Codes | Apply an eligible discount code after checkout |
Support Tickets | Submit a support request from the order page |
Reschedule Delivery is configured on the Delivery page and appears inside the Shipping Methods customer flow. It is not a separate row in Editing blocks.
Enable and configure a block
- Open App Settings.
- Select Editing blocks.
- Select the block you want to configure.
- Turn on its main setting and complete its options.
- Save your changes.
Each block has its own conditions. For example, file uploads need Shopify Files permission, payment switching depends on the original payment state, and product or shipping changes depend on what Shopify can offer for that order. Use the linked setup article when a block needs additional configuration.
Arrange the customer order
The order of the rows in Editing blocks controls their order in the customer experience.
- Find the drag handle beside a block.
- Drag the block to the intended position.
- Repeat for the other blocks.
- Save the new order in the save bar.
Put the actions customers use most often near the top. Searching for a block returns the list to its normal, non-reordering view.
Install the main Order Editing block
Enabling an editing block does not install it in Shopify.
Add the main Order Editing app block to each Shopify page where customers should use it:
- the Thank You Page for the experience immediately after checkout;
- the Order Status Page for customers returning to their order later.
Open App Settings and use the installation checklist or Install app blocks action to open the relevant Shopify editor. Save the page configuration in Shopify after adding the block.
Standalone upsell placements can use separate app blocks. Those are managed by the relevant upsell setup guide and are not controlled by the Editing blocks list.
What determines whether a block appears
An enabled block appears only when every required layer allows it.
Layer | What to check |
|---|---|
Installation | The main Order Editing block is installed and saved on the page the customer is using. |
App status | The app is Live, or the customer email matches a staff domain while the app is Draft. |
Block setting | The block is enabled and its required options are complete. |
Editing window | The order is still inside the allowed editing period. |
Editing rule | The matching rule permits the feature for this order. |
Order state | Shopify still allows the requested product, payment, address, shipping, cancellation, or fulfilment change. |
Restrictions | No global restriction or feature-specific limit blocks the action. |
Editing Rules and Automations can give different orders different deadlines or editing features. An enabled block can therefore appear for one order and be hidden for another.
How successful changes reach Shopify
- A no-cost change can update the existing order without another payment.
- A price increase can require the customer to authorise an additional payment.
- A price decrease follows your configured refund or store-credit behaviour.
The final result is written to the existing Shopify order. Use that order, its payment activity, and its timeline to confirm what succeeded.
Check a missing block
Check the layers in the table above from top to bottom. Then open Order Insights on the Shopify order to review the current editing status and matching rule.
After changing a setting, reload the customer page before checking again. Reuse the same eligible order where possible. Create a new order only when the feature depends on information fixed at order creation or the existing order is no longer eligible.
