Troubleshooting
Setting up
A test order didn't get its content or keys
Check the product is enabled and has keys, and the block is on your order status page.
- The product isn't enabled. New products start out disabled, and the app doesn't process orders for them. Enable the product, then place a new test order: an order placed before the product was first enabled is never processed. See Enabling and Disabling.
- The product has no license keys. A Download & License product needs keys in its pool before an order comes in. See The order is missing license keys.
- The order status page doesn't show the block. See There's no customer account extension block on the customers' order status page.
Each step of the Onboarding Guide has its own tips for getting unstuck. See Onboarding.
Customers
There's no customer account extension block on the customers' order status page
Check the block is on your order status page, and that the order is in the app.
- The block isn't on your order status page. You add it once, in Shopify's checkout and accounts editor. Check that it's listed under the Order status page's blocks, and that you saved. See Add the Extension to Checkout.
- The customer is on a different page. The block is on the order status page, which customers open from the link in their order confirmation email, or from their account. It isn't on the page they see straight after checkout.
- The app didn't process the order. The block only appears on orders with a product the app processed. If the order isn't on your Orders page, see An order isn't in the app.
- You revoked access to the whole order. Restore it from the order's settings. See Revoke Customer Access.
A download or reveal button is disabled
The tooltip tells you why. Usually no content, no keys, a used-up limit, or a return.
- The product has no content, or you revoked it. The download button reads No Content Available to Download. Link content to the product, which delivers it on past orders too, or restore access.
- The line item has no keys the customer can see. The reveal button reads No License Key Available. See The order is missing license keys, or A customer's license key is gone.
- The customer used their download limit. The download is disabled, or marked Limit Exceeded in a list of downloads. Reset the limit from the order.
- The time limit has passed. The download is disabled, or marked Expired in a list of downloads. Reset the time limit from the order, which restarts the clock.
- The content is disabled. Disabled content can't be downloaded from any order. If its status on the order is Content Disabled, enable it again. See Disabling and Deleting Content.
- The product was returned, refunded or disputed. Every button on it is disabled. See A customer lost access after a return, refund or dispute.
A limit or a return only explains itself if you've written its message: the Download Exceeded Message, the Expiration Message, or the Return Message. Without one, the customer sees a disabled button and no reason. See What Customers See.
A download fails, or a link doesn't open
Download links expire after about two hours, so ask the customer to reload the page.
- The page was open for a long time. For security, download links stop working after about two hours. Reloading the page gives the customer fresh ones.
- The content is a link to a file you host elsewhere, and the file needs signing in, or has moved. Open the link in a private browser window to check. Fix the URL on the content, and every customer gets the working address. See Updating Content.
- The file itself is broken or out of date. Replace it, and every customer who has it gets the new version. See Replacing a file.
A customer's license key is gone
Every key records its history, review it to see what happened.
See Key History.
- Unused Key Restock restocked it, because it was never revealed on the order status page, for example because you sent it by email. You get an Unused License Key Restock alert. Give the customer a key again by editing the order, and use Disable Restock on keys you send another way. See Unused Key Restock.
- A return, refund or dispute took it back. See A customer lost access after a return, refund or dispute.
- Someone on your team returned or restocked it. Its history shows Admin User. Undo the return, or assign the key again, by editing the order.
The block shows an error
It's usually brief, so ask the customer to reload the page.
The block shows your Error Message when it can't load the order, or a reveal fails. If it keeps happening, contact support with the order number. See Error Message.
Orders
An order isn't in the app
Usually, it isn't paid yet, its product was disabled, or it's from before the product went live.
- It hasn't been paid. The app processes an order once it's paid. An order waiting for payment, such as a bank transfer, comes in when it's marked as paid.
- Its product was disabled when it was placed. The app doesn't process orders for a disabled product, and enabling it again doesn't process the orders placed in the meantime. Run Manual Sync on the Orders page, for a date range from the day the order was placed to today.
- It was placed before its product went live, or before you installed the app. Syncs never bring these orders in. Import them instead. See Handling Historical Orders.
- Something went wrong when it was paid, such as Shopify or the app being briefly unavailable. The daily sync usually catches these. To bring it in now, run Manual Sync for a date range from the day the order was placed to today.
The order is missing license keys
Usually, the product ran out of keys. Add keys, then sync the order.
- The product ran out of keys. You get a Failed to assign license keys - Not enough license keys alert. Add keys to the product, then give the order its keys: edit the order, or run Manual Sync on it. See When You Run Out of Keys.
- The order is historical: placed before you installed the app, placed before its product went live, or imported. The app never gives these orders keys from your stock. Add them by editing the order. See Handling Historical Orders.
- Order reconciliation is off for the order, for example because someone edited its keys. Syncs leave it alone, so add the keys yourself by editing the order. See Order Reconciliation.
An order changed on its own
Usually, order reconciliation copied a change from Shopify, and its alert lists what changed.
- Something changed in Shopify. Order reconciliation copies refunds, returns, order edits and new line items from Shopify to the app. Every change it makes raises an Order Updates alert that lists what changed. See Alerts & Notifications.
- It undid your edit. Editing an order's keys, or returning a line item, turns off order reconciliation for that order, so syncs leave your edit alone. If you turned reconciliation back on, the next sync brought the order back in line with Shopify. Make the edit again, and leave reconciliation off. See Edits and Order Reconciliation.
Returns, refunds and chargebacks
A customer lost access after a return, refund or dispute
That's the expected behavior. If you want to undo it, you can manually edit orders via order edit.
What the customer loses depends on what happened:
- A return request takes back the keys for the units being returned straight away, and the content once every unit of the line item is being returned. Declining the return gives it all back, unless a dispute has already taken back the whole order.
- A refund takes back a key for each refunded unit, and the content once every unit of the line item is refunded.
- A dispute, with Chargeback Processing on, takes back the whole order. Nothing comes back when the dispute closes, even if you win.
To give the customer access again, undo the return on the line item, or on its keys, by editing the order. Undoing a return turns off order reconciliation for the order. See Returns, Refunds & Chargebacks.
A customer still has access after a refund or return
Check the order history and the app's logs to investigate. To fix, manually edit the order via order edit.
- Only part of the line item was refunded or returned. The customer keeps the content until every unit of the line item is refunded or returned, and keeps the keys for the units they still have.
- The refund was for an amount, not for items. The app takes back what a refund's items cover. A refund that doesn't include any items, such as money back as a goodwill gesture, leaves the order's items as they were.
- Order reconciliation is off for the order, for example because someone edited its keys, or Unused Key Restock restocked one of them. Refunds reach the app through reconciliation, so a refund on that order changes nothing. Returns always apply. Take access away yourself by editing the order, or revoke it.
- It was a dispute, and Chargeback Processing is off. Disputes don't change anything in the app until you turn it on. To take access away now, revoke it. See Chargeback Processing.
License keys
A returned key wasn't restocked
Keys only go back in stock when it's safe, such as when the customer never saw them.
If any of these is true, the key stays returned instead:
- Auto Restock Inventory is off, for your store or for the product.
- The customer saw the key: they revealed it, or Keys Stay Revealed showed it to them.
- The order is historical: placed before you installed the app, placed before its product went live, or imported. See Handling Historical Orders.
- Restock is disabled for the key.
- The return has only been requested. Keys are restocked once you approve it.
- It was a dispute, and Chargeback Processing is set to RETURN.
If you know the key was never used, you can restock it yourself. See Returning and Restocking Keys.
Shopify keeps selling a product that's out of keys
Usually, check that Auto Sync Inventory is on, and that Shopify stops selling at zero.
- Auto Sync Inventory is off, for your store or for the product, so Shopify's inventory doesn't follow your available keys. See Auto Sync Inventory.
- Shopify sells at zero. On the product in Shopify, turn on Track quantity, and turn off Continue selling when out of stock.
- The app updates a different location. Shopify tracks inventory per location. Check the location set for your store, or for the product. See Choosing a location.
A license key won't add
Usually, it's already in the product, or in another one while keys must be unique across your store.
- It's already in the product. A key can't be in the same product twice, so it's skipped as a duplicate.
- It's in another product, and Enforce Globally Unique Keys is on. Every key must then be unique across your whole store. See Key Uniqueness.
Deleted keys don't count, so you can add a key again after deleting it.
Imports
Some rows failed
Download the report, fix the failed rows in it, and import it again.
The import's results show how many rows were imported, skipped and failed. Download Report shows what happened to each row.
Often, a product in the file isn't set up in the app yet: content, license keys and orders can only be imported for products that are. Import your products first.
Each import lists its other problems, with their fixes: Products, Content, License Keys, and Orders.
An imported order has no license keys
An import only adds the keys in your file, never keys from your stock.
To give it keys, add them to the order's rows and import the file again, or edit the order. See Handling Historical Orders.
An order wasn't imported
Only paid orders, with a customer and a product set up will be successfully imported.
An order with a chargeback isn't imported either. On an order this app already processed, only the line items placed before their product went live are imported. See Which orders are imported.
Staff
A staff member sees Access Denied
Unless default permissions are setup, new staff start with no permissions, until an admin gives them some.
With Authorize all Staff Members off, each staff member can only do what their permissions allow. An admin can give them permissions on the Admin tab of the app's settings. See Staff & Permissions.
A staff member who can't open the app at all needs permission to use it in Shopify first, on their staff account in your Shopify admin.
A staff member can't download an import's report
Only staff who started the import or have the Export permission on the resources can download the report.
An import's report lists every row of its file, so it's only offered to whoever started the import, and to staff with the Export permission for what was imported. See Permissions.
Still stuck?
If the app shows Something Went Wrong!, reload the page. If it keeps happening, or nothing here fits your problem, contact support. It helps us to know your store's .myshopify.com address, the order number, and what you've already tried. We usually reply within 24 hours.