> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/customers/importing-customers-in-bulk/updating-customers-in-bulk.md).

# Updating Customers in Bulk

Bulk importing customers in Supply’d saves time, ensures accuracy, and reduces manual errors, streamlining customer management.

**Bulk Updating Customers** allows you to update information for multiple customers at once using a CSV spreadsheet, rather than editing each customer individually. This provides a quick and efficient way to maintain customer records and make changes across a large number of customers.

This document explains how to prepare the CSV and import your customer updates into Supply’d.

***

### Bulk Import/Add Customers

{% stepper %}
{% step %}

#### Open the Import Customers Form

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FrGorK0oqLf2o4kucSn2n%2FSpacer.png?alt=media&amp;token=4df3c21b-5132-47ed-a158-93dd7d96bcff" alt=""><figcaption></figcaption></figure>

1. Select **Customers** from the menu.
2. Click on the 3 dots on the top right corner
3. Select **Import** then **Customers**.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FKjXcl5Kjllp7WXMg5kto%2FSpacer.png?alt=media&amp;token=57f4d5f1-4b2b-4fd5-baff-3c03bfacd9a7" alt=""><figcaption></figcaption></figure>

![](https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F1rvIrJfYoTozYrw8xuP6%2FCustomers%20-%203%20Dot%20Import%20Customers.png?alt=media\&token=d313a10c-2a5a-48af-a3d3-d05535de81a1)

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

The **Import Customers** form will open.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FHzTfwV9ptVFCo0cBLaia%2FSpacer.png?alt=media&amp;token=0d7b137e-7f65-4c98-827a-eff2fff3cd24" alt=""><figcaption></figcaption></figure>

<img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FH74sKj6SSTzX30w22aJr%2F4%20-%20Import%20Customers%20Form.png?alt=media&amp;token=399b209b-defa-4b6b-98c2-1b8514812b7c" alt="" width="563">

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FnhJUaZPFm4Kvl5OAiN1J%2FSpacer.png?alt=media&amp;token=00382091-fcf6-47b3-a58d-a11f5ec0868e" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Download Template

Click on the **Download the template** link to get our base template.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FrtmClRmD3d8wCJB6HEiU%2FSpacer.png?alt=media&amp;token=d996dd79-1313-4ed0-a3e3-e7e47de1191f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fd53tG3d3QTUd4ohxpD7L%2F5%20-%20Download%20Link.png?alt=media&amp;token=cfc64c86-6c5a-4bdf-983e-c7d87f88b4d3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FrtmClRmD3d8wCJB6HEiU%2FSpacer.png?alt=media&amp;token=d996dd79-1313-4ed0-a3e3-e7e47de1191f" alt=""><figcaption></figcaption></figure>

The **Export Customers** form will open.&#x20;

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FJ20ppnsd9OFatTG1Hebi%2FSpacer.png?alt=media&amp;token=4c28a4d6-aa8a-4a13-bb27-8fcff5f30d17" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fnaon8F5KU0oKQjF2VdNB%2FExport%20Customers%20Form.png?alt=media&amp;token=61af1dc1-337b-4275-8d7f-91a8dbc56404" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F0nQ1gzqc32HnJ4z8IxuC%2FSpacer.png?alt=media&amp;token=24eac12c-597e-4bec-b32a-5b8ab65985b7" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Select Your Data

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Data Source**

Select **Supply'd** from the menu to export your existing customer data as the basis for your bulk update.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FuO7VawXbOu3uLfp5eyVD%2FSpacer.png?alt=media&amp;token=c90cae59-d9e4-4c76-9c22-b65e12a661ee" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FTg9Diq15ltQLuNIwqx3R%2F7%20-%20Data%20Source.png?alt=media&amp;token=885bc42c-944c-4720-94b3-80349837d1e9" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FuO7VawXbOu3uLfp5eyVD%2FSpacer.png?alt=media&amp;token=c90cae59-d9e4-4c76-9c22-b65e12a661ee" alt=""><figcaption></figcaption></figure>

**Fields**

Select the type of data would you like to include in the export by ticking the relevant boxes.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FrtmClRmD3d8wCJB6HEiU%2FSpacer.png?alt=media&amp;token=d996dd79-1313-4ed0-a3e3-e7e47de1191f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fzp2nMFmKWSh9QJn5kirJ%2F8%20-%20Fields.png?alt=media&amp;token=8ef1ef62-2efe-4401-834e-6ca68b164ab8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FrtmClRmD3d8wCJB6HEiU%2FSpacer.png?alt=media&amp;token=d996dd79-1313-4ed0-a3e3-e7e47de1191f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The more options you select in the **Fields** section, the more data fields will be included in the spreadsheet.&#x20;
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FrtmClRmD3d8wCJB6HEiU%2FSpacer.png?alt=media&amp;token=d996dd79-1313-4ed0-a3e3-e7e47de1191f" alt=""><figcaption></figcaption></figure>

Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FaKv23x6deJaFfFYcujIE%2FEXPORT.png?alt=media&amp;token=0991e782-ce66-48ba-a7a7-e53b2cc5363e" alt="" data-size="line"> to save the template to your computer.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Remove Unwanted Columns

Open the CSV in **Excel** or **Numbers**. Remove all unnecessary columns from the CSV, keeping only the specific fields you wish to change (eg. Price or Category).

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FT3iB5zowMx0NG9ez8hVY%2FSpacer.png?alt=media&amp;token=add2af5a-90dd-4bb3-83bd-14786d1f8c47" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
When bulk updating existing customers in Supply'd via a CSV file, following a "lean" approach is recommended to prevent data loss or operational disruption. Keeping only the fields you want to change makes the import easier to manage, reduces processing time, and minimises the risk of unintentionally changing other customer information.

For example, if you only want to update a customer’s **Name** and **Email Address**, keep the **Customer ID**, **Name**, and **Email Address** columns and remove the other fields from the CSV. Any fields that are removed from the CSV will not be changed during the import.

**Important:** Keep the **ID** column for every product you want to modify. The **Product ID** identifies the specific product that Supply’d should update.<br>

**Why This Method is Best Practice**<br>

* **Avoids User Conflicts:** Helps prevent changes from interfering with team members editing the same customers.
* **Prevents Data Deletion:** Leaving unnecessary fields blank can cause existing data to be cleared.
* **Improves Efficiency:** A smaller CSV reduces processing time and the risk of import errors.<br>

Keeping only the fields you need ensures the import is focused and reduces unintended changes.
{% endhint %}

{% hint style="danger" %}
**Important:** The title row should remain in the document in order for the system to match the columns when imported.&#x20;
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FT3iB5zowMx0NG9ez8hVY%2FSpacer.png?alt=media&amp;token=add2af5a-90dd-4bb3-83bd-14786d1f8c47" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Complete the Template

Enter the information you want to update, and follow the guidance in the following documents for completing the various fields in each template.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

* [Customer Details](/supplyd-erp/customers/importing-customers-in-bulk/customer-details.md)
* [Customer Location Info](/supplyd-erp/customers/importing-customers-in-bulk/customer-location-info.md)
* [Customer Contact Info](/supplyd-erp/customers/importing-customers-in-bulk/customer-contact-info.md)

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

* Follow the column headings carefully.
* Do not change column names.
* Leave **Customer Number** fields blank for new records.
* Delete any sample data before importing.
* Double-check that all required fields are filled out correctly before uploading.
  {% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FuSRBjdntI5dIChhStZu4%2FSpacer.png?alt=media&amp;token=39daa17c-27f2-4f0f-8337-a39003b29f03" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Export/Save the File

Once you have completed filling out the spreadsheet, ensure that you save or export it as a CSV file as this format is required for successful import into Supply’d.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Upload the File

On the **Customers** page, click on the 3 dots in the top right and select **Import**, then **Customers**.

The **Import Customers** form will open.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

In the **Upload CSV File** field, click on <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FAHcGnt28z2BtQWtiD5IF%2FChoose%20file.png?alt=media&amp;token=9dbab1b7-4a9b-4847-85f3-aaad11128dd5" alt="" data-size="line"> to select the CSV file you just completed.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FoeJYxCP0tRRdirDp2fQC%2FSpacer.png?alt=media&amp;token=40457edd-ac10-4e6b-b06d-d5467d1244c3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FaXfVz6L1v5TXgeVrf6Bw%2FChoose%20File.png?alt=media&amp;token=6e25d454-ad13-4be3-b571-fd36856e5f47" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
After selecting the file please ensure you wait for the file to successfully upload before clicking Import.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<br>

***

{% endstep %}

{% step %}

#### Choose Update Existing Customers

In the **Update Existing Customers** field, select **Yes** to update your existing customers.

![](https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media\&token=6c34f805-9610-4de9-8f8a-a029f13dd1a1)

***

{% endstep %}

{% step %}

#### Upload Your File

Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FQBxUle8sL618as2HgazW%2FIMPORT.png?alt=media&amp;token=f05ad04f-2150-40b8-9f14-67f5de2a7881" alt="" data-size="line"> to begin the upload process.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% 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 dynamically by asking a question.

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

```
GET https://help.supplyd.co/supplyd-erp/customers/importing-customers-in-bulk/updating-customers-in-bulk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
