Documentation

Report a Story Theme bug to support

Something in the theme isn't working? Check the common causes, reproduce the problem and send us a complete report.

A button that doesn't respond, a section that displays badly, a cart that doesn't update: if you think you've found a bug in the Story Theme, a precise report helps us reproduce it and fix it much faster.

1. Rule out the most common causes

Many problems don't come from the theme. Before you write, check:

  • The right theme: are your changes made on the published theme, and not on one of your draft themes? If you use Shopify Markets, also check that the right market is selected in the editor.
  • Your version: the bug may already be fixed in a newer version. See Find the installed theme version and the Road Map.
  • Apps: an app can add code that conflicts with the theme. Temporarily turn off its app embeds in the theme editor, then test again.
  • Your browser: test in a private window or in another browser, to rule out a cache or extension problem.
  • Shopify settings: a bundle discount that doesn't apply, for example, often comes from a missing automatic discount in Shopify. See Quantity discounts.
The dashboard strip: the Your version box shows the installed version and whether it is up to date
The dashboard strip: the Your version box shows the installed version and whether it is up to date

2. Reproduce the problem

Try to make the problem happen several times and write down:

  1. the page concerned (copy its address);
  2. the exact actions that trigger the problem, in order;
  3. what should happen, and what happens instead;
  4. the device and browser (for example: iPhone, Safari; computer, Chrome);
  5. whether the problem shows up on desktop, on mobile, or both.

3. Take a screenshot

A picture beats a long description. Take a screenshot that shows the problem (and, if possible, the address bar). If the problem is a movement or an animation, record a short video and share it with a link.

4. Send it to us

  1. In your member area, open Contact (Support section of the sidebar).
  2. Click Something else, then the second Something else to show the form.
  3. Enter your store's address in Your site (optional).
  4. In Subject, sum up the problem: for example "Add to cart button not working on mobile".
  5. In Your message, paste your notes from step 2.
  6. Click Add a file to attach your screenshot (a JPG, PNG or WebP image, 5 MB max), then Send the message.
The Contact page with the Something else topic expanded: the second Something else, at the bottom, opens the form
The Contact page with the Something else topic expanded: the second Something else, at the bottom, opens the form
Screenshot to take — Member area > Contact > Something else > Something else: form filled in with a sample bug (subject "Add to cart button not working on mobile", message with steps, page link), a screenshot attached

Even if you're not sure it's a bug, write to us: we'll tell you whether it comes from the theme, a setting or an app.

An idea rather than a bug?

To suggest an improvement to the theme, use the Suggest an improvement button at the bottom of the Road Map.

Learn more