Adding product disclosures to your products

You can add product disclosures to display legally-required warning or safety information for your products. Disclosures can be viewed by customers on your online store, in Shop, on custom storefronts, and through third-party sales channels and third-party apps. You can use the same single disclosure type across multiple relevant products.

Examples of product disclosures that you might use include the following types:

• Chemical exposure, such as the Prop 65 Cancer Warning disclosure, with the text WARNING: Cancer - https://www.P65Warnings.ca.gov and the California Proposition 65 warning symbol, and with a link to California Proposition 65.
• Choking hazards, such as the Choking Hazard: Small Parts disclosure, with the text WARNING: CHOKING HAZARD - Small parts. Not for children under 3 years and the black and white hazard sign, and with a link to the Code of Federal Regulations Title 16, Part 1501.

Regulations for product disclosures can vary by region, but warnings generally need to be easily accessed and viewed before a purchase is made, for example, on the product page.

You can create and display product disclosures in the following ways:

• Use Shopify's Disclosures metaobject entries, which contain editable fields for a product disclosure title, content, and symbol, as well as options for displaying the disclosure on your store's product pages and cart page. Add your own product-specific details to the standard entries as you need to. You can also create your own custom metaobject entries to display other types of product disclosure.
• Reference a metaobject entry through the Disclosures metafield that you can add to relevant product pages in your Shopify admin.
• Connect the metafield to your theme and display the metaobject entry's title, content, and symbol on your online store product pages and other channels that you sell on. Product disclosures are automatically displayed on your Shop product pages.

Considerations for adding product disclosures

Before you publish product disclosures with the Disclosures product metafield and metaobject entries, review the following considerations and limitations:

• If your store has any of the following example purchase flows, where a disclosure on a product page might not be viewed by a customer, then you can select Cart in the relevant disclosure's Display preferences section to have the disclosure displayed for the product on the customer's cart page instead:
  • When you have a quick add button for adding a product straight to the cart from a collection page.
  • When you sell add-on products that require a disclosure to be displayed, but the relevant product page for the add-on might not be viewed because it's set to Unlisted status.
• Some sales channels, online store themes, or custom storefronts might not support certain display types for product disclosures.
• The metaobject entries for product disclosures contain a Jurisdictions field, which you use to define which countries and regions a particular disclosure must legally be displayed in.
• Some Disclosures metaobject entries might require you add to further information before you publish them.
• To edit and create Disclosures metaobject entries, staff members need the View and Create and edit products permissions, and the View and Create and edit content permissions for Metaobject definitions and Entries. For more information, refer to Store permissions.
• You can add disclosures to products using shopify.disclosure in the Metafields column of a product import CSV file.
• If you sell product bundles and you need to add a disclosure to one or more products in the bundle, then you can add the Disclosures metafield when you create the bundle product.
• If you've published warning or disclosure information in other ways on your products - for example, in product descriptions or titles, through custom product metafields, or with product tags - then consider removing your previous implementation.

Add a disclosure to a product

You can add product disclosures to specific products in the Products section of your Shopify admin. You can also use the products bulk editor to add product disclosures to several products at the same time.

Steps:

1. From your Shopify admin, go to Products.

2. Click a product that you want to add a disclosure to.

3. In the Product metafields section, click Disclosures, and then take any of the following actions:

   • To add an existing standard or custom product disclosure:
     1. Click the Disclosures field, and then select a product disclosure type from the drop-down menu, or search for and click the product disclosure that you want to use.
     2. Optional: To edit the product disclosure details, click the entry in the Disclosures field, click Edit, take any of the following actions, and then click Save when you've made your changes:
        • Edit the Internal label, which isn't displayed to customers and is for your own reference.
        • Edit the product disclosure Title that displays to your customers.
        • In the Content field, make any changes to the warning text that you need to.
        • In the Symbol section, click the existing image, and then upload a different warning symbol for displaying with the product disclosure.
        • In the Jurisdictions section, click the icon, and then select or deselect from the available jurisdictions where you need to display the product disclosure.
        • In the Display preferences section, select or deselect from the available storefront locations where you need to display the product disclosure.
   • To create and add a new custom product disclosure:
     1. Click the Disclosures field, and then click Add new entry.
     2. In the Add custom disclosure dialog, take the following actions:
        1. Add an Internal label, which isn't displayed to customers and is for your own reference.
        2. Add the product disclosure Title that displays to your customers.
        3. In the Content field, add the warning text that you need to display for your product disclosure.
        4. In the Symbol section, click the icon, and then add the relevant warning symbol image that you need to display with the product disclosure.
        5. In the Jurisdictions section, click the icon, and then select or deselect from the available jurisdictions where you need to display the product disclosure.
        6. In the Display preferences section, select or deselect from the available storefront locations where you need to display the product disclosure.
     3. Click Save.

4. On the product details page, click Save.

Create a custom entry from an existing product disclosure

You can create a custom entry from an existing product disclosure in the following example scenario:

• You already use the Choking Hazard: Small Parts product disclosure on multiple products, with a warning that the products are Not for children under 3 years.
• You have other products where you also want to use the Choking Hazard: Small Parts product disclosure, but with a warning that the products are Not for children under 5 years.

For this example you need separate Disclosures metaobject entries for each product range, but the disclosures have only one small difference, so you can create a new custom entry from the Shopify-provided Choking Hazard: Small Parts product disclosure.

Steps:

1. From your Shopify admin, go to Products.

2. Click a product that you want to add the new disclosure to.

3. In the Product metafields section, click Disclosures, and then select the existing product disclosure from the drop-down menu.

4. Click the entry in the Disclosures field, click Edit, make the changes that you need to, and then click Add custom disclosure.

5. In the Add custom disclosure dialog, add a new Internal label so that you can differentiate your custom entry from the existing product disclosure.

6. In the dialog, click Save.

7. On the product details page, click Save.

Displaying product disclosures to your customers

When you use the Disclosures product metafield and metaobject entries, your product disclosures are displayed in the following ways:

• In a Disclosures section on product pages in your online store and in Shop, and for any relevant product in a customer's cart if you select Cart in a disclosure's Display preferences section.
• On third-party sales channels through the Storefront API.
• With third-party apps through the Admin API.

Product disclosures that use the Disclosures product metafield and metaobject entries aren't available in contextual product feeds for sales channels.

Review the following details and final setup steps for displaying product disclosures on your online store and Shop product pages.

Online store

• If your online store uses a Shopify free theme, then you need to update your theme to the latest version, and then take any of the following actions:
  • If you use a theme from Shopify's Horizon themes collection, then you need to add the Disclosures theme block to the Product information section on the product page template in your theme editor.
  • If you use an Online Store 2.0 theme, such as Dawn, then you need to add the Disclosures section to the product page template in your theme editor.
• If your online store uses a third-party theme, then contact your theme developer to check whether the theme supports displaying the Disclosures product metafield and metaobject entries.
• If your theme version can't display the Disclosures product metafield and metaobject entries, then you can use a code snippet instead.

Shop app and Shop web

• Product disclosures that use the Disclosures product metafield and metaobject entries are automatically displayed on your Shop product pages.
• To view a disclosure on a product in Shop, you and your customers need to be using the Shop app from version 2.239.0 or later on iOS or Android.

Change the disclosure type on a product

You can change the disclosure type that you have on a product and use a different disclosure instead.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to change the disclosure for.

3. In the Product metafields section, click the Disclosures entry that you want to remove, click Replace, and then add a different disclosure type to the product.

4. Click Save.

Remove a disclosure type from a product

You can remove a disclosure from a product at any time.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to remove a disclosure from.

3. In the Product metafields section, click the Disclosures entry that you want to remove, and then click x.

4. Click Save.

Editing your product disclosure details

You might need to edit or update a specific field for a product disclosure that you use, such as the title, content, or symbol. When you make a change to any fields in a Disclosures metaobject entry, the changes take effect for all products that you use the disclosure on.

You can manage and edit your Disclosures metaobject entries in the Content > Metaobjects section of your Shopify admin. Learn how to edit a metaobject entry.

Filter your product list by disclosure type

You can filter your product list to view only products that have a specific product disclosure type.

This might be useful when you need to add a new disclosure type to multiple products that all have the same existing disclosure type. You can filter your product list by the existing disclosure type, and then bulk edit the relevant products to add the new disclosure type.

Steps:

1. From your Shopify admin, go to Settings > Metafields and metaobjects.

2. In the Metafield definitions section, click Products.

3. In the list of metafield definitions, click Disclosures.

4. In the Options section, turn on Filter on the product list and in the Admin API, and then click Save.

5. From your Shopify admin, go to Products.

6. Click the Search and filter field, and then select Disclosures from the drop-down menu.

7. From the next drop-down menu that displays, select a disclosure type to view only products that have the specific disclosure.

8. Optional: To save the filter as a new view that you can click from your products list:

   1. Click Save.
   2. Enter a View name for the saved filter view.
   3. Click Save.