# Product Builder

<mark style="color:blue;">The Product Builder in WorkMate allows you to create configurable products with complete flexibility and data consistency. This feature enables businesses to sell customized products by starting with a base product in Shopify and adding configurable options and custom fields. You will need to configure your product on Shopify Admin before you work with it on POS.</mark>

## **Demo:**

{% embed url="https://www.loom.com/share/a3fbb66ae10c4e8097b10d06490cc2a5?sid=0241a6fd-a0e5-4b6e-9eba-ec16b137b0c6" %}

## **Documentation:**

#### Example Use Case:

Many stores need to offer customized products where customers select a base item and then configure specific attributes. For example, a furniture store may offer a base couch where customers choose fabric type, wood color, and leg style. The Product Builder solves this requirement by enabling a flexible configuration workflow within WorkMate.



#### 1. Configure Product Metafields in Shopify

Navigate to your base product in Shopify that will serve as the foundation for customizations. Scroll down to the Product Metafields section where you will see two configuration options: **Add-ons** and **Custom Fields**.

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FUTXeudp4wsmY99akdmIw%2Fimage.png?alt=media&#x26;token=af55dcb7-e8cc-412f-8638-da4d343beb32" alt=""><figcaption></figcaption></figure>

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FGvqGu2nPA4P5MbEaWduJ%2Fimage.png?alt=media&#x26;token=dff08533-c470-40a1-86d0-7c62f1e33c31" alt="" width="563"><figcaption></figcaption></figure>



#### 2. Adding Product Add-ons

Add-ons allow customers to select from predefined product options when configuring their order.

**To configure add-ons:**

* Click into the **Add-ons** bar and select **New Entry**
* Enter the name and optional description for the add-on
* Configure requirement settings:
  * **Required:** Select whether this add-on must be chosen when adding the parent product to a work order
  * **Multiple Selection:** Choose whether multiple products can be selected for this add-on category
* Add the available product options that customers can choose from
* Ensure the new entry is selected and toggled on in the Add-ons bar

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FlCberR0lttbzuf3cOw5I%2Fimage.png?alt=media&#x26;token=08b068d8-9973-42e7-baf1-2e951acba053" alt=""><figcaption></figcaption></figure>

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FHDtH8xarc1tTIpnMbc9U%2Fimage.png?alt=media&#x26;token=c64cf8c4-2136-4624-bcef-a3fe82a5c952" alt=""><figcaption></figcaption></figure>



#### 3. Adding Custom Fields

Custom fields provide additional data input options that appear in the line item details.

**To configure custom fields:**

* Click into the **Custom Fields** bar and select **Add Item**
* Enter the custom field name
* You can configure the custom field data type in WorkMate's custom field settings

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FWrc8eyORSgRFwyaaEh66%2Fimage.png?alt=media&#x26;token=044cf313-b6aa-458a-b2c5-0cca5998ad40" alt=""><figcaption></figcaption></figure>



#### 4. Building Products in Work Orders

Once you have configured the product metafields, you can add these products to work orders and begin customization.

**To start building:**

* Go to the Work Order tile and create a work order&#x20;
* Add the configured product to your work order as a line item
* Click into the line item to open the product details menu

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2F1KXpxN2uAWT1OrS80t3o%2Fimage.png?alt=media&#x26;token=ce37069d-4a00-42e9-a724-d6d6cc49a049" alt=""><figcaption></figcaption></figure>

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FyQdWJ4vHBJY81e9ZOWEk%2Fimage.png?alt=media&#x26;token=efbb6d74-2c04-452a-a2a8-69d88254c15d" alt=""><figcaption></figcaption></figure>



#### 5. Product Configuration

Configure your customized product using the options you set up in Shopify.

**Configuration options:**

* **Product Configuration Section:** Select products for each add-on using the **Select Product** button, following the rules configured in your Shopify product settings
* **Custom Fields Section:** Complete any custom fields with relevant information

{% hint style="info" %}
_**Important:** Save your work order to preserve all configuration changes._
{% endhint %}

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FJUosG65RzQo7KQatVXzT%2Fimage.png?alt=media&#x26;token=9ad6b172-b9a1-4f1e-b350-c8a663508bc2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2F5xiesZ0eh9iwWOWkz9Ru%2Fimage.png?alt=media&#x26;token=359ccd8e-a7dc-42dc-9da7-ce20799de102" alt=""><figcaption></figcaption></figure>

