--- title: "Show the preorder button on store pages" description: "Turn on the Preorder button for collection pages, your home page, search results, and Quick Buy." url: https://help.stoqapp.com/preorders/show-preorder-button-on-store-pages/ product: "Preorders" section: "Build your offer / Look and storefront" last_updated: 2026-09-28 --- # Show the preorder button on store pages > Turn on the Preorder button for collection pages, your home page, search results, and Quick Buy. Use this guide if you want the Preorder button to appear beyond the product page, on collection pages, your home page, search results, or Quick Buy pop-ups. By the end, customers will see the button (and, where you enable it, a preorder badge) everywhere you choose across your store. ## Before you begin | Requirement | Where to check | |---|---| | STOQ theme app embed enabled | STOQ home page status card: **App embed is enabled** | | At least one active preorder offer | **Preorders** (left menu) → **Offers** tab | If the app embed isn't enabled, the Preorder button won't appear anywhere on your storefront, including the product page. The **Enable the app embed** steps below fix that. ## Choose your setup This only matters if you stock inventory across more than one Shopify location, or sell in more than one Shopify Market. If you fulfill everything from a single location, skip ahead to **Set it up**: no Locations & Markets configuration is needed. Shopify doesn't tell app embeds which location or market a shopper is browsing from on non-product pages, so STOQ needs you to specify it: - **Single market, multiple locations**: turn on **Filter locations** and select the locations that fulfill online orders. - **Multiple Shopify Markets**: turn on **Market-based preorders** instead, and map each market to its locations. This requires a paid STOQ plan. The two are mutually exclusive: choosing **Multiple markets** clears any Filter locations configuration. ## What customers will see The Preorder button already appears automatically on individual product pages once a product has an active offer. Turning on more placements adds the button, and optionally a badge, elsewhere in your store: - **Collection pages**: the button on each product card in the list, plus an optional badge that flags a product whenever any of its variants is on preorder, even if the variant shown on the card isn't. - **Home page and search results**: the same button wherever your theme lists products. - **Quick Buy pop-ups** and **home page Featured product sections**: the button inside these theme widgets, on paid plans where the STOQ team has built the integration for your theme. > **Note** > > These placements add the button and badge, not a price. On collection, home, and search cards the price stays your theme's regular price, even when your offer has a discount. The discounted preorder price only shows on the product page, and in Quick Buy and Featured product where those integrations are set up. See [Set up discounts](https://help.stoqapp.com/preorders/preorder-discounts/). None of this changes checkout or sends any notification: it's a display change only. Confirmation emails, shipping updates, and payment charges only happen when a customer completes a preorder at checkout, which is controlled by Shopify's checkout, not by these placement settings. ## Set it up On a phone, this menu is collapsed. In the **Shopify mobile app**, tap the **STOQ** logo at the top of the screen to open it, then choose the section named below. There is no hamburger icon. See [Finding the STOQ menu](https://help.stoqapp.com/general/getting-started-with-stoq/#finding-the-stoq-menu). Enable the app embed once, then choose which pages show the button. If you stock across multiple locations or sell in multiple Markets, also complete the Locations & Markets steps that match your setup from Choose your setup above. ### Enable the app embed 1. **Check the STOQ home page** Open STOQ and look at the **Preorders** status card. If it shows "App embed is not enabled," click **Activate**. STOQ will attempt to enable the embed automatically. [Image: The STOQ Preorders status card with the Activate button for the app embed](https://help.stoqapp.com/images/general/s4.png) 2. **Enable manually if needed** If automatic activation isn't available, your browser opens the Shopify Theme Editor at the correct screen. 1. Turn on the **STOQ** toggle. 2. Click **Save** in the top-right corner of the Theme Editor. [Image: The Shopify Theme Editor App embeds panel with the STOQ toggle and Save button](https://help.stoqapp.com/images/general/s11.png) ### Turn on page placements 1. **Open the Pages & Locations editor** 1. In the left menu bar of the STOQ app, click **Preorders**. 2. Click the **Settings** tab. 3. Click the **Pages** sub-tab. 4. Click **Customize**. This opens the **Pages & Locations** editor. [Image: The Preorders Settings Pages sub-tab with the Customize button](https://help.stoqapp.com/images/general/t1.png) 2. **Choose a page type** The left sidebar shows two sections. Under **Pages**: - **Product page**: no toggle needed; the button appears automatically based on your offer's inventory settings. - **Collection, home & search**: click to expand this group, then select the sub-page you want to configure: **Collection page**, **Home page**, or **Search page**. - **Custom pages**: for non-standard page layouts; contact the STOQ team via this section to arrange an integration. Under **Advanced**: - **Locations & Markets**: configure how STOQ evaluates inventory for non-product pages. This is where you set up the setup you picked in Choose your setup, above. - **Dev mode**: for eligible merchants, exposes CSS selectors and insertion-type options for custom theme positioning. [Image: The Pages & Locations editor left sidebar with the Pages and Advanced sections](https://help.stoqapp.com/images/general/t2.png) 3. **Enable the page** Inside each page section, check the box labelled **'Preorder' on [Page name]** to add the button to that page's product list. [Image: A page section with the 'Preorder' on page checkbox](https://help.stoqapp.com/images/general/t3.png) 4. **Configure badge settings (collection page only)** When the collection page is enabled, a **Badge settings** sub-section appears. Check **Show badge if any variant is a preorder** to display a preorder badge on a product card whenever at least one variant is under a preorder offer, even if the currently displayed variant isn't. [Image: The Badge settings sub-section with the Show badge if any variant is a preorder checkbox](https://help.stoqapp.com/images/general/t4.png) 5. **Enable Quick Buy** After you enable a page, a second checkbox appears: **'Notify me' / 'Preorder' on Quick Buy - [Page name]**. This checkbox is disabled unless you're on a paid plan and an integration for your theme already exists. - If the integration exists and you're on a paid plan, the checkbox is active: toggle it on. - If you're on a paid plan but no integration exists yet, a **Request setup** link appears next to the description. Click it to notify the STOQ team. - While a request is pending, a **Requested** badge appears on the checkbox and it stays disabled until the integration is complete. [Image: The Quick Buy checkbox with a Request setup link](https://help.stoqapp.com/images/general/t6.png) 6. **Enable Featured product sections (home page only)** On the home page, an additional checkbox, **'Notify me' / 'Preorder' on Featured products - Home**, appears after you enable the home page toggle. Like Quick Buy, it requires a paid plan and a team-built integration. Click **Request setup** if the integration doesn't yet exist for your theme. [Image: The Featured products on Home checkbox with a Request setup link](https://help.stoqapp.com/images/general/t5.png) 7. **Save your changes** Click **Save changes** in the top bar. The button becomes active on the selected pages immediately. You don't need to publish your theme again beyond the initial app embed activation. ### Single market: turn on Filter locations Open **Locations & Markets** under **Advanced** in the left sidebar of the Pages & Locations editor. 1. **Select 'Single market'** Select the **Single market** radio button. [Image: The pages editor sidebar with Locations & Markets under Advanced](https://help.stoqapp.com/images/general/t7.png) 2. **Enable Filter locations** Turn on the **Filter locations** toggle. A list of your Shopify locations appears below it. [Image: The Filter locations toggle on, with the list of Shopify locations](https://help.stoqapp.com/images/general/t8.png) 3. **Select the locations tied to your Online Store** Check every location whose inventory should count toward the Preorder button decision on collection, home, and search pages. Typically these are your warehouse or fulfilment-centre locations, not retail-only locations that can't ship online orders. 4. **Save your changes** Click **Save** in the top-right corner of the editor. STOQ now restricts inventory evaluation on non-product pages to the selected locations. [Image: Single market Filter locations with a location checked and the Save button](https://help.stoqapp.com/images/general/t9.png) ### Multiple markets: turn on Market-based preorders Open **Locations & Markets** under **Advanced** in the left sidebar of the Pages & Locations editor. 1. **Select 'Multiple markets'** Select the **Multiple markets** radio button. This automatically clears the Filter locations setting, since the two modes are mutually exclusive. [Image: The Locations & Markets section with the Multiple markets radio button selected](https://help.stoqapp.com/images/general/t10.png) 2. **Enable Market-based preorders** Turn on the **Market-based preorders** toggle. A **Settings** section expands below. 3. **Map each market to its locations** For each Shopify Market: 1. Select the market from the **Select market** drop-down. 2. Search for and select one or more inventory locations linked to that market. 3. Click **Add**. Repeat until every market you sell in has at least one location mapped. STOQ shows the Preorder button on non-product pages only when the selected locations have stock that triggers preorder conditions for that market's customers. [Image: Mapping a Shopify Market to its inventory locations with the Add button](https://help.stoqapp.com/images/general/t11.png) 4. **Save your changes** Click **Save** in the top-right corner of the editor. STOQ saves the page-toggle settings immediately and the market-location pairs shortly after. ## Check your setup 1. Open your storefront and go to a collection that contains at least one product with an active preorder offer. 2. The **Preorder** button should appear on that product's card in the list. 3. If it doesn't, confirm the STOQ home page status card shows **App embed is enabled** with a green check mark, then work through Troubleshooting below. ## Troubleshooting ### The Preorder button doesn't appear on a collection, home, or search page Confirm that page type is turned on in the Pages & Locations editor and that the STOQ app embed is enabled. ### You turned the page toggle on but the button still doesn't show Confirm the product has an active preorder offer under **Preorders** (left menu) -> **Offers** tab. For product-page issues like offer status, variant, or market restrictions, see [Troubleshoot the preorder button](https://help.stoqapp.com/preorders/troubleshooting-preorder-button-display/). ### The Quick Buy or Featured product checkbox is greyed out It needs a paid plan and a theme integration built by the STOQ team. Click **Request setup** if you haven't already; a **Requested** badge means it's already pending. ### The button shows up in the wrong place on a non-standard collection layout Use **Dev mode** (if available on your account) to set custom CSS selectors and an insertion type, or contact the STOQ team via **Custom pages**. ### The button shows on collection pages for products that aren't actually on preorder Turn on **Filter locations** (single market) or **Market-based preorders** (multiple markets) so STOQ stops summing inventory across every location. ### You changed your Shopify theme Re-enable the app embed in the new theme's editor. Your page and Locations & Markets settings stay as they were and apply automatically once the embed is on. ## Limitations - Quick Buy and Featured product placements need a paid plan and a per-theme integration that the STOQ team builds after you click **Request setup**, typically ready in 12-24 hours. - Custom or non-standard page layouts aren't covered by the standard page toggles; use **Dev mode** (if enabled on your account) or contact STOQ via **Custom pages**. ## FAQ ### Do I need to configure anything for the button to show on the product page? No. The product page button is automatic once a product has an active preorder offer, no Pages & Locations setup needed. This guide covers the other, opt-in placements. ### Does turning on these placements notify or charge customers, or change existing orders? No. Showing the button on collection, home, search, or Quick Buy is a visual change only. It doesn't send any notification or charge, and it has no effect on orders already placed. Notifications and charges only happen when a customer completes a preorder at checkout. ### How long does a Quick Buy or Featured product integration take? After you click **Request setup**, the STOQ team typically completes the integration within 12-24 hours. You'll get an email and an in-app chat message when it's ready. ### I sell in multiple Shopify Markets. Do I need Filter locations or Market-based preorders? Use **Market-based preorders**, which requires a paid STOQ plan. It maps each Shopify Market to one or more inventory locations, so STOQ evaluates only the locations relevant to each customer's market. Filter locations is for single-market stores only. ### Does Filter locations affect the button on the product page? No. The product page always uses accurate per-variant inventory data regardless of this setting. Filter locations and Market-based preorders only change how STOQ evaluates inventory on non-product pages, where Shopify doesn't give app embeds per-customer location context. ## Related guides - [Button not showing? Troubleshoot](https://help.stoqapp.com/preorders/troubleshooting-preorder-button-display/): The full checklist for when the Preorder button doesn't show or looks wrong. - [Preorder markets](https://help.stoqapp.com/preorders/preorder-markets/): Configure per-market inventory settings for collection and list pages. - [Preorder inventory settings](https://help.stoqapp.com/preorders/preorder-inventory-settings/): Control when the Preorder button appears based on inventory levels. - [Design the preorder widget](https://help.stoqapp.com/preorders/design-preorder-widget/): Customize the Preorder button's text, colors, and style across your store. - [Test your preorder offer](https://help.stoqapp.com/preorders/test-your-preorder-offer/): Verify the Preorder button and checkout flow before going live.