> For the complete documentation index, see [llms.txt](https://docs.ownchat.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ownchat.app/contact-screen/upload-the-bulk-contact/advanced-bulk-contact-upload.md).

# Advanced Bulk Contact Upload

### Overview  

Advanced Bulk Contact Upload lets you import contacts from a CSV file without manually adding country codes to phone numbers. The system applies a phone number format rule during upload, automatically prefixing the correct country code based on the rule you configure.

This feature also lets you map uploaded data to custom fields, assign tags, and track upload progress through a dedicated upload history log.

{% embed url="<https://app.supademo.com/demo/cmq0kusmi11uvqmgh3efc8j4w?utm_source=link>" %}

### Before You Begin &#x20;

* Have your contact data ready in a CSV file.
* The file size must not exceed 10 MB.
* Unlike the standard Bulk Contact Upload, you do not need to add country codes to phone numbers manually. Country codes are applied automatically based on the format rule you set.

### Accessing Advanced Bulk Contact Upload &#x20;

1. Click the **Contacts** icon in the sidebar.<br>

{% embed url="<https://app.supademo.com/demo/cmqkn42e6002muv0jhptkiq35?utm_source=link>" %}

2. Click the **Contacts** tab to view your customer database.<br>

{% embed url="<https://app.supademo.com/demo/cmqkn5j7w01ity00jehruwz06?utm_source=link>" %}

3. Click **Add Customer.**<br>

{% embed url="<https://app.supademo.com/demo/cmqkn7q5r01ivy00j2xbzvetw?utm_source=link>" %}

4. Click **Advanced Bulk Upload** to open the upload configuration screen.<br>

{% embed url="<https://app.supademo.com/demo/cmqkn922t0142yw0jboshfnsu?utm_source=link>" %}

### Step 1: Upload Your CSV File &#x20;

1. Drag and drop your CSV file into the upload area (maximum file size: 10 MB).

{% embed url="<https://app.supademo.com/demo/cmqkncpgb0001yx0jdlsyz2zb?utm_source=link>" %}

2. Once uploaded, the system displays the number of contacts found in the sheet. Use this to confirm your file was read correctly before proceeding.

{% embed url="<https://app.supademo.com/demo/cmqknf7e40175yw0jgj2ln6h0?utm_source=link>" %}

**Note:** Tags are automatically created using the current date and time of the upload. If you want to organize contacts differently, you can assign custom tags instead of relying on the auto-generated tag.<br>

{% embed url="<https://app.supademo.com/demo/cmqknhwa30177yw0jm9rixv2b?utm_source=link>" %}

### Step 2: Configure Phone Number Format Rules &#x20;

Advanced Bulk Contact Upload automatically prefixes country codes to phone numbers based on the rule you select. This removes the need to format numbers manually before upload.

1. Select the **Prefix Country Code** dropdown.

{% embed url="<https://app.supademo.com/demo/cmqknl3120194uw0jr89hiy2t?utm_source=link>" %}

2. Choose the country code that matches your contact data.<br>

{% embed url="<https://app.supademo.com/demo/cmqkos4ja018uyw0j9hc89dp2?utm_source=link>" %}

**Examples:**

| **Phone Number Format in File** | **Selected Prefix** | **Result After Upload**                       |
| ------------------------------- | ------------------- | --------------------------------------------- |
| 10-digit Indian mobile number   | India               | +91 is added automatically                    |
| 8-digit Singapore mobile number | +65                 | Singapore country code is added automatically |

{% embed url="<https://app.supademo.com/demo/cmqkpy8ma01o6uw0jpvyfbh9x?utm_source=link>" %}

\
Make sure the prefix you select matches the actual format of the phone numbers in your file. An incorrect prefix selection may result in incorrectly formatted numbers.

### Step 3: Map Fields (Target Property) &#x20;

The **Target Property** section displays all fields available in your Field Collection. Use this section to map columns from your uploaded file to the correct fields in OwnChat.

**Mapping Options** &#x20;

* **Map from file:** Match a column in your CSV to a target field.
* **Fixed Value:** Use this if you want the same value applied to all contacts for a specific field.

1. Click **Fixed Value.**<br>

{% embed url="<https://app.supademo.com/demo/cmqkq5chm01gpyw0jehgqkc1t?utm_source=link>" %}

2. Enter the value you want applied to all contacts.

**Allow Broadcast Field** &#x20;

1. Select **Allow Broadcast** from the field dropdown.
2. Toggle the switch to enable mapping for this field.

This determines whether the uploaded contacts will be eligible to receive broadcasts.

### Step 4: Start the Upload &#x20;

1. Review your field mappings and phone number format rule.
2. Click **Start Upload.**

{% embed url="<https://app.supademo.com/demo/cmqkvovzo0004w50jgp5nb5dj?utm_source=link>" %}

Contacts will begin uploading to the system based on your configuration.

### Viewing Upload History &#x20;

You can track the status and results of any upload through the Upload History log.

1. Click the **Settings** icon in Contacts.

{% embed url="<https://app.supademo.com/demo/cmqkvq2r10008w50jy2lvlrhv?utm_source=link>" %}

2. Click **Upload History.**

{% embed url="<https://app.supademo.com/demo/cmqkvr14z02i6y00jdrszhanm?utm_source=link>" %}

3. Click the **Refresh** icon to load the latest upload records.

{% embed url="<https://app.supademo.com/demo/cmqkvxby702iyy00jb6vpnf71?utm_source=link>" %}

#### What You Can View in Upload History &#x20;

* **Created contacts:** Number of contacts successfully added.

{% embed url="<https://app.supademo.com/demo/cmqkw73fs030hyw0j96hvzztj?utm_source=link>" %}

* **Duplicate contacts: Number of contacts identified as duplicates.**

{% embed url="<https://app.supademo.com/demo/cmqkwcx6o02b1uv0jkgn1z6nx?utm_source=link>" %}

* **Failed contacts:** Number of contacts that failed to upload.
* **Uploaded by:** The user who performed the upload.

{% embed url="<https://app.supademo.com/demo/cmqkwhgb50316yw0jlce1kbnd?utm_source=link>" %}

* **Status:** Indicates whether the upload is Running or Finished.

{% embed url="<https://app.supademo.com/demo/cmqkwimu002kzy00j7qem0a2t?utm_source=link>" %}

While an upload is in progress, the status will show as **Running.** Click the **Refresh** icon again to check for updates. Once complete, the status changes to **Finished.**

{% embed url="<https://app.supademo.com/demo/cmqkwjj9l03lnuw0jv0esomcl?utm_source=link>" %}

If there are no errors, the **Uploaded Rows** section will not display any error messages.

### Upload Record Actions &#x20;

Click the **action menu** next to an upload record to access the following options:

* **Edit Mapping:** Modify the field mapping used for that upload.
* **Download Report:** If any contacts failed to upload, download a report listing the failures. The report is sent to your OwnChat account using the associated upload ID.

{% embed url="<https://app.supademo.com/demo/cmqkwm1un03lquw0jckyiwzy2?utm_source=link>" %}

Click the **back arrow** to return to the previous screen.

### Managing Tags After Upload &#x20;

1. Click the **Contacts** tab.

{% embed url="<https://app.supademo.com/demo/cmqkwnxm703lsuw0jkfj6lcb4?utm_source=link>" %}

2. Click the **Settings** icon.

{% embed url="<https://app.supademo.com/demo/cmqkwpfxo03m1uw0jg39u78g6?utm_source=link>" %}

3. Click **Tags**.

Any tags applied during the upload — whether auto-generated or custom — can be viewed and managed from this section.

{% embed url="<https://app.supademo.com/demo/cmqkwr51u02cjuv0jxus0axta?utm_source=link>" %}

Any tags applied during the upload — whether auto-generated or custom — can be viewed and managed from this section.

{% embed url="<https://app.supademo.com/demo/cmqkws8vk034vyw0jzsigb6us?utm_source=link>" %}

### Summary &#x20;

<table data-header-hidden><thead><tr><th width="87"></th><th></th></tr></thead><tbody><tr><td><strong>Step</strong></td><td><strong>Action</strong></td></tr><tr><td>1</td><td>Open Contacts → Contacts tab → Add Customer → Advanced Bulk Upload</td></tr><tr><td>2</td><td>Upload CSV file (max 10 MB)</td></tr><tr><td>3</td><td>Set phone number prefix rule</td></tr><tr><td>4</td><td>Map fields under Target Property</td></tr><tr><td>5</td><td>Click Start Upload</td></tr><tr><td>6</td><td>Check results in Upload History</td></tr><tr><td>7</td><td>Review tags under Contacts → Settings → Tags</td></tr></tbody></table>