# Shopify Actions

Connect store data and customer workflows to your AI agent.

## Overview

Shopify actions provide store-specific tools for products, carts, orders, customer profiles, addresses, and account access. Connect the correct store before configuring which tools your agent can use.

## Connect the store

1. Open Build → Actions and select Shopify.
2. Choose Connect Shopify and authorize the store connection.
3. Return to QwryAI and confirm the connected store.
4. Add the action you need from the Shopify action picker.

## Available actions

| Action | Purpose |
| --- | --- |
| Retrieve and display products | Search and display the synced store catalog. |
| Get cart | Retrieve the customer's cart contents. |
| Retrieve and display orders | Retrieve orders and their status. |
| Update Shopify customer profile | Update customer profile values such as name, email, or phone. |
| Update Shopify customer billing address | Update the customer's billing address. |
| Check account & send activation email | Check account access and send an activation link when applicable. |

## Configure and publish

1. Open the action and review its Action name.
2. Write When to use instructions that explain the data it returns or changes and give an example customer request.
3. For products, sync the catalog and wait until it is ready.
4. Use Edit product cards to change the product reply layout in Widget Studio when needed.
5. Choose the supported channels, save the configuration, and Publish.

## Maintain product results

The Products section shows sync status and counts for products, variants, and collections. Use Re-sync products after store catalog changes. Changes saved in the product-card builder apply to new product replies.

## Verify customer workflows

- Ask for a known product and check the displayed price, variant, and destination.
- Test cart behavior from the connected storefront with a test cart.
- Test order lookup with the appropriate signed-in customer context.
- For profile and address updates, review the proposed values and verify the saved result.
- Test unavailable data and connection failures so the agent provides a useful next step.

> **Customer context**: Private order and account operations depend on the connected store and customer context. Do not treat a visitor's typed email address alone as proof of account ownership.

## Manage availability

Use each action's enabled control to manage availability. Deleting a saved Shopify action makes that configuration unavailable immediately; disconnecting the store affects the connected Shopify workflows. Review the confirmation shown by the platform before making either change.