# Blueprint > Full documentation content for Blueprint --- # Default ## FAQs ### Common template examples FAQ **URL:** https://blueprint.mantledocs.com/template-faq-examples ## Common template examples in Blueprint Blueprint can be used to create **any kind of personalisation template**. The examples below are just common use cases to help you get started. In the app, go to **Templates** to open an existing template or click **Create Template** to build a new one. These examples are starting points, not limits. You can use Blueprint for simple add-ons, guided builders, text personalisation, file uploads, and more complex step-by-step product journeys. ![Blueprint Template Details showing Template Name, Status, Storefront Display, and Make personalisation optional for the buyer](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/73317543-27d3-48bf-85ce-808fc9db3d68/Screenshot_2026-06-18_at_12.54.17.png) ## FAQ Jump to an example template: - [Gift Wrap template example](about:blank#gift-wrap-template-example) - [Custom Sofa Builder template example](about:blank#custom-sofa-builder-template-example) - [Embroidery template example](about:blank#embroidery-template-example) These screenshots show three very common Blueprint use cases: - **Gift Wrap** as a simple add-on - **Custom Sofa Builder** as a guided, step-by-step configuration flow - **Embroidery** as a text-based personalisation flow with extra pricing rules They all use real Blueprint controls such as **Storefront Display**, **Make personalisation optional for the buyer**, **Product Options**, **Option type**, **Additional price**, **Additional base price**, and **Show Price Summary**. Use **Make personalisation optional for the buyer** when the customer should still be able to buy the product without filling in the template. In your examples, this makes sense for: - **Gift Wrap** because not every customer wants the add-on - **Embroidery** if the product can still be bought plain, without custom text For the **Custom Sofa Builder**, leaving this off is the right setup if the buyer must complete the configuration before adding the product to cart. If the template is optional overall, you can still make individual fields required inside it when those fields must be completed once the customer chooses to personalise. ## Gift Wrap template example The **Gift Wrap** example is a good starter template for a simple paid add-on. In the screenshots, this setup uses: - **Template Details** with a clear public-facing label such as **Gift Wrap Addition** - **Storefront Display** set to **On page**, so the option appears directly on the product page - **Make personalisation optional for the buyer**, so customers can skip it - **Checkbox (yes/no)** as the **Option type**, which is ideal for a single on/off choice - **Additional base price** in **Additional Price (optional)** for a fixed fee - **Additional price label** to name the charge clearly in the basket ![Screenshot 2026-06-18 at 12.58.12](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/98483ae0-b4c0-48da-b7bc-78f50c91a911/Screenshot_2026-06-18_at_12.58.12.png) ![Screenshot 2026-06-18 at 12.58.30](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/3d2878a9-a6fa-46fe-a14c-991364d2999e/Screenshot_2026-06-18_at_12.58.30.png) ![Screenshot 2026-06-18 at 12.58.30](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/863fabbc-34bd-458e-8cb7-9e9e3ff79035/Screenshot_2026-06-18_at_12.58.30.png) ![Screenshot 2026-06-18 at 12.58.21](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/1c79e490-9edf-461b-ba1b-e3c814d4fe54/Screenshot_2026-06-18_at_12.58.21.png) This is a common use case for extras like gift wrap, rush production, premium packaging, or proof approval. The **Gift Wrap** example is a good starter template for a simple paid add-on. It works well when customers only need a single yes-or-no choice and, if selected, a fixed extra charge is applied. ## Custom Sofa Builder template example The **Custom Sofa Builder** is a strong example of a more detailed configuration template where the customer should complete choices in order. In your screenshots, this template uses: - **Show options one step at a time** in **Product Options** - Separate steps such as **Step 1: Choose Fabric**, **Step 2: Choose Feet Material**, and **Step 3: Choose Arm Style** - **Dropdown list** as the **Option type** for each choice - **Make personalisation required for the buyer** on the product options - **Additional price** added at option level to charge more for certain stages of the build ![Screenshot 2026-06-18 at 13.13.24](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/ab78d2e8-bb85-4d30-843d-c380b6d1dda3/Screenshot_2026-06-18_at_13.13.24.png) ![Blueprint Product Options showing a step-by-step Custom Sofa Builder layout](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/9973ef53-a093-464b-ad28-aa53ae824646/Screenshot_2026-06-18_at_12.56.36.png) ![Screenshot 2026-06-18 at 12.59.02](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/6c5b4bc0-fd5d-4011-b97a-0af7fbdbd6d7/Screenshot_2026-06-18_at_12.59.02.png) ![Screenshot 2026-06-18 at 12.59.29](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/077e7ab3-98e8-4c19-a7c4-492a172ccb75/Screenshot_2026-06-18_at_12.59.29.png) ![Blueprint Arm Style option with dropdown values and additional price set](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/db56432b-4bb8-47ec-868d-d4d6397dd5c0/Screenshot_2026-06-18_at_12.59.37.png) This approach is ideal when buyers need to work through several decisions in a logical order. It keeps the page cleaner than showing everything at once and is a common use case for furniture builders, bundle builders, made-to-order products, and technical product selectors. **Show options one step at a time** helps when a product has several decisions that should be completed in sequence. For a sofa builder, this means customers can focus on one area at a time, such as fabric first, then feet material, then arm style. This usually feels easier than displaying every dropdown together. It also makes it clearer which choices are required before checkout. ## Embroidery template example The **Embroidery** example shows how Blueprint can collect short text and supporting selections around that text. In your screenshots, this template uses: - **Show options one step at a time** for a guided flow - A **Text box** option called **Embroidery text** - **Minimum Characters** and **Maximum Characters** to control the allowed text length - **Allow pricing per-character** with a **Cost per character** - Dropdown lists for **Embroidery Text Colour** and **Embroidery Position** - The template-level setting **Make personalisation optional for the buyer**, if embroidery is an extra rather than a required part of the product ![Blueprint Embroidery template details with optional personalisation enabled](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/5e4cd1dc-095e-472e-a0b9-96af11823174/Screenshot_2026-06-18_at_13.00.17.png) ![Blueprint Embroidery Product Options arranged as steps](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/5414c9f7-4844-463a-8915-e81fea35ca52/Screenshot_2026-06-18_at_12.57.41.png) ![Screenshot 2026-06-18 at 13.00.32](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/ca554e70-2412-4fd2-840b-464486dd0a83/Screenshot_2026-06-18_at_13.00.32.png) ![Screenshot 2026-06-18 at 12.57.49](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/55a59a17-00c5-4536-84af-58f01bfdb299/Screenshot_2026-06-18_at_12.57.49.png) This is a common use case for embroidery, engraving, monogramming, printed names, and any short-text personalisation. If you enable **Allow pricing per-character** on a **Text box** option, Blueprint can add a charge based on how many characters the buyer enters. In your example, the **Cost per character** is used for embroidery text. This is useful when longer text takes more time, thread, space, or production effort. The screenshot also shows that the cost is added **per character (excluding spaces)**, which helps keep the pricing more consistent. Per-character pricing works best when you also set sensible **Minimum Characters** and **Maximum Characters**, so customers know the allowed text length before they enter it. Blueprint lets you price templates in more than one way: - **Template-level pricing** is set in **Additional Price (optional)** using **Additional base price**. This adds a fixed charge to the template as a whole. - **Option-level pricing** is set on an individual product option using **Additional price**. This is useful when a particular choice adds cost. - **Per-character pricing** is available on supported text options and charges based on text length. Using your examples: - **Gift Wrap** is a strong fit for a fixed template-level fee - **Custom Sofa Builder** is a strong fit for option-level pricing on steps like fabric, feet material, or arm style - **Embroidery** is a strong fit for per-character pricing on the text itself Yes. In step-based templates, you can add priced options inside each step. For example, in the sofa builder screenshots, each dropdown option screen includes an **Additional price** field. That lets you charge for the selection being made in that part of the journey. This is useful when different materials, finishes, or build choices increase the final price. If you use template-level pricing and option-level pricing together, test the finished product page carefully so the total price stays clear and expected. Your screenshots show common Blueprint option types in real use: - **Checkbox (yes/no)** for Gift Wrap - **Dropdown list** for sofa choices such as fabric, feet material, and arm style - **Text box** for embroidery text - **Dropdown list** again for embroidery colour and position Blueprint also supports other option types such as **Checkboxes (multi-select)**, **Radio Buttons**, **Text box (multi-line)**, **Number input field**, and **File Upload**, so these examples are only a small sample of what you can build. In **Template Details**, you can choose **On page** or **In modal**. - **On page** shows the personalisation directly on the product page - **In modal** opens the personalisation in a pop-up Your screenshots use **On page**, which is often the best starting point for templates like gift wrap, embroidery, and guided builders because the customer can see the whole personalisation flow in context. Use clear labels that match what the customer is doing. - Use a simple **Template Name** internally - Use **Public Title** for customer-facing wording such as **Gift Wrap Addition**, **Customise your Sofa**, or **Customise your Shirt** - Use step names that describe the decision, such as **Choose Fabric** or **Choose text** - Only make an option **Required** when the order cannot proceed without it ## Quick setup summary - **Gift Wrap:** optional template, on-page display, checkbox option, fixed extra fee - **Custom Sofa Builder:** required configuration, step-by-step layout, dropdown options, extra cost on relevant build choices - **Embroidery:** optional or required depending on the product, text box with character limits, cost per character, plus colour and position steps See the full setup process for building a template, assigning products, and configuring pricing. Learn when to use option types like Checkbox, Dropdown List, and Text Box in your own templates. --- ## Features ### Product option types **URL:** https://blueprint.mantledocs.com/product-option-types ## Product option types in Blueprint When you create or edit a template in **Templates**, use **Add product option** to choose the type of field you want customers to use when personalising a product. The **Option type** you select controls what the customer sees on the storefront and which settings you can configure in the template. Blueprint uses the label **personalisation template** throughout the app. Product options are the fields inside that template that collect customer choices, text, numbers, or files. Some items that were previously listed alongside product options now sit under a separate **Elements** feature. Elements help you structure and explain a template, but they do not collect customer input. ## Available product option types When you add a product option, Blueprint now includes these product option types: - **Checkboxes (yes/no)** - **Checkboxes (Multi-select)** - **Radio Buttons** - **Dropdown List** - **Text Box** - **Text Box (Multi-line)** - **Number input field** - **File Upload** ![Option type dropdown in Blueprint showing the available product option types](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/70b6c58b-ca79-4cfb-88f4-977095d10392/Screenshot_2026-06-16_at_11.19.21.png) These are the input fields customers can interact with while personalising a product. Use them to collect selections, text, quantities, and uploaded files. ## Product Options area The **Product Options** area in a template gives you more control over how a personalisation flow is organised. ![Screenshot 2026-06-16 at 11.50.58](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/8eb92102-0aca-4bea-9acf-115e10b62d34/Screenshot_2026-06-16_at_11.50.58.png) - You can choose whether the template should **show all options at once** or **show options one step at a time**. - If you use steps, each step includes a **step name**, **status**, and a list of items in that step. - **Options and elements appear together** in the Product options list, so you can build the flow in the exact order customers should see it. - The list shows useful details such as **option name**, **option type**, **active status**, **required status**, and **price**. If you want a simple personalisation form, show all options at once. If you want to guide customers through a longer journey, use the step layout and show options one step at a time. ## How to add a product option Go to **Templates** and open an existing template or create a new one. For new templates, click **Add product option**. For pre-existing templates with options already applied, click **Add another option**. Pick the option type you want from the dropdown list. Enter the **option name** and complete the configuration shown for that type, including **active status**, **additional price**, and any other fields such as **required** or **option values**. Name options the way customers naturally think. For example, use **Choose a size**, **Add gift wrapping**, or **Enter your engraving text** instead of internal or operational labels. ## Elements Elements are separate from product option types. They help you structure the template and add guidance, but they do not ask the customer to make a choice or enter information. To add one, click **Add Element** next to **Add product option** or **Add another option** in the template builder. ### Available elements - **Paragraph** — Adds supporting text inside the template. Use it to explain what the customer should enter, describe materials or lead times, or provide instructions before a set of options. - **Title** — Adds a heading inside the template. Use it to separate sections such as **Choose your material**, **Add your message**, or **Upload your artwork**. - **Dividing Line** — Adds a visual separator between sections. Use it to break up long templates and make related options easier to scan. Because elements appear in the same Product options list as input fields, you can place them exactly where they should appear in the customer journey. ## Option types explained ### Checkboxes (yes/no) Use **Checkboxes (yes/no)** when the customer only needs to turn one choice on or off. This works best for simple add-ons or confirmations where there are only two states: selected or not selected. **Practical use case:** Add gift wrapping for an extra charge, confirm rush production, or request a printed proof before production. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** when needed ### Checkboxes (Multi-select) Use **Checkboxes (Multi-select)** when customers can choose *more than one* value from a list. This is useful when several selections can apply at the same time. **Practical use case:** Let customers choose multiple extras such as pockets, embroidery locations, matching accessories, or care add-ons. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** - **Option values** - **Additional price per value** - **Status per value** For longer lists, you may also see a setting to show option values in a separate picker for a cleaner customer experience. ### Radio Buttons Use **Radio Buttons** when customers must choose *one* value from a short list and you want every choice visible straight away. This makes comparing a few distinct choices quick and easy. **Practical use case:** Choose a material finish such as matte, satin, or gloss, or select a product orientation such as portrait or landscape. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** - **Option values** - **Additional price per value** - **Status per value** ### Dropdown List Use **Dropdown List** when customers must choose *one* value from a list, especially if the list is longer or you want to save space in the layout. **Practical use case:** Choose a size, thread colour, frame option, or packaging style from a list of available values. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** - **Option values** - **Additional price per value** - **Status per value** If the list is long, a dropdown often keeps the template cleaner than showing every value at once. ### Text Box Use **Text Box** when customers need to enter a short line of text. This is best for compact inputs rather than full messages. **Practical use case:** Collect a first name for embroidery, a short engraving, initials, or a custom label name. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** - **Minimum characters** - **Maximum characters** Some text-based options may also support extra pricing rules depending on how your template is set up. ### Text Box (Multi-line) Use **Text Box (Multi-line)** when customers need more space to enter several words, a longer message, or special instructions. **Practical use case:** Collect a gift message, detailed engraving instructions, a dedication, or production notes from the customer. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** This option is helpful when a single-line field would feel too restrictive. ### Number input field Use **Number input field** when the customer needs to enter a numeric value only. This helps prevent text being entered where only numbers make sense. **Practical use case:** Collect a shirt number, table number, measurement, quantity for a bundled add-on, or another numeric reference. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** ### File Upload Use **File Upload** when customers need to send artwork, reference material, or another file as part of their order. **Practical use case:** Let customers upload a logo for printing, a design reference image, or a document containing personalisation details. You can usually configure: - **Option name** - **Additional price** - **Status** - **Required** If you use File Upload, make the option name very clear so customers know exactly what they should provide, such as **Upload your logo** or **Upload reference image**. ## Choosing the right option type Choosing the best option type makes the template easier to complete and reduces incorrect submissions. - Use **Checkboxes (yes/no)** for a single on/off choice. - Use **Checkboxes (Multi-select)** when multiple choices can be selected together. - Use **Radio Buttons** when customers should choose one option from a short, visible list. - Use **Dropdown List** when customers should choose one option from a longer list or when you want to save space. - Use **Text Box** for short text such as names, initials, or short engraving copy. - Use **Text Box (Multi-line)** for longer messages or detailed instructions. - Use **Number input field** when only numbers should be entered. - Use **File Upload** when the order depends on artwork, logos, or reference files supplied by the customer. - Use **Elements** such as Paragraph, Title, and Dividing Line when you need to explain or structure the template instead of collecting input. If you are deciding between Radio Buttons and Dropdown List, use Radio Buttons when there are only a few important choices to compare quickly, and use Dropdown List when there are many values or limited screen space. ## Best practices - Use clear, customer-friendly option names so people know exactly what to enter or select. - Only mark an option as **Required** when the order cannot move forward without it. - Add **Additional price** only where it is easy for the customer to understand why the price changes. - Keep lists short and well named. If a list becomes long, consider a **Dropdown List** instead of showing everything inline. - Use **Checkboxes (yes/no)** for simple extras, not for choices where customers need several possible values. - Use **Checkboxes (Multi-select)** only when multiple selections should genuinely be allowed. - Use **Radio Buttons** for a small set of mutually exclusive options that should stay visible. - Use **Text Box** for short answers and **Text Box (Multi-line)** for longer instructions to avoid cramped text entry. - For text-based options, set sensible expectations in the option name, such as character limits or what kind of text should be entered. - Use **Number input field** only when a numeric answer is required, so customers are not confused about whether words are allowed. - For **File Upload**, explain what file the customer should upload and what it will be used for. - Use **Title**, **Paragraph**, and **Dividing Line** to break long templates into sections and improve readability. - If your template has many fields, consider showing options **one step at a time** so the customer is guided through the process more clearly. ## Related guide Learn how to build a template, organise product options, and publish a personalisation flow for your products. --- ## FAQs ### FAQs Overview **URL:** https://blueprint.mantledocs.com/faqs-overview In this area, you’ll find some commonly asked questions about Blueprint functionality and features. --- ## Features ### Features Overview **URL:** https://blueprint.mantledocs.com/features-overview In this area, you’ll find guidance on the available features within Blueprint and how to use them. --- ### Create a personalisation template **URL:** https://blueprint.mantledocs.com/create-a-personalisation-template ## Create a personalisation template Use templates in Blueprint to build a personalisation flow for products that need customer input, such as custom text, selectable options, or step-by-step choices. From the template, you can control how the personalisation appears on the storefront, which products or collections use it, and whether extra charges are added. You can open an existing template from **Templates** to edit it, or create a new one with **Create Template**. In the Blueprint app menu, click **Templates**. From here, either open an existing template or click **Create Template** to start a new one. In **Template Details**, enter a clear **Template Name** that describes how the template will be used, such as *Custom Sofa Builder*. Set the **Status** for the template: - **Active** if the template is ready to use - **Inactive** if you are still building or testing it Choose a **Storefront Display** option: - **On page** shows the personalisation fields directly on the assigned product page - **In modal** opens the personalisation fields in a pop-up Use **Make personalisation optional for the buyer** if customers should be allowed to add the product to cart without completing the template. ![Blueprint template details with Template Name, Status, Storefront Display, and Make personalisation optional for the buyer](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/dc341080-655a-4e1a-94e8-a4250d24ac2d/Screenshot_2026-04-09_at_09.19.26.png) You can optionally create a filter group before choosing how options are shown. Filter groups allow you to present filters to customers that can narrow down option values in complex templates. For more information about using this feature, see [Use filter groups](/features/use-filter-groups). Select an options layout from: - **Show all options** to display every personalisation option in a single section - **Show options step-by-step** to break the personalisation flow into stages For more information about the types of product options you can add to a template, see [Product option types](/features/product-option-types). Use **Show options step-by-step** when the product has several choices or when you want to guide customers through the process in a set order. After adding your options and steps, assign the template where it should be used. Click **Browse Products** to open the product picker, select the products you want, then click **Select**. You can also click **Browse Collections** to assign the template to collections instead. If a template should only apply to specific items, double-check your selected products and collections before saving so it does not appear on the wrong products. In **Additional Price (optional)**, you can apply an extra charge for the template as a whole. - Use **Additional base price** when personalisation adds a fixed amount to the product price - Use **Additional price label** to control the text shown alongside that charge in the basket - Set **Show Price Summary** to show a breakdown of the product price and additional fees on the product page If you still need to add or review the product options used in this template, see [Product option types](/features/product-option-types). ![Additional Price section in Blueprint with Additional base price, Additional price label, and Show Price Summary](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/d800091a-e793-4870-a78f-d8fbbed71607/Screenshot_2026-04-09_at_09.25.07.png) Save the template and review it on an assigned product to confirm: - the correct template is attached - the chosen **Storefront Display** behaves as expected - required fields work correctly - any additional pricing appears correctly - the price summary is shown if enabled ## Best practices - Use descriptive option names so customers understand what they are choosing - Keep related fields grouped together, especially if using **Show all options** - Use **Title** and **Dividing Line** to make longer templates easier to scan - Set templates to **Inactive** while building, then switch to **Active** when ready - Preview pricing carefully if you add charges at both field level and template level ## What to check if something looks wrong Check that the template is set to **Active** and that it has been assigned to the correct product or collection. Also confirm you selected the intended **Storefront Display** option. Review the **Make personalisation optional for the buyer** setting and the **required** setting on each option. If personalisation should be mandatory, optional personalisation should be turned off and the relevant fields should be required. Use **Additional price label** to give the fee a clear name and enable **Show Price Summary** so customers can see how the total is made up. --- ### Use filter groups **URL:** https://blueprint.mantledocs.com/use-filter-groups ## Filter groups in Blueprint **Filter groups** are an optional way to make long option lists easier for customers to browse in a personalisation template. Instead of showing every option value in one long list, you can create a filter such as *Colour* and assign each option value to one of those filter values. This is especially useful when a template contains many similar choices, such as multiple shades of the same colour, different finishes, or grouped material types. Filter groups are available for option types that use **Option Values**: **Checkbox**, **Radio Button**, and **Single Dropdown**. ## When to use filter groups - You have a long list of option values and want to make them easier to scan. - You want customers to narrow results before choosing a final option. - You are using **In modal** in **Storefront Display** or you have turned on **Show option values in slide out picker** for an option. For example, you might create a filter group called **Colour** with filter values such as **Red**, **Blue**, and **Green**. You can then assign each option value to one of those filters so customers can quickly narrow the list. ## Create a filter group In the Blueprint app menu, go to **Templates**. Open an existing template or click **Create Template**. While editing the template, click **Create Filter Group**. Enter a clear group name such as **Colour**. Add the values customers will use to filter the list. - To add several values at once, enter them as a comma separated list, such as *Red, Blue, Green*. - To add them one by one, type a value and use the **Add** button. Apply the filter group so it becomes available inside supported option types. ![Screenshot 2026-06-16 at 12.11.17](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/1cbcaaa5-43c1-49e4-8f2c-c75866f49b38/Screenshot_2026-06-16_at_12.11.17.png) ## Apply a filter group to an option After creating a filter group, you can attach it to an option that uses **Option Values**. In your template, add a new option with **Add Product Option** or open an existing one. Filter groups can be used with: - **Checkbox (Multi-Select)** - **Radio Button** - **Dropdown List** Blueprint adds a filter field in the **Option Values** area. For each option value, choose the matching filter value you created earlier by using the Filters (Optional) section. Click **Save Option** when you have assigned the correct filter value to each option value. ![Screenshot 2026-06-16 at 12.28.17](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/c9e3f9a7-63da-4396-8823-718d04ecba74/Screenshot_2026-06-16_at_12.28.17.png) ![Screenshot 2026-06-16 at 12.28.31](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/af1b4fd5-25e5-465a-9efd-58a5be58464d/Screenshot_2026-06-16_at_12.28.31.png) ## Example: filtering colour choices Imagine your template includes many fabric or finish values, including several shades of red. You could: - Create a filter group called **Colour** - Add filter values such as **Red**, **Blue**, and **Green** - Assign values like **Burgundy** and **Scarlet** to the **Red** filter On the storefront, the customer can select **Red** first and then see only the matching red shades, instead of scrolling through the full list. Use broad filter values that customers will understand immediately. For example, **Colour**, **Finish**, or **Material** usually work better than overly specific internal labels. ## How filter groups appear on the storefront When configured, filter groups are shown to customers as part of the option selection experience. They are visible when: - the template is displayed **In modal** in **Storefront Display** - an option has **Show option values in slide out picker** turned on ![Storefront modal in Blueprint showing filter chips for Colour before a customer chooses a value](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/e9f07fe3-6094-4cb2-bf18-e7675938f49e/Screenshot_2026-04-09_at_11.07.44.png) ![Storefront modal in Blueprint showing the Red colour filter applied so only matching option values are visible](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/07f89c78-4441-4446-8cab-befc423714bf/Screenshot_2026-04-09_at_11.07.54.png) ## Best practices - Use filter groups only when they make a long list easier to navigate. - Keep filter value names short and customer-friendly. - Make sure every option value is linked to the correct filter value before saving. - Preview the template on the storefront to check that filters reduce the list in a way that makes sense to customers. If option values are not linked to the right filter values, customers may see incomplete or confusing results in the modal or slide out picker. ## Related guides Set up a template, choose storefront display settings, assign products or collections, and configure template-level pricing. Learn when to use Checkbox, Radio Button, Single Dropdown, and other product option types in Blueprint. --- ## Getting started ### Overview **URL:** https://blueprint.mantledocs.com/overview In this area, you’ll find guidance on how to install and configure Blueprint for use. --- ## Troubleshooting ### Troubleshooting Overview **URL:** https://blueprint.mantledocs.com/troubleshooting-overview In this area, you’ll find guidance on troubleshooting for functionality and features within Blueprint. --- ### Shopify POS - Add to Cart does not enforce required customisation **URL:** https://blueprint.mantledocs.com/shopify-pos-add-to-cart-does-not-enforce-required-customisation ## What happens in Shopify POS If **Blueprint** is enabled in Shopify POS, a product with a template that requires personalisation can show **two buttons** when a POS staff member searches for that product: - **Add to Cart** — Shopify's native POS button - **Customise by Blueprint** — the Blueprint button for collecting personalisation This is a known Shopify POS limitation. It cannot currently be prevented or overridden by Blueprint. ## What each button does ### Add to Cart If the POS user taps **Add to Cart**, Shopify can add the product to the cart **without opening Blueprint**. That means required personalisation is **not enforced** through this native Shopify button. ### Customise by Blueprint If the POS user taps **Customise by Blueprint**, Blueprint opens the product's personalisation flow. When the template includes required personalisation options, the item **cannot be added to cart** until the required selections have been made. In other words, Blueprint enforces required personalisation only when the product is opened through **Customise by Blueprint**. ## Recommended staff workflow For any product that must be personalised before checkout, staff should use **Customise by Blueprint** instead of Shopify's native **Add to Cart** button. In Shopify POS, search for the product as usual. If both buttons are shown, tap **Customise by Blueprint**, not **Add to Cart**. Select all required personalisation options in the Blueprint flow. Once the required selections are completed, Blueprint will allow the item to be added to the cart. If a product should never be sold without personalisation, train POS staff to always look for and use **Customise by Blueprint**. ## Important limitation to share with your team - **Add to Cart** is controlled by Shopify POS. - **Customise by Blueprint** is controlled by Blueprint. - Blueprint cannot block Shopify's native **Add to Cart** button in this POS search result scenario. - Required personalisation is only enforced when the sale starts through **Customise by Blueprint**. ## When to expect this behaviour You are most likely to see this when: - Blueprint has already been enabled in **Point of Sale** - The app is added in the POS **Customise** screen - The product is linked to a Blueprint template - That template includes required personalisation fields or choices ## Related setup guides Enable Blueprint in Point of Sale and confirm it shows as Added in the Customise screen. Add Blueprint blocks such as Product Configurator and Hide Add to Cart in the Shopify Theme editor. --- ## Getting started ### Enable Blueprint in Shopify POS **URL:** https://blueprint.mantledocs.com/pos-steps ## What you’ll do Use this walkthrough to enable Blueprint in Shopify POS from your Shopify admin. You’ll complete this in Shopify under **Point of Sale**. ## Step-by-step: enable Blueprint in Shopify POS From your Shopify admin, open **Point of Sale**. In the Point of Sale channel, click **Settings**. On the Settings page, find the customization section and click **POS app**. On the next screen, click the **Apps** icon in the top-left corner. Find the **Customise** toggle for Blueprint, switch it **on**, then save your changes. If the screen labels in Shopify look slightly different, follow the same path: **Point of Sale → Settings → POS app**, then open the **Apps** menu and turn Blueprint on. ## How to verify it worked - Return to the **POS app** area and confirm the **Customise** toggle for Blueprint is turned on. - Open Shopify POS on your device and check that Blueprint is available. If Blueprint does not appear right away, save your changes again and give Shopify POS a moment to refresh across devices. --- ### Add Blueprint to theme **URL:** https://blueprint.mantledocs.com/add-blueprint-to-theme This walkthrough shows how to add **Blueprint** to your Shopify theme by inserting the app’s theme blocks in the **Theme editor**, then adjusting the settings in the right-hand panel. In the Theme editor, Blueprint appears under **Apps** as theme blocks (for example, **Product Configurator** and **Hide Add to Cart**). ## Open the theme editor In Shopify admin, open **Online Store** → **Themes**. ![Shopify admin Themes page with the current theme and the Edit theme button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/bf51cb0b-fbda-4e47-8e40-d460b87dcd12/frame_001.jpg) On your current theme (for example, **Dawn**), click **Edit theme**. In the Theme editor, use the page selector at the top (for example, **Home page**) to jump to the template you want to update. ![Theme editor with the page selector dropdown open](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/a775d005-8e09-4534-ba1d-f07de98cda7f/frame_002.jpg) For Blueprint on product pages, switch to a product template (for example, **Products** → **Default product**). ## Add the Blueprint block to a product page In the Theme editor, navigate to the product template where you want Blueprint to appear (for example, **Default product**). ![Default product template in the Theme editor with Add section option](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/699457a7-aacf-47af-a39e-39e602169620/frame_003.jpg) In the left sidebar, find the area where you want the Blueprint UI to appear (commonly within **Product information**). 1. Click **Add block**. 2. Under **Apps**, choose the Blueprint block you need (for example, **Product Configurator**). Once added, the block appears in the sidebar list (for example, **Product Configurator**). Click the Blueprint block in the left sidebar (for example, **Product Configurator**) to open its settings in the right-hand panel. ![Blueprint Product Configurator block selected with customization settings visible in the right sidebar](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/fefb1897-efb9-41ca-929b-2c62c87f954b/frame_004.jpg) Use the available options to match your theme styling (for example, **Display Options**, **Layout**, and **Colors** such as background and text color). After changing settings, use the preview in the center to confirm placement and styling around key elements like the **Add to cart** button. ## (Optional) Add Blueprint to another template (e.g., home page) Use the page selector to switch to another template (for example, **Home page**). In the left sidebar, click **Add section** or **Add block** (depending on where you want Blueprint to appear). ![Theme editor home page view with Add section and the section selection popup](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/7f90b8b0-b717-4ce5-9afb-80b975841a23/frame_005.jpg) Under **Apps**, select the Blueprint option you want (for example, **Hide Add to Cart**). Select the newly-added Blueprint item in the left sidebar to view its settings in the right-hand panel. ![Blueprint Hide Add to Cart selected with settings shown in the right sidebar](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/be57bedf-1bfd-497f-9742-53afda004f02/frame_006.jpg) If the panel shows **No customizable settings available**, the block works automatically once added. Use **Manage app** if you need to adjust app-level configuration. ## Save and verify on your storefront - Click **Save** in the top-right of the Theme editor after changes. - Preview the storefront to confirm the Blueprint experience appears on the intended pages and templates. If you’re editing a theme that isn’t published, your changes won’t be visible on the live storefront until that theme is published. ---