# Customer Management

## Purpose

Customer Management allows you to:

* Create and maintain customer profiles linked to your projects and sites.
* Store contact and business details such as representative, VAT, and registration numbers.
* Streamline communication and document generation across your organization.

## Accessing Customer Profiles

In the **side navigation**, click **Settings → Customer Profiles**

{% hint style="info" %}
[Click here to view how to access Customer Profiles](https://docs.cloudscaff.com/settings/accessing-settings)
{% endhint %}

## **Open Customer Profiles**

Click **Customer Profiles**

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FcjLGBCV6ZdkusQomZJmI%2FScreenshot%202025-11-03%20at%2009.21.55.png?alt=media&#x26;token=da8c28a0-c619-43ef-a4f6-5ae0ad8619e1" alt="" width="375"><figcaption></figcaption></figure></div>

## Customer Profiles Overview

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FZ9nclrKNhmshCxlEhMQk%2FScreenshot%202025-11-03%20at%2009.22.02.png?alt=media&#x26;token=32ac5628-2afb-421a-a798-ec3bd597e0f2" alt=""><figcaption></figcaption></figure></div>

### **Customers List Page**

This is the main list view where all customers in your organization are displayed.

#### **Fields shown:**

* **Company** — The customer’s registered business name.
* **Representative** — The assigned contact person for the company.
* **Email** — The contact email of the representative or company.
* **Country** — The customer’s location.

#### **Actions and Controls:**

**Search Bar:**&#x20;

* Use the top search field to filter customers by *company name, email, or country*.&#x20;
* The search activates after three characters are entered.&#x20;
* Click the **“X”** to clear your search and view the full list again.

{% hint style="info" %}
[Learn how to use the search bar](https://docs.cloudscaff.com/general-tools-and-features/search-and-filter-bar)
{% endhint %}

**Rows per Page Selector (100):**

Choose how many customer entries to display at once.

{% hint style="info" %}
[Learn how to use the rows per page](https://docs.cloudscaff.com/general-tools-and-features/table-pagination-and-rows-per-page-selector)
{% endhint %}

**Floating Action Button (➕):**\
Found in the bottom-right corner — clicking it opens the **Create Customer** form.

{% hint style="info" %}
[Learn how to use the create button](https://docs.cloudscaff.com/general-tools-and-features/create-button-+)
{% endhint %}

At the bottom, you’ll see “0 selected / x total,” indicating how many customers are currently selected from the list.

***

## Customers List (After Adding a New Customer)

### **Updated Customer List**

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FXqPewu93hICMdvFiJz97%2FScreenshot%202025-11-03%20at%2009.26.19.png?alt=media&#x26;token=889c83c7-963c-4381-84ea-cb7dfbbafc67" alt=""><figcaption></figcaption></figure></div>

Once saved, the system redirects you back to the **Customers List View**.

The newly added **Sample Customer** now appears in the list alongside existing entries.

**Displayed Columns:**

* **Company:** Sample Customer
* **Representative:** John Doe
* **Email:** <sample@customer.com>
* **Country:** United States

The total count at the bottom updates accordingly (e.g., “0 selected / 2 total”).

***

## Best Practices

* **Always use accurate company names** to maintain consistency across documents.
* **Add representative details** to improve traceability in quotes, invoices, and reports.
* **Use the VAT toggle** for international or non-taxable clients.
* **Review address entries** via the integrated map search for better data accuracy.
* **Keep customer profiles up to date** for smoother project assignment and document linking.

> Tips:
>
> Use **Search** frequently to avoid duplicates before adding new customers.
>
> Keep the **Contact Number** and **Representative** fields filled in to ensure quick communication.
>
> Customers created here automatically become available on all documents.
>
> If a customer changes details (like VAT or address), update their profile — changes apply system-wide instantly.
