> For the complete documentation index, see [llms.txt](https://workmate.gitbook.io/workmate-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://workmate.gitbook.io/workmate-knowledge-base/workmate-feature-guides/configure-workmate-settings/ui-customization-settings.md).

# UI Customization Settings

<mark style="color:blue;">The</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**UI Customization**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">settings in WorkMate allow you to modify how product variants are displayed in different modules such as Work Orders, Purchase Orders, and Special Orders. You can choose to apply changes</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**globally**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">or</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**locally**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">to specific modules.</mark>

#### Subtitle Slot (Left Side)

* The **subtitle slot** displays additional information **underneath the product title** on the **left side** of the product description.&#x20;
* This is a great place to show brief product metadata.

{% hint style="info" %}
*Tip: Use the subtitle slot for customer-facing labels like `title` or `vendor`.*
{% endhint %}

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FwNTT1jv4JrC2N2eIEkJS%2Fimage.png?alt=media&amp;token=28f0f3c5-dd68-467f-b77d-9f7007c72212" alt=""><figcaption></figcaption></figure>

#### Right Slot (Right Side)

* The **right slot** appears on the **right side** of the product information area.&#x20;
* It is ideal for displaying **larger or more detailed information** about the product variant.

{% hint style="info" %}
T*ip: Use the right slot for technical or internal-facing data like `sku`, `taxable`, or `price`.*
{% endhint %}

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FWs3Sa2VOV8PGQ0FvnXTk%2Fimage.png?alt=media&amp;token=508869e7-67e5-45b1-a8a8-b07cf962ca2c" alt=""><figcaption></figcaption></figure>

#### Using Variables

* You can use dynamic variables in both slots to personalize the UI. Format your variables like this:
* ```
  {{ productVariant.variableName }}
  ```

**Common Variables**

* `{{ productVariant.title }}`
* `{{ productVariant.price }}`
* `{{ productVariant.taxable }}`
* `{{ productVariant.sku }}`
* `{{ productVariant.product.vendor }}`
* `{{ productVariant.product.tags }}`
* `{{ productVariant.product.usesSerialNumbers }}`

To discover more variables, click into a **product preview** to view the product's JSON structure.

<figure><img src="https://929556970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9QRNYn7PCoQK6KIOC55m%2Fuploads%2FEpplgIb5rpAqwA5kmkuq%2Fimage.png?alt=media&amp;token=6201f19b-7e5e-475a-9379-9eee6b8b57fc" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">Example: Product SKU, Price and Taxability</mark>&#x20;

**Subtitle Slot:**

```
SKU: {{ productVariant.sku }}
```

**Right Slot:**

```
Price: ${{ productVariant.price }}  
Taxable: {{ productVariant.taxable }}
```

#### Setting Up Custom Fields and Metafields to display

You can add custom fields and meta fields into the UI customizations templates to make them appear on your products and services within WorkMate.&#x20;

```
Metafield: {{ productVariant.metafields['namespace.key'] }}
Custom Field: Note: {{lineItem.customFields["Note"].value}}
```

#### Where to Apply UI Customization

You can apply custom UI formatting to:

* Work Orders
* Special Orders
* Or set it **globally** for all modules

#### Purchase Orders

When setting up UI Customization for purchase orders, the 'value' must be omitted.&#x20;

```
Custom Field Note:{{ customFields["Note"].}}
```

{% hint style="info" %}
*Tip: For global consistency, keep formatting minimal and standardized across modules.*
{% endhint %}