Merchants can make their products available through [local pickup](https://help.shopify.com/manual/shipping/setting-up-and-managing-your-shipping/local-methods/local-pickup), and you can display whether a specific product variant is available for local pickup on the product page. This allows customers to view this information without having to add the product to cart and proceed to checkout to view the shipping details. In this tutorial, you'll learn how to show variant pickup availability on product pages. ## Requirements - [Variant selection](/docs/storefronts/themes/product-merchandising/variants#variant-selectors) functionality. The pickup availability [JavaScript function](#the-javascript-function) needs to be run when variants are selected. ## Resources To implement pickup availability, you'll use the following: - The [`variant` object](/docs/api/liquid/objects/variant) - The [`store_availability` object](/docs/api/liquid/objects/store_availability) - The [`location` object](/docs/api/liquid/objects/location) ## Implementing pickup availability To support pickup availability functionality in your theme, you need to implements the following components: - [The pickup availability section](#the-pickup-availability-section): Renders the display content, which contains information about each location that the current variant is stocked at. - [The pickup availability container](#the-pickup-availability-container): An empty container on the product page that hosts the section content. - [A JavaScript function](#the-javascript-function): Renders the section content inside the container, and makes any updates on variant selection. > Caution: > The examples below are only meant to illustrate basic considerations for implementing this feature. The full implementation will vary depending on your theme and what you want the display to look like. You can refer to the following files in Dawn for an example of a complete solution: > - [Section](https://github.com/Shopify/dawn/blob/6490d2f90a8eea98d696dcbe28f092dcc9740efd/sections/pickup-availability.liquid) > - [Container](https://github.com/Shopify/dawn/blob/6490d2f90a8eea98d696dcbe28f092dcc9740efd/sections/main-product.liquid#L313) > - [Buy Button](https://github.com/Shopify/dawn/blob/6490d2f90a8eea98d696dcbe28f092dcc9740efd/snippets/buy-buttons.liquid#L102) > - [JS](https://github.com/Shopify/dawn/blob/6490d2f90a8eea98d696dcbe28f092dcc9740efd/assets/pickup-availability.js) > - [CSS](https://github.com/Shopify/dawn/blob/6490d2f90a8eea98d696dcbe28f092dcc9740efd/assets/component-pickup-availability.css) ## The pickup availability section The pickup availability section hosts the actual content to be displayed, which has two main components: - [Availability summary](#availability-summary) - [Availability modal](#availability-modal) This section is rendered inside the [pickup availability container](#the-pickup-availability-container) by the [JavaScript function](#the-javascript-function). ### Availability summary The availability summary loops through the locations returned from the `store_availabilites` attribute of the current variant to find any locations that have `pick_up_enabled` set to `true`. If there are any, then the availability of the current variant at the first location is displayed, along with a button to open the [availability modal](#availability-modal). #### Example
### Availability modal The availability modal displays the product and variant titles, and each location that the current variant is stocked at. For each location, the current availability and address are shown. #### Example
### Example The following is an example of a pickup availability section with an availability summary and modal. > Note: > You should only output the availability summary and modal if the current variant has at least one location with pickup enabled.

## The pickup availability container The pickup availability container is an empty `
` element that the [JavaScript function](#the-javascript-function) will render the section contents inside of. It should be placed wherever you want the [availability summary](/docs/storefronts/themes/delivery-fulfillment/pickup-availability#availability-summary) to show on the product page. ### Example ```html
``` ## The JavaScript function To add the pickup availability section content inside the pickup availability container, you need to use the [section rendering API](/docs/api/ajax/section-rendering). The request needs to be prefixed with a `/variants/[variant-id]` parameter, where `[variant-id]` is the [variant ID](/docs/api/liquid/objects/variant#variant-id) of the selected variant. To access the variant ID, and update the display when a variant is selected, you need to make a call to your pickup availability JavaScript function from the [JavaScript responsible for updating product page elements on variant selection](/docs/storefronts/themes/product-merchandising/variants). ### Example ```js fetch(window.Shopify.routes.root + "variants/[variant-id]/?section_id=pickup-availability") .then(response => response.text()) .then(text => { const container = document.querySelector('[data-store-availability-container]'); const pickupAvailabilityHTML = new DOMParser() .parseFromString(text, 'text/html') .querySelector('.shopify-section'); container.appendChild(pickupAvailabilityHTML); }) .catch(e => { console.error(e); }); ``` > Tip: > You can't access the Liquid product object in the pickup availability section. This means that product-specific changes, like updating the title and removing the variant title if the product only has a default variant, need to be done through JavaScript. The example [availability container](/docs/storefronts/themes/delivery-fulfillment/pickup-availability#the-pickup-availability-container) includes `data-product-title` and `data-has-only-default-variant` attributes for this purpose.