Shopify · 6 min read
Shopify product page checklist: catch mobile and variant problems
Test product options, cart contents and mobile controls with a practical Shopify product page checklist. Separate missing content from issues that need a developer.
Start a Shopify product page check by selecting an option other than the default, adding it to the cart and comparing the actual item with your selection. Repeat on a real phone and a desktop, then check the product information and controls. Record reproducible failures before paying for a redesign or changing apps.
This checklist helps define a project. It does not establish why a particular store has low sales or promise a conversion increase.
Can a shopper understand the product?
Read the page as someone who has not spoken to your team. The product name and photographs should establish what is being sold. The description should explain the details a buyer needs to choose, rather than rely on a campaign headline to do all the work.
The important details differ by category. Clothing may need garment measurements and fit context. Furniture may need dimensions, materials and assembly information. Lighting may need dimensions and installation information. Use accurate information from the brand; a developer should not invent specifications to fill a layout.
Record each missing detail and where it should appear. A content correction may solve the problem without a new page design.
Does variant selection match the cart?
Shopify treats a combination of product options, such as size and colour, as a variant. The theme should update variant-specific information when the selection changes. That is why checking only the highlighted size button is not enough: compare the relevant image and price as well as the selected options. Shopify's variant implementation guide.
Choose a product with more than one available option. Start with an empty test cart, select a size or finish other than the default, add it, and check the resulting cart item. Repeat with an unavailable option if your catalogue has one, checking against the store's intended availability and preorder settings rather than assuming every sold-out option must behave identically.
Also test quantity changes and going back to the product page. Describe the actual result rather than assuming the theme, an app or Shopify itself is responsible. A reproducible example helps a developer identify the cause.
Use this suggested test matrix. These are checks to run, not findings about your store:
| Test | What to compare | Evidence to save if it fails |
|---|---|---|
| Select a non-default size and colour | Selected options versus the cart's size and colour | A recording from selection through the cart |
| Change from one available option to another | Options, relevant imagery and variant-specific price | The two combinations and what stayed stale |
| Use the normal button, then a sticky button if present | Each route should add the same intended item | Which button was used and its position on screen |
| Open a shared link to a specific variant | The starting selection versus the intended linked variant | The exact public product URL |
| Add the item, update quantity, then remove it | Cart contents and quantities after each action | The step where the displayed result diverges |
Shopify supports links to specific variants, so a visit from a shared product link deserves a separate check from opening the default product page. The variant guide documents this behaviour.
If the wrong item enters the cart, ask the developer to trace the selection into the add-to-cart request. For themes using Shopify's Ajax Cart API, the request identifies the item by its variant ID. This gives the investigation a concrete comparison; it does not establish which script caused the mismatch. Shopify's Cart API reference.
Do not place real orders just to test a layout. Agree on the appropriate test process for your store before testing payment behaviour.
Is the mobile journey clear?
Use a real phone when you can. Look at the product information, image gallery, option controls and add-to-cart action. Check that menus or overlays do not cover the controls you need.
Try the page with a longer product title, several options and a product that has a different image shape. A layout that works for one short title can still fail elsewhere in the catalogue.
Record the browser and approximate screen size with each issue. A screenshot shows the appearance; a short recording is more useful for a sequence of taps that fails.
Repeat the failing sequence in a fresh tab and note whether it happens immediately after loading or only after another interaction. Try the same product on another browser if available. Differences narrow the investigation; they do not prove the first browser or a particular app is at fault. Avoid uninstalling several live apps as an experiment.
Is this a content task, a layout task or a functional repair?
Sort the evidence before commissioning work:
| Observation | First question to resolve |
|---|---|
| Dimensions or garment measurements are missing | Does the brand have accurate information ready to add? |
| The information exists but an overlay hides it on a phone | Can the layout or overlay behaviour be corrected? |
| A selected size differs from the cart item | Where does the selected variant stop matching the submitted item? |
| One product fails while others work | What differs in its options, template or app configuration? |
Ask for work on a preview or duplicate theme where appropriate. Shopify recommends duplicating a theme before customization. A theme copy does not isolate every app setting or product-data change, so agree separately on any changes outside the theme.
Are purchase questions answered clearly?
Identify questions customers regularly ask before buying. Depending on the product, these may concern fit, dimensions, delivery, returns or care. Make the answers accessible and consistent with your actual policies.
Do not add badges, delivery promises or review counts simply because a competitor displays them. The information should be true for your business. If a detail varies by product or destination, explain the condition.
Write the development brief
Group the work into content, layout and functional behaviour. For each item, include the affected URL, current state, expected state and the check you will use to accept it.
For example: “Selecting the medium size should add the medium variant to the cart on mobile and desktop” is more useful than “make the product page convert.” It gives both sides a concrete result to review.
Our Shopify preparation guide covers the wider working process. The Mianzi project is an example of our work across homepage, collection and product pages; the product photography illustrates the brand, not a claim of measured sales results.
If you want help implementing the changes, explore Shopify development at FixTheLeak or send your store URL and issue list.
Sources checked November 20, 2026. This checklist concerns theme-based storefronts; headless stores, bundles, subscriptions and accelerated purchase flows need additional checks suited to their implementation. The tables are a proposed review method, not a record of tests performed on a client store.