Store settings reference
Open Online Stores > Stores and click the store. This page explains every field, tab by tab. Fields that only exist for Shopify stores are marked Shopify.
Header and buttons
| Button | What it does |
|---|---|
| Authorize in Shopify | Only with Install link: opens Shopify to approve the app. |
| Test Connection | Gets a token, reads the shop, locations and Markets, sets Connected. |
| Set Up Webhooks | Creates the webhook subscriptions in Shopify. See Webhooks. |
| Sync... | Bulk operations in the background. See Sync With Store. |
| Check Orders Now | Queues the order check at once instead of waiting for the next 15 minutes. |
| Send All Stock | Sends the quantity of every linked product to Shopify. |
| Use in This Database | Only in a copy of the database. See Test copies. |
The smart buttons show the store's Orders, Products, Customers, Pending Jobs, Log and, when payouts are on, Payouts.
Connection tab
Only Online Stores administrators see this tab.
| Field | Default | What it does |
|---|---|---|
| Shop Address Shopify | The .myshopify.com address. Odoo cleans what you paste (removes https:// and paths, adds .myshopify.com to a bare name). | |
| Connect With Shopify | App in my Shopify organization | How Odoo gets its access token. See Connect the store. |
| Client ID Shopify | Needed unless you connect with an access token. | |
| Client Secret Shopify | Always needed. Also checks webhook signatures. | |
| Access Token Shopify | Only shown with Admin API access token. | |
| API Version Shopify | 2026-10 | API version of every request. |
| Shop Name, Shopify Plan Shopify | Read by Test Connection. |
Webhooks group
| Field | Default | What it does |
|---|---|---|
| Status | Not set up | N active after Set Up Webhooks. |
| Import New Products Instantly Shopify | Off | Also subscribe to new products: a product created in Shopify is imported about 30 seconds later. Click Set Up Webhooks again after changing it. |
| Remove Webhooks | Deletes the subscriptions Odoo created for this store. |
Orders tab
The Orders tab of a store decides how Shopify orders become Odoo sales orders. Open it from Online Stores > Stores, click the store, then the Orders tab.
Import
| Field | Default | What it does |
|---|---|---|
| Import Orders Automatically | On | Every 15 minutes Odoo asks Shopify for orders created or changed since the last check. This is the safety net next to webhooks: orders placed while Odoo was offline or while a webhook failed still arrive. |
| Import Orders From | The moment the store was created | The scheduled check never goes further back than this date. Set it before the first check if you want older orders; leave it if you only want new orders. |
| Last Order Check | Empty | Read only. When the scheduled check last ran. The next check starts from here (minus two minutes, so nothing on the edge is missed). Empty means the next check starts from Import Orders From. |
| Order Prefix | SH- | Added in front of the Shopify order number to build the Odoo order reference, for example SH-1001. The plain store number is also kept in Customer Reference and Store Order Number. Change it before the first import: existing orders keep their names. |
| Order Warehouse | The first warehouse of the company | Imported orders are delivered from this warehouse. |
| Pricelist | Empty | The pricelist of imported orders, and the regular prices sent to the store (see prices). When an order comes in another currency, Odoo uses a pricelist in that currency instead (see below). |
When an order's currency differs from the store Pricelist, Odoo takes the first pricelist of the company in that currency. If there is none, Odoo creates one named after the store and the currency (for example Northwind Store CAD) and activates the currency if needed. If the currency does not exist in Odoo at all, the order stops with Currency XXX does not exist in Odoo.
Sales
| Field | Default | What it does |
|---|---|---|
| Sales Team | Empty | Sales team of imported orders. |
| Salesperson | Empty | Salesperson of imported orders. Empty: the salesperson of the customer, if the customer has one, otherwise none. The background jobs never set themselves as salesperson. |
| Payment Term | Empty | Payment term of imported orders. A payment term on the payment method wins over this one. |
| Fiscal Position | Empty | Optional. Empty: Odoo picks one from the customer address, as for any sales order. |
| Default Payment Journal | Empty | Given to every payment method Odoo sees for the first time in an order, and Register Payment When Paid is switched on for it when a journal is set. Change it per method later in Configuration > Payment Methods. |
Taxes and Extra Lines
| Field | Default | What it does |
|---|---|---|
| Tax Mode | Use the taxes charged by the store | Use the taxes charged by the store: every line gets the Odoo tax mapped to the tax Shopify charged. Use the Odoo product taxes: lines get the taxes of the Odoo product and fiscal position, as in a manual quotation. See taxes. |
| Create Missing Taxes | On | Only with store taxes. When no Odoo tax matches a store tax, Odoo creates one. Off: the order waits in the queue until you map the tax. |
| Shipping Product | Shipping (online store) CB-SHIP | Product of shipping lines, unless the shipping method has its own product. |
| Discount Product | Discount (online store) CB-DISC | Product of the discount lines. |
| Fee Product | Fee (online store) CB-FEE | Product of extra fee lines, for platforms that send fees. |
Status Changes
| Field | Default | What it does |
|---|---|---|
| Cancel Orders Cancelled in the Store | On | An order cancelled in Shopify is cancelled in Odoo, unless it is already delivered or invoiced. |
| Cancel in the Store When Cancelled in Odoo | On | Cancelling an imported order in Odoo cancels it in Shopify. |
| Send Deliveries to the Store | On | When the delivery of an imported order is validated in Odoo, the delivery (with tracking number) is sent to Shopify. |
| Send Tracking Note to the Customer | On | Shown when the field above is on. Shopify tells the customer about the shipment. |
| Import Refunds as Credit Notes | On | Refunds made in Shopify become credit notes in Odoo. |
| Send Credit Notes to the Store as Refunds | On | Posting a credit note for an imported order creates a refund in Shopify. |
What Odoo does after an order is imported (confirm, deliver, invoice, register the payment) is not on this tab. It is set per payment method in Configuration > Payment Methods.
Shopify fields on the Orders tab
| Field | Default | What it does |
|---|---|---|
| Confirm Unpaid Orders Shopify | On | Under Import Orders From. Orders whose payment is pending in Shopify (cash on delivery, bank deposit, other manual payments) are confirmed in Odoo, so the warehouse can ship them. Off: they stay quotations until Shopify marks them paid. See Order status. |
| Refund the Payment When Cancelling Shopify | Off | Under Cancel in the Store When Cancelled in Odoo. When Odoo cancels the order in Shopify, Shopify also refunds the payment to the original payment method. Off: the order is cancelled without a refund. |
| Refund the Money Through Shopify Shopify | Off | Under Send Credit Notes to the Store as Refunds. On: the Shopify refund moves the money back through the original payment. Off: Shopify only records which items were refunded. See Refunds. |
| Restock Refunded Items in Shopify Shopify | Off | Refunded items are put back in Shopify stock (restock type Return). Off: no restock in Shopify. Odoo stock is not changed by this setting. |
Products tab

The Products tab decides how Shopify products are matched with, and created as, Odoo products.
Matching
| Field | Default | What it does |
|---|---|---|
| Match Products By | Internal Reference, then Barcode = SKU | Internal Reference = SKU: a store product matches the Odoo product whose Internal Reference equals its SKU. Internal Reference, then Barcode = SKU: when no internal reference matches, Odoo also tries the Barcode. |
| Import Unknown Products With Orders | On | When an order contains a product that is not linked yet and no SKU matches, Odoo imports that product from Shopify first, then the order. Off: the order waits in the queue with Products not found in Odoo. |
| Category for New Products | Empty | Product category of products created by an import. A store category mapped to an Odoo category wins (Catalog > Store Categories). Empty: Odoo's default category. |
| Import Images | On | Downloads the main image (and variant images) of products Odoo creates, and of linked products that have no image yet. Images over 10 MB or files that are not images are skipped. |
Prices
| Field | Default | What it does |
|---|---|---|
| Send Prices Automatically | Off | Every hour, Odoo sends prices that changed. Off: prices are sent only when you ask. |
| Sale Price Pricelist | Empty | Optional. When this pricelist gives a lower price than the store Pricelist, the lower price is sent as the sale price. |
The regular price comes from the Pricelist on the Orders tab, or the product's Sales Price when no pricelist is set.
Shopify fields on the Products tab
| Field | Default | What it does |
|---|---|---|
| Product Images Shopify | Odoo uploads them to Shopify | How the main image and variant images of products sent from Odoo reach Shopify. Odoo uploads them to Shopify: Odoo uploads the file itself (works when Odoo is not public). Shopify downloads them from Odoo: Shopify fetches a signed link (Odoo must be reachable from the internet). Do not send images. |
| Status of New Products Shopify | Draft | Status of a product created in Shopify from Odoo when you send it as Draft. Choose Active to publish new products directly. Sending with Published always makes the product Active. See Send products. |
Stock tab
The Stock tab decides which quantity Shopify shows for each linked product.
| Field | Default | What it does |
|---|---|---|
| Send Stock Automatically | On | Odoo sends stock when it moves in Odoo (about a minute after the move), and every hour as a safety net. |
| Stock Source | Free to use (on hand minus reserved) | Free to use: on hand minus what is already reserved for other deliveries. On hand: everything in stock. Forecasted: on hand plus incoming minus outgoing. |
| Stock From Warehouses | Empty | The quantity is the sum of these warehouses. Empty: the Order Warehouse only. |
| Stock Buffer | Send the full quantity | Keep back a fixed quantity or Send a percentage, to avoid overselling the last items. |
| Buffer Value | 0 | The quantity to keep back, or the percentage to send. Cannot be negative. |
Quantities are rounded down to whole units and never go below zero.
Shopify locations
Below the stock fields, the Shopify locations list shows every active location read from Shopify, with Fulfills Online Orders, Stock From Warehouses, Send Stock and Active. Read Locations and Markets Again reads them again. How quantities go to each location is explained in Locations.
Markets tab Shopify
| Column | What it does |
|---|---|
| Name, Status, Currency | Read from Shopify. |
| Shopify Price List | The price list of the market's catalog. Empty: the market has no catalog with a price list, so Odoo cannot send fixed prices to it. |
| Odoo Pricelist | The prices sent to this market. Must be in the market currency. Empty: Shopify keeps converting your store price. |
| Compare-at Pricelist | Optional. When it gives a higher price, that price is sent as compare-at (crossed out). |
| Send Prices | Switch off to stop sending to this market. |
| Last Sent | When prices were last sent. |
Send Market Prices Now sends all linked products to every market with a pricelist. See Markets.
Payouts tab Shopify
| Field | Default | What it does |
|---|---|---|
| Import Shopify Payments Payouts | Off | Import paid payouts once a day and on demand. |
| Payout Journal | Required when imports are on. Journal of the payout entries, usually the bank journal the payouts reach. | |
| Fees Account | Required when imports are on. Expense account for Shopify Payments fees. | |
| Payments Clearing Account | Empty | Optional. Where order payments wait for the payout. Empty: the account of each order's own payment. |
| Last Payout Check | Read only. The next import reads payouts issued on or after this date. Odoo sets it two days before the last run, so a payout that Shopify marks paid late is not missed. |
Import Payouts Now queues the import at once. See Payouts.