> ## Documentation Index
> Fetch the complete documentation index at: https://watermelon.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Shopify
Connect your Shopify store to Watermelon and let your AI agent support customers with actions, such as showing products, retrieving orders, managing carts, and updating customer details.
Available on: **Starter, Advanced, Business, and Enterprise**.\
Shopify uses **Actions**. Free plans do not include Actions.
Before connecting Shopify, make sure:
* You are on a plan that includes Actions.
* You have access to the Watermelon agent you want to connect.
* You have permission in Shopify to install apps.
* You know your Shopify store URL.
* You have decided which Shopify actions your AI agent is allowed to use.
## What you’ll do
1. **Select your agent**\
Choose the AI agent you want to connect to Shopify.
2. **Add Shopify as an action**\
Go to Actions and select Shopify.
3. **Choose the allowed Shopify actions**\
Choose which Shopify actions your agent is allowed to use.
4. **Authorize Watermelon in Shopify**\
Review the requested permissions and install the Watermelon app in Shopify.
5. **Test and activate**\
Test the connection in draft mode before making it available to customers.
## Method 1: Connect Shopify from Watermelon
We recommend connecting Shopify directly from Watermelon. This allows you to choose the agent you want to connect and configure which Shopify actions the agent can use.
In Watermelon, go to **Agents**.
Select the agent you want to connect to Shopify.
In the selected agent, navigate to **Actions**.
Click **Actions**, then select **Shopify**.
Give this Shopify connection a clear name.
For example:
* `Shopify store`
* `Main webshop`
* `Watermelon Shopify connection`
Use a name that helps your team recognize the connection later.
Choose which Shopify actions your Watermelon agent is allowed to use.
You can select one or more of the following actions:
Allows your agent to search for products in Shopify and show them to customers in the chat.
Allows your agent to retrieve order information and display it in the chat.
Allows your agent to help customers view or update their shopping cart.
Allows your agent to update customer profile information.
Allows your agent to update a customer’s billing address.
Only enable the actions your agent needs.
Actions that update customer details or billing addresses can change information in Shopify. Only enable these actions if your team has tested the full flow and is comfortable with the agent making these updates.
Fill in your Shopify store URL.
For example:
* `your-store.myshopify.com`
* `https://your-store.myshopify.com`
Then click **Connect**.
We recommend using your `myshopify.com` URL when connecting your store. Custom domains, such as `www.example.com`, may not always identify the correct Shopify store.
Shopify will open and ask you to authorize Watermelon.
Review the requested permissions carefully, then click **Install**.
After the installation is approved, you’ll be redirected back to Watermelon.
You’ll see a confirmation message once Shopify is connected to Watermelon.
You need the right permissions in Shopify to install apps and approve access for Watermelon.
After connecting Shopify, the action is first created in **draft mode**.
This means your customers cannot use it yet.
Use the **Playground** to test whether your agent responds correctly. For example, you can test questions like:
“Can you show me blue sneakers?”
“Can you help me check my order?”
“Can you add this product to my cart?”
“Can you update my billing address?”
Check whether the agent gives accurate answers and uses the Shopify actions as expected.
Once you are satisfied with the test results, activate the Shopify action.
After activation, your customers can use the Shopify functionality in the chat widget.
We recommend testing the full customer flow before activating the Shopify action.
## Method 2: Connect Shopify from the Shopify App Store
You can also connect Watermelon from the Shopify App Store.
Use this method when you prefer to start the installation from Shopify instead of from Watermelon.
Installing the app from Shopify only starts the connection. You still need to select an agent and choose the allowed Shopify actions in Watermelon.
Go to the **Shopify App Store** and search for **Watermelon**.
Open the Watermelon app listing and click **Install**.
Shopify will show the permissions Watermelon needs to connect with your store.
Review the permissions and click **Install** to approve.
After installation, you’ll be redirected to Watermelon to complete the setup.
Select the agent you want to connect to Shopify and configure which Shopify actions your agent is allowed to use.
After setup, test the Shopify action in the Playground and activate it when you are ready for customers to use it.
## Next steps
Once Shopify is connected, you can decide how Shopify information should appear in the chat widget.
Show Shopify products visually in the chat widget.
Display order information clearly inside the chat widget.
## Troubleshooting
### I do not see Shopify under Actions
Make sure you selected the correct agent and that Shopify actions are available in your Watermelon account.
If you are on the Free plan, Shopify will not be available because Free plans do not include Actions.
### Shopify does not let me install the app
Check whether you have permission to install apps in Shopify. You may need help from the Shopify store owner or an admin.
### I entered my Shopify URL but cannot connect
Check that the URL is correct and belongs to the Shopify store you want to connect.
We recommend using your `myshopify.com` URL, for example `your-store.myshopify.com`.
### I installed the app but was not redirected to Watermelon
Go back to Watermelon, go to **Agents**, open the **selected agent**, and check whether Shopify appears under **Actions**.
If Shopify does not appear, try starting the setup again from Watermelon.
### The connection is live, but customers cannot use it
The Shopify action may still be in draft mode.
Test it in the Playground first, then activate it when you are ready for customers to use it.
### The agent does not show products correctly
Make sure the **Retrieve and display products** action is enabled.
Also check whether the product exists in Shopify and is available in the connected store.
### The agent says it cannot access order information
Make sure the **Retrieve and display orders** action is enabled.
The customer also needs to provide enough order details for the agent to identify the order.
### The agent does not update customer details or billing addresses
Make sure the correct action is enabled:
* **Update customer profile**
* **Update customer billing address**
Only enable these actions after your team has tested the full flow.
### I want to change the enabled Shopify actions later
Go back to the Shopify action settings in Watermelon and update the selected actions.
After making changes, test the flow again in the Playground before activating it for customers.
### I already connected a Shopify store
Check whether the current agent already has a Shopify action configured.
If you want to connect a different store, create or update the Shopify action for that agent.