> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/data-migrator/templates/template-designer/adding-fields-to-objects.md).

# Adding Fields to Objects

## ![](https://2769999621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FcfMTqg4Brbm9baWutclZ%2FSummary2-Small-Icon.svg?alt=media\&token=d1cf162d-c02d-4184-988e-7f7350e450fc) Overview

This guide explains how to add fields to objects within a template. During data migration, only the selected object fields are migrated.

{% hint style="warning" %}

#### Preserving Relationships

To preserve the link between parent and child records during migration, migrated child records must include the **Relationship Field** that connects them to their parent. This applies to both Master-Detail and Lookup relationships. To learn more about this, see the following article.

* [Preserving Object Relationships](/data-migrator/templates/template-designer/preserving-object-relationships.md)
  {% endhint %}

## Add Fields

{% stepper %}
{% step %}

### Select Template

1. Click **Templates** from the left sidebar menu.
2. Click the template to add object fields to.

   <div align="left"><figure><img src="https://2769999621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FbPd3RWVowhXR0pqcZ3oZ%2FAddingFieldsToObjects-S01-01.png?alt=media&amp;token=470796c7-7cc0-4fda-abb9-4a0355c4ba38" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Add Fields

{% hint style="info" %}

#### Data Masking

Data Masking allows you to mask sensitive fields during migration by replacing them with random data before they are copied to the target organization. To learn more about Data Masking and how to apply it to a field, see the following article.

* [Applying Data Masking to Fields](/data-migrator/templates/template-designer/applying-data-masking-to-fields.md)
  {% endhint %}

1. Click the object to add fields to.

   <div align="left"><figure><img src="https://2769999621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FyBMtUgQQHelHmuH5Ejvb%2FAddingFieldsToObjects-S02-01.png?alt=media&amp;token=81f375e2-8928-407e-bbee-169ffdf5553a" alt="" width="563"><figcaption></figcaption></figure></div>
2. The Object's **Field List** opens on the right side of the designer.
3. Search or scroll to find the fields to add.

   <div align="left"><figure><img src="https://2769999621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FL5h3coFeHSr5L2s0H8i5%2FAddingFieldsToObjects-S02-02.png?alt=media&amp;token=9ab55084-6e8a-4dba-8a32-0d85a60665a7" alt="" width="563"><figcaption></figcaption></figure></div>
4. Check the checkbox next to each field to add.

   <div align="left"><figure><img src="https://2769999621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2Fmu01EUO5l5XbhcCk22AA%2FAddingFieldsToObjects-S02-03.png?alt=media&amp;token=eb11daad-2205-44b7-86c6-c09d6fb50cea" alt="" width="563"><figcaption></figcaption></figure></div>
5. Click **Save** once all the fields to add have been checked.

   <div align="left"><figure><img src="https://2769999621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FjGqSQIcCdwlmLKe3cptc%2FAddingFieldsToObjects-S02-04.png?alt=media&amp;token=d1db4b5d-32de-40c6-b4c0-2a07231a50ec" alt="" width="563"><figcaption></figcaption></figure></div>
6. The **Fields** count for the object will update to reflect the new number of selected fields.
7. Repeat this process to add as many fields to objects as you need.
   {% endstep %}

{% step %}

### Save Template

Once you are done adding fields to objects:

1. Click **Save template** to save your changes.

   <div align="left"><figure><img src="https://2769999621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FSAxFOvQqOKGUh3zrOuJ9%2FAddingFieldsToObjects-S03-01.png?alt=media&amp;token=17d7f6de-4f48-4e46-b4ae-95438cbce4e9" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/data-migrator/templates/template-designer/adding-fields-to-objects.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
