# Asset Contacts General Import

## Overview <a href="#overview" id="overview"></a>

You can import [Contacts](broken://pages/LA4Q1JYzBEpq4X9RdhIY) for [Private Assets](broken://pages/eIC3EKq3W5hWtAu59Baw) into the system using the Asset Contacts General Import option.

Contacts may be exported from an existing data in your organisation (such as a ratepayer database). When exporting and importing to avoid the import failing, make sure to plan the correct field mappings.

{% hint style="warning" %}
Note that the Asset Contacts import will delete all Asset Contact data prior to importing data from your import file. This is primarily to avoid duplicate contacts being added by successive imports.
{% endhint %}

{% hint style="info" %}
Data is imported via a primary asset key. It is important to use the correct key based on what is configured in the system. Some organisations use different asset keys to others.
{% endhint %}

Refer to the register page for general instructions:

{% content-ref url="/pages/QP6MVwI3qEAEvatbmPc3" %}
[Imports](/system-administration/configuring-the-system/imports.md)
{% endcontent-ref %}

## Import File <a href="#instructions" id="instructions"></a>

A CSV file is required for this import with the correct field mappings.

Refer to the Import Field Mappings section in the [Import Instructions](/system-administration/configuring-the-system/imports.md#import-instructions) section for the latest import file requirements.

{% hint style="info" %}
If you want multiple contacts per asset you will need to add multiple line items in your import file. You will also need to have the [Generate one letter per asset contact setting](/system-administration/configuring-the-system/mail-merge-templates.md#advanced) enabled in the template to output them.
{% endhint %}

## Import Process <a href="#instructions" id="instructions"></a>

{% hint style="info" %}
Do not use Rollback on Error unless you are testing, as it can prevent a final import from running.
{% endhint %}

To import Contacts:

1. Refer to the general instructions in [Imports](/system-administration/configuring-the-system/imports.md).
2. In the General section select **Type**: *Assets*
3. For **Parsing Rule:** select *Asset Contacts General Import*
4. The default **Match Rule** will be *Delete data and replace with import data*
5. Under **Import File:** use the **Add file** button to upload your import file
6. Save and Check Results


---

# 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://docs.cw.crisisworks.com/system-administration/configuring-the-system/imports/assets/asset-contacts.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.
