---
title: "Integrating multi value fields"
slug: "integrating-multi-value-fields"
description: "Integrate multi value fields into your dox42 document template using SharePoint or Office 365 with options for values or XML for seamless data management."
tags: ["SharePoint", "task"]
updated: 2026-06-25T17:15:03Z
published: 2026-06-25T17:15:03Z
canonical: "help.dox42.com/integrating-multi-value-fields"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.dox42.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating multi value fields

Follow the instructions in order to integrate multi value fields into your dox42 document template.

To start the integration, connect to your SharePoint or Office 365 environment and select the desired list/library that contains multi value fields. When integrating multi value fields to your data sources, you have two options – values or XML:

- Choose “values”, if you want all data from the multi value field to be inserted as one data field that adds up the fields with a separator.
- Choose “xml”, if you want to have all data from the multi value fields to be separated into individual data fields.

## Option 1: Using “values”

1. In your dox42 Add-In, open the SharePoint data source from the **Data Sources** tab.

![](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/image(117).png)

**SharePoint** data source
2. In the **Special Fields** tab of the SharePoint Data Source, select the **values** entry from the **Multi Value** dropdown.
3. In the **Separator** text field, type in your desired separator.

![SharePoint interface showing special fields for data source configuration and settings.](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/SharePoint_multi-values_values.png)

Multi Value “values” and comma separator
4. Select the **Test** button. The multi value field e.g. **Technical Channel** will return the following:

![](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/SP_Values_Testtab.png)

Test result
5. Insert the multi value data field into your document template and generate the document.

![](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/SharePoint_Values_template.png)

Document template with multi value data field

![Generated Document with value multi value field](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/Result_SharePoint_Values.png)

Generated Document with value multi value field

## Option 2: Using “xml”

1. Follow steps 1 of Option 1.
2. In the **Special Fields** tab, select the **xml** entry from the **Multi Value** dropdown.

![SharePoint settings window showing data source and special fields configuration options.](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/SharePoint_multi-values_xml.png)

Multi Value “xml”
3. Select the **Test** button. The multi value field, e.g. **Technical Channel** will return the following:

![](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/SharePoint_Mulitvalue_xml_test_window.png)

Test result of **Technical Channel**
4. Add a new XML data source.
5. Select the **Insert Data Field** button to select the multi value field.

![](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/SharePoint_XML_Multivalue_XML_Datasource.png)

**Insert Data Field** button in XML data source
6. From the **SharePoint MultiValue Field/Apps** dropdown select the **Managed Metadata**, **Lookup** or **Person/****Group**.

![SharePoint data source initialization with options for XML and JSON fields.](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/SharePoint_xml_data source_multivalue.png)

**SharePoint MultiValue Field/Apps** dropdown in XML data source
7. Go to the dox42 ribbon in your document template and select the **Insert Data Field** button.
8. Insert the data field for managed metadata from the XML data source.
9. Create an **Automated Range**, repeat for the XML data source and generate the document.

![](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/XML_Choice_template_automaterange.png)

the dox42 template with the data field and automate range

![](https://cdn.document360.io/3acc69da-1de2-431d-95a6-08ae83717b4a/Images/Documentation/Screenshot_result_xml_multivalue.png)

the generated document

### Result

You can now create document templates with a *multi value* data field.