---
title: "KB: Metadata Requirements for the Upload Client (ULC)"
canonical: "https://help.twinfinity.com/space/HCFD/157712403/KB%3A%20Metadata%20Requirements%20for%20the%20Upload%20Client%20(ULC)"
format: markdown
---
This article describes the metadata file required for documents uploaded through the Upload Client (ULC), so that the Twinfinity portal can automatically store the metadata. A metadata file is essential for automatic metadata storage in the portal. The guidance below is illustrated with an example XML file.

## Example XML file

Below is an excerpt from the example file `E-60-1-0100.xml`, showing the structure and elements:

```xml
<?xml version="1.0" encoding="utf-8" ?>
<metadata sourceFile="P:\Clients\Client\Project\Drawings and Records\E\Design\E-60-1-0100.dwg" path="{DrawingsRoot}\E\Design" xmlns="urn:ulc-metadata-schema">
  <layouts>
    <layout name="Layout1">
      <components>
        <component name="FRAME-A1">
          <fields></fields>
        </component>
        <component name="StampA1">
        <fields>
          <field>
            <name><![CDATA[COMPANY]]></name>
            <value><![CDATA[EXAMPLE]]></value>
          </field>
          <!-- Additional fields here -->
        </fields> </component>
      <!-- Additional components here -->
      </components>
    </layout>
    <!-- Additional layouts here -->
  </layouts>
<!-- Additional metadata elements here -->
</metadata>
```

## Metadata file naming convention

For the Twinfinity portal to correctly pick up and validate the metadata for a document, the file names need to match, as outlined below:

- Document name: `E-60-1-0100.dwg`
- Metadata file: `E-60-1-0100.xml`

## Metadata file structure

- Root element: `<metadata>` with attributes `sourceFile` and `path`.
- Child element: `<layouts>` containing layout details.
- Example of a layout element: `<layout name="Layout1">`.

## Target location variable

- Example from XML: `path="{DrawingsRoot}\E\Design"`.

## Metadata elements

- `layouts`: Contains layout information.
- `layout`: Details of a specific layout in the document.
- `components`: Contains component information.
- `fields`: Holds the fields of a component.

## Conclusion

This article outlines the required structure and elements for a metadata file accompanying documents uploaded through the ULC, using `E-60-1-0100.xml` as an example. The structure and examples shown here should guide you in creating your metadata files correctly.