---
title: XML Import
slug: hyper-portal/xml-import
docTags: 
createdAt: 2021-01-04T12:46:14.000Z
---

You can use this feature to import data from an xml file to the application. You can import data to any application entity.

### Where to start?

Let's look at the import operation using a specific example. There is an xml file with clients data and our task is to import the data into the Contact entity.

Go to the "Contact entity -> Arrow near Edit view button -> Import data"

![](https://archbee-doc-uploads.s3.amazonaws.com/5goaGPkGyPYxtK7K75CEC/rJKOZm9hL1qgEyRqavjPG_%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202021-01-04%20%D0%B2%2014.52.52.png)

In the window that opens, select and upload the file and press next



### Setting up a Data mapping

On the "Data mapping" tab, you configure the relationship of data from an XML file to fields in the portal.



![](https://archbee-doc-uploads.s3.amazonaws.com/5goaGPkGyPYxtK7K75CEC/yDIxOE4RGcYvpS5wxXrRC_example.png)



[XPath](https://en.wikipedia.org/wiki/XPath) query language is used to specify which data should be used from XML

**XML path to data array** - is the actual path to the data tag. In our example, we have a main `<clients>` tag and each client is enclosed in a `<client>` tag. Therefore, the path to customer data will be `/clients/client`

**Phone&#xA0;**- data about the phone is passed as additional parameters to the main tag `<client phone= "+66661112233">` (There may be several such parameters). To extract such a parameter, specify the parameter name beginning with "@"(at) `@phone`.

**Name&#xA0;**- is a simple input field. In an xml file, it is stored inside the `<name>` tag without any parameters. Specify the XML path to the value `name`.

**Language** - the language values are stored in the `<language>` tag which is nested in the `<info>` tag. In this regard, we specify the path to the value `info/language`.