Gorgias AI Agent actions for Shopify: what it can change and how to set it up safely

Jay Biros

Founder

jay-biros

November 9, 2026

6 min read

Diagram of one message passing a gold check point and fanning out to six actions, with one action running

Short Answer / TLDR

Gorgias AI Agent can take six Shopify order actions: cancel an order, edit the shipping address, remove an item, replace an item, reship for free and add an order note. Before launch, set conditions, turn on Customer confirmation, add each action to a skill and test on a fake customer profile.

Below is what Gorgias's own docs say as of Nov 3, 2026: which Shopify actions exist, where they stop, and the setup order we'd follow.

Who this is for: Gorgias admins and support leads on Shopify. You need the Owner, Admin or Lead role and a plan with AI Agent.

Which Shopify actions can Gorgias AI Agent take?

Gorgias's Shopify actions article lists six actions:

Action	What AI Agent does
Cancel order	Checks the order is unfulfilled, cancels it, restocks the items, refunds the full amount and emails a confirmation
Edit shipping address	Checks the order is unfulfilled, asks the shopper to confirm the new address, then updates it in Shopify
Remove order item	Checks the order is unfulfilled, confirms the items, removes and restocks them, refunds their amount and emails the updated order
Replace order item	Swaps one item for another (for example, a different size), checks stock, restocks the removed item, and refunds the difference if the new total is lower
Reship order for free	Duplicates and resends an order that's lost in transit or arrived damaged, at no charge to the shopper
Add to order note	Adds a note you write to the Shopify order, for example "address updated by AI Agent"

If Gorgias is already connected to your Shopify store, there's no extra connection step to use these actions. One catch from Gorgias's setup guide: if you connected Shopify before you subscribed to AI Agent, you may need to update your app permissions so AI Agent can access the Shopify data it needs.

For which Gorgias features work on which store platforms, see our post on Gorgias features that are Shopify-only.

Where do the Shopify actions stop?

These limits come straight from Gorgias's docs, so plan around them before you switch anything on:

Shopify only. Cancel order and Edit shipping address change the order in Shopify only. The change doesn't pass to your 3PL or fulfillment app.
No price adjustments on address changes. AI Agent can't tell whether a new address changes taxes or shipping costs, so it won't refund or charge the difference.
One item per replacement. Replace order item swaps one item for one item. If a shopper wants to add or remove two or more items, AI Agent hands the ticket to your team.
Extra payment goes to a person. If a replacement raises the order total, AI Agent hands the ticket to your team to collect the payment.

Watch out: if orders reach your 3PL soon after checkout, add an Order Date condition (Gorgias's example is "less than 2 hours ago") so AI Agent doesn't cancel in Shopify after the order has already gone to fulfillment.

How do you set up Shopify actions safely?

Here's the order we'd follow, using Gorgias's own controls:

Open the library. Go to AI Agent > Actions. If you have more than one Shopify store connected, pick the store first; each store's AI Agent has its own library. Connecting Shopify adds its pre-built actions, like Cancel order and Edit shipping address, automatically.
Set conditions. Open the action and choose All conditions met or Any condition is met, then add variables from the customer profile, the order or the shopper's inputs. For example: Fulfillment status (Order) Is not Fulfilled.
Turn on Customer confirmation. AI Agent asks the shopper to approve before it acts, and if they decline, the action doesn't run. Gorgias turns this on automatically for irreversible actions like canceling an order; for other actions, you turn it on yourself.
Add the action to a skill. Actions installed from a connected app only run when you add them to a skill or guidance. In AI Agent > Skills, open the skill (for example, Cancellations), select Actions in the editor and pick the action.
Test it in the Playground. Go to AI Agent > Playground, open Settings and turn on the Actions toggle. By default, test conversations don't use actions at all. Gorgias warns that actions in a test can change real customer and order data, so target a fake customer profile. Actions installed from a connected app have to be in a skill or guidance before you can test them.
Watch the logs after launch. Each action has an event log with the time, status (Success or Error) and ticket ID, and a Usage tab that shows which skills and guidance include it and how often it ran. Select an entry to see the request, response and any error messages. Then check the order itself: on a sample of tickets, open the order in your Shopify admin and confirm the change is there. The order's Timeline shows its detailed history, including payment events, which Shopify says help when you troubleshoot a refund. If the action includes an Add to order note step, a note like "address updated by AI Agent" shows your team which orders AI Agent changed.
Check each skill's trend after edits. In AI Agent > Skills, open a skill, select Performance, then Trend to see how its handovers and CSAT changed over time, with a marker for each version you published.

What happens when an action fails?

AI Agent runs an action's steps in order. If a step fails, the action stops, no further steps run, and the ticket is handed over to your team. The event log shows which steps succeeded and which failed.

An action can also show as Failed in your library, which Gorgias says usually means a disconnected app or expired credentials. Disabling an action stops AI Agent from using it right away, even if a skill still includes it.

Before a busy week, filter the library by Status and open anything marked Failed or Review. Review means an action is missing required settings, so complete the missing fields.

How do you keep a human in the loop?

You have three levers beyond the action settings:

Handover. AI Agent hands over to your team when it can't respond confidently, hits a sensitive topic or detects frustration, and you can add your own handover topics on the AI Agent > AI Coverage page.
Turn an intent off. Any conversation type (intent) you turn off goes straight to your team. Gorgias now lists every intent on one page, AI Agent > AI Coverage (formerly Intents), labeled AI handling or Handing over.
AI reasoning. On any ticket, you can see why AI Agent responded the way it did.

For the policy decisions to make before AI Agent acts on orders, see our post on what Gorgias AI Agent needs before it acts on orders.

For actions over text messages, see our post on Gorgias AI Agent actions over SMS.

Want help setting up Gorgias AI Agent actions?

Smart Instinct is a Gorgias Managed Services Partner with 400+ helpdesk implementations. We can map your order policies to conditions, skills and handover rules, and test them before AI Agent touches a live order. See our Gorgias implementation page, or:

Book a free 15-minute call

FAQ

What Shopify actions can Gorgias AI Agent take?

Gorgias's Shopify actions article lists six: Cancel order, Edit shipping address, Remove order item, Replace order item, Reship order for free, and Add to order note.

Can Gorgias AI Agent cancel an order that has already shipped?

The Cancel order action checks that the order is unfulfilled first. It also changes the order in Shopify only, not in your 3PL or fulfillment app, so Gorgias suggests an Order Date condition if orders reach fulfillment quickly.

Does Gorgias AI Agent ask before it changes an order?

It can. With Customer confirmation on, AI Agent asks the shopper to approve before it acts. Gorgias turns this on automatically for irreversible actions like canceling an order.

Can I test Gorgias AI Agent actions without touching real orders?

Test conversations don't use actions by default. If you turn actions on in the Playground, they can change real data, so Gorgias recommends targeting a fake customer profile.

What happens if a Gorgias AI Agent action fails?

The action stops at the failed step, no further steps run, and the ticket is handed over to your team. The action's event log shows which steps succeeded and which failed.