> ## Documentation Index
> Fetch the complete documentation index at: https://zuperinc-section23.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring Measurements

Measurement tokens define the specific data points (e.g., lengths, areas) that Zuper pulls from external providers. You can enable or disable these to tailor what appears in your job details page.

1. Go to **Job Settings > Measurements > Tokens**.
2. Under **Measurement Tokens**, you'll see a list categorized by type (e.g., Roof Measurement).
3. For each token, toggle the switch to enable or disable the applicable tokens.
4. Search for specific tokens using the search bar.
5. Changes are saved automatically.

<img src="https://mintcdn.com/zuperinc-section23/-ChxFCS-6N4Nb15h/images/ZHS2.png?fit=max&auto=format&n=-ChxFCS-6N4Nb15h&q=85&s=d2b382a2723b6f1dc3bb7b9d379e1f09" alt="ZHS2 Pn" width="1911" height="899" data-path="images/ZHS2.png" />

## Custom Tokens

Measurement tokens in Zuper allow you to track and quantify job-specific items, such as materials or dimensions, directly within your job estimates and reports. Custom tokens give you flexibility to tailor these to your business needs, like adding roofing-specific items.

### Adding custom category

1. Go to **Job Settings > Measurements > Tokens**.
2. Under **Tokens**, click **+Add Category**.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto1.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=e8ac2943a04d9ae9d250ea238558c953" alt="Custto1 Pn" width="1909" height="871" data-path="images/custto1.png" />

3. Enter the **Category Name**. Click **Create** to create the new category.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto2.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=65bf51f0d35f9372b2658e5e49f110c2" alt="Custto2 Pn" width="1920" height="878" data-path="images/custto2.png" />

4. The category is created successfully.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto3.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=4a6cfa377b7c940aea947614336c988a" alt="Custto3 Pn" width="1920" height="878" data-path="images/custto3.png" />

5. Click the "**Ellipsis**" icon and click **Edit Category** to modify the custom token details.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto15.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=400c955e740c661119e2f646b91d6c13" alt="Custto15 Pn" width="1920" height="878" data-path="images/custto15.png" />

6. Modify a category name and click **Update**.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto16.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=2e0095f88188a52bb1e97e879471604c" alt="Custto16 Pn" width="1920" height="878" data-path="images/custto16.png" />

<Note>
  Note: The Delete category option is available only when no custom tokens exist.
</Note>

### Adding custom tokens

The custom tokens for measurements are customizable data fields used to track and quantify specific job-related items, such as materials, dimensions.

1. Click the "**Ellipsis**" icon and click **+Add Token** to add the custom measurement tokens.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto6.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=58a5955d2207ea59769d75890519cdcd" alt="Custto6 Pn" width="1920" height="878" data-path="images/custto6.png" />

2. An "**Add Token**" dialog box appears. Enter the token name and unit of measure. Click **Create** to create the custom token.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto7.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=ad8d501703601cea0aa368099d2de2e6" alt="Custto7 Pn" width="1920" height="878" data-path="images/custto7.png" />

3. The token is created successfully.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto8.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=2221438bdbbf2fe8968346eb9beb0535" alt="Custto8 Pn" width="1920" height="878" data-path="images/custto8.png" />

4. Click the "**Ellipsis**" icon and click the "**Edit**" icon to modify the token details.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto19.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=309c1df1b1bcb73ebd95d02cd8c32360" alt="Custto19 Pn" width="1900" height="869" data-path="images/custto19.png" />

5. Click the "**Delete**" icon to delete the token.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto20.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=8cbf2f5fdc1f2879d76ae46cace1016a" alt="Custto20 Pn" width="1900" height="869" data-path="images/custto20.png" />

6. You can "**Toggle off**" to disable the token.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto221.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=b0e78c35d4ac5c457f041139d7508e4d" alt="Custto221 Pn" width="1900" height="869" data-path="images/custto221.png" />

## **Connecting to Measurement Providers**

Zuper supports integrations with leading roof measurement services to fetch data like aerial-derived roof specs, 3D visualisations, and high-precision reports.

1. Navigate to **Job Settings > Measurements > Providers**.
2. You'll see a list of available providers: The providers will have a list of measurement providers. Click “**Hover**.”
3. Click “**Connect**” to redirect to the Zuper App Store. Follow the steps to authenticate and link your account.

<img src="https://mintcdn.com/zuperinc-section23/-ChxFCS-6N4Nb15h/images/ZHS3.png?fit=max&auto=format&n=-ChxFCS-6N4Nb15h&q=85&s=5d34e02e03eaf71f5fae3cd194907983" alt="ZHS3 Pn" width="1905" height="872" data-path="images/ZHS3.png" />

4. Click “**Notify Me**” to get notified when apps from other providers are launched.

<img src="https://mintcdn.com/zuperinc-section23/OLSMQOFMhi7KJPq1/images/custto11.png?fit=max&auto=format&n=OLSMQOFMhi7KJPq1&q=85&s=04fe1353764a8b07eef592ed6a52e693" alt="Custto11 Pn" width="1592" height="740" data-path="images/custto11.png" />

* If your preferred provider isn't listed, scroll to **Request Integration**. To submit the request, you must fill out the form.
  * Enter details about the provider.
  * Click **Submit Request** for evaluation by the Zuper team.
