Sales Studio

Your Shopify Store

Sell direct from your own Shopify store? Connect it once in Settings and its sales count alongside everything else in Sales Studio.

How it works

Your store connects to your whole account, not to one pen name. If you publish under several pen names and sell all of them from one store, connect the store once. Each sale is counted under the pen name of the book that sold.

Rolling out gradually

Store sales are rolling out to accounts in stages, so you may not see the store card yet.

Connect your store

  1. Go to Settings → Sales Integrations (or Sales Studio → Shopify store) and find the Your store card. It's rolling out gradually, so you may not see it yet.
  2. If your store is already connected to one of your pen names (for example, from a title's Shopify panel), it's listed there. Click Use this store for sales.
  3. Otherwise, type your store's address (your-store or your-store.myshopify.com), pick the pen name to connect it through, and click Connect store. Shopify asks you to approve the connection, then brings you back to StorytellerOS. Click Finish connecting to connect the store for sales. (Finish within 15 minutes, in the same browser you started from.)

Note

Which pen name you connect through doesn't matter for your sales figures. It's only the route we use to reach your store. The store still sells for all your pen names.

Approve order reading

Stores connected before October 2026 were only allowed to manage products, not read orders. If the card shows Needs permission, click Approve in Shopify. Shopify opens a page where you approve one more permission on the connection you already have (there's nothing to reinstall). Then come back and refresh the card.

If your store is connected with its own Shopify custom app, add order reading to that app's Admin API scopes instead, then reconnect the store.

If the card says Shopify is still approving order access for StorytellerOS, there's nothing for you to do. Your store is connected, and its sales will start importing automatically once Shopify finishes its review. Your other sales figures are unaffected while you wait.

How orders are imported

  • The first import brings in your store's whole order history. A big store can take a few rounds: the card shows importing your order history and a running count until it's done. After that, new orders and changes come in every couple of hours, and Sync now in Sales Studio fetches the latest straight away.
  • Each sale is counted on the day the order was placed (UTC), per product, in the currency the order was paid in.
  • Royalty for a store sale is what the buyer paid for the book after discounts, without tax or shipping, minus anything you refunded. A refund or cancellation later updates that day's figures automatically.
  • Unpaid, voided, failed and cancelled orders are left out.
  • We never import your buyers' names, emails or addresses.
  • The card shows the last import and how many orders have been imported.

Match your Shopify products

Sales Studio needs to know which book each store product is. Open Sales Studio → Mapping and find Match your Shopify products.

  • Products whose SKU matches a format's SKU, or whose barcode is the format's ISBN, are matched for you.
  • For the rest, StorytellerOS suggests the title and format it thinks each product is, and whether it looks like a box set. Suggestions are only pre-selected: nothing is matched until you click Confirm. Pick a different title, or Not a book for merchandise and gift cards.
  • Merch in many colors or sizes? Tick the products you want, or use Select all variants of this product, then click Not a book once for all of them. Their sales still count in your store total and leave the unmatched sales list too. Show products set aside lists them, and Put back returns one to the list.
  • Tips your readers add at checkout are not products, so they never appear here. Sales Studio counts them as store income, never as a book sale.
  • Confirming counts all that product's past and future sales under the title, saves the SKU on the format if it didn't have one, and adds the product page to the title's store links under "your-store (Shopify)". If the format already has a link to that same product page, that link is used instead of adding a second one.

Tip

Matching needs Sales edit access to your whole account. Adding the store link and SKU to the title also needs edit access in Project Studio; without it, the sales are still matched and someone with that access can add the link.

If your retailer analytics also report your store

Your connected retailer analytics may already include your store's sales as a "Shopify" line, product by product. Your store's own figures count for its whole imported history, and wherever the analytics also report a product's Shopify sales for the same period, that amount is left out, so nothing is counted twice. While a long history is still importing, the months it hasn't reached yet stay as your retailer analytics reported them and switch over as the import gets there.

Sometimes the analytics file a book's Shopify sales under its Amazon ASIN instead of the store product. When you have one Shopify store and you've matched that book's format to one of its products, those are replaced by your store's own figures too.

If you sell through more than one Shopify store, each store takes over only its own products. Analytics Shopify sales that can't be tied to a product of a connected store are kept as reported, so a store you haven't connected is never lost. With a single store, sales of products you've since removed from it are replaced by the store's own figures too, when the analytics name them the way your store's orders do. The store card reminds you to check those for doubles.

Connected the same store twice?

If the same store is connected to two of your pen names, StorytellerOS recognises it as one store and keeps one sales connection for it, so nothing is counted twice.

List your books in the store

The same connected store is where Publishing Studio lists your books for sale. Open a book's publish wizard and use Sell on Shopify in the Distribute step: it adds the book as a draft, then puts it on sale when you click Publish. Books from any of your pen names can be listed in the one store. See Selling on your Shopify store.

Disconnect

Click Disconnect on the store and confirm. We stop importing its orders and remove the sales already imported from it. If removing them doesn't finish, the store shows Disconnecting with a Finish disconnecting button to try again. The store stays connected to your pen name for anything else you use it for, such as listing books, and you can connect it for sales again at any time.

Tip

Teammates with Sales access to your whole account can see the store under Sales Studio → Shopify store. Connecting and disconnecting it needs Sales edit access to the whole account.

Which plan includes it

Store sales are part of the Storyteller tier. If the card says your account isn't on it and you think it should be, contact support.