# Property Mappings

Property Mappings define the BOM columns displayed in SharpSync. You can think of them as the mapping of meta data from one source to another source, or as the mapping of custom properties from one source to another source.

For each mapping you create, a column will be displayed on the screen. Property mappings are expanded upon in detail here.

After setting up your Property Mappings and Rules, open one of the Primary [Data Sources](/sharpsync/fundamentals/data-sources.md) to export the Bill Of Materials (BOM) to SharpSync. For more details on exporting a BOM, see the "Export Assembly Or Part" section for each Data Source.

### Property Mappings Table <a href="#default-property-mappings" id="default-property-mappings"></a>

The following Property Mappings columns are visible by default:

<table><thead><tr><th width="248">Name</th><th>Description</th></tr></thead><tbody><tr><td>Order</td><td>The order in which the columns appear in the Bill of Materials (double-click the cell to change the order)</td></tr><tr><td>Property Name</td><td>The name of the column as it appears in the Bill of Materials</td></tr><tr><td>Accessor</td><td>The unique internal name as it is used in SharpSync</td></tr><tr><td>Primary Data Source  Property</td><td>The property as it is known at the primary source</td></tr><tr><td>Primary Data Source Type</td><td>The approximated type as it is known at the primary source</td></tr><tr><td>Update Primary Data Source</td><td>When checked, the primary source value will be updated</td></tr><tr><td>Secondary Data Source Property</td><td>The property as it is known at the secondary source</td></tr><tr><td>Secondary Data Source Type</td><td>The approximated type as it is known at the secondary source</td></tr><tr><td>Update Secondary Data Source</td><td>When checked, the secondary source value will be updated</td></tr><tr><td>Visible</td><td>Toggle Visibility Status</td></tr><tr><td>Read Only</td><td>Toggle Read Only Status</td></tr><tr><td>Settings</td><td>Click to edit the settings</td></tr><tr><td>Delete</td><td>Click to delete Property Mapping (Cannot Undo)</td></tr><tr><td>History</td><td>Shows a trimmed log of the changes to a specific mapping</td></tr></tbody></table>

Depending on your screen size, columns related to your Primary Data Source and Secondary Data Source might not all fit in the table. Use the scrollbar at the bottom, as shown in the screenshot below, to scroll other property mappings into view.

<figure><img src="/files/uBqNQpykEV7PpMEkp4Po" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Important: You have to add at least 2 Data Sources before being able to successfully add Property Mappings.

If any of your sources have changes applied (new properties added), come back to this screen and click the `UPDATE`  button before you can select the new property.
{% endhint %}

### Warnings in the mappings

If you see orange borders around some property mappings it means that you've recently updated you mappings, and the mappings with warnings shown no longer exist. They were renamed or deleted. They don't exist in the source any more.

<figure><img src="/files/HvDnVp1FTXGg2AKyGAHN" alt="Some Property Mappings are out of date"><figcaption><p>Some Property Mappings are out of date</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sharpsync.gitbook.io/sharpsync/fundamentals/property-mappings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
