> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kelviq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> View and manage customer details, subscriptions, and entitlements.

Managing customers sits at the center of Kelviq. Each customer connects directly to their subscriptions, the plans behind them, and the features they own. You need to understand these relationships to handle the full customer lifecycle.

## View customer list

Select **Customers** in the main navigation to see your list.

You can do a few things here.

* **Search** by name, email, or identifier.
* **Add a new customer** with the button in the top right.
* **Manage a customer** by clicking their row to see details.

<Frame>
  <img height="200" src="https://mintcdn.com/kelviq/z-wBYQIaQnpJgqLp/images/customers-list.png?fit=max&auto=format&n=z-wBYQIaQnpJgqLp&q=85&s=16ad57dee762140c4681bf9db4d9e2b2" data-path="images/customers-list.png" />
</Frame>

## Add a new customer

You can create records manually.

<Steps>
  <Step title="Open the modal">
    Click **+ New customer** in the top right of the list page.
  </Step>

  <Step title="Fill in details">
    You need to provide a few key pieces of info.

    * **Customer name** is required. Use the person's full name or company name.
    * **Identifier** is the unique ID the API uses. We auto-generate this based on the name, but you can edit it. Linking this to the ID in your own database is usually a good idea.
    * **Email address** is optional.
  </Step>

  <Step title="Create">
    Click **Create** to finish.

    If you are adding a batch of people, toggle on **Create more**. This keeps the window open so you can add the next one immediately.
  </Step>
</Steps>

<Frame>
  <img height="200" src="https://mintcdn.com/kelviq/8ggvZoirdKoWHD96/images/create-customer-modal.png?fit=max&auto=format&n=8ggvZoirdKoWHD96&q=85&s=c9fed57c0659dd3ce876ce1fdfad69d4" data-path="images/create-customer-modal.png" />
</Frame>

<Note>
  More than one customer record can use the same email address, but every record must have a unique **Identifier**. The API calls this value `customerId`.

  When recreating a test customer, you can reuse the email address, but you must provide a new Identifier. An Identifier cannot be reused after its customer is archived. If you receive a `customer already exists` error, check the Identifier first.
</Note>

## Manage existing customers

You can edit details or revoke access from the list view.

### Edit a customer

Click the **three dots** on the right side of the customer row and select **Edit**.

<Frame>
  <img height="200" src="https://mintcdn.com/kelviq/z-wBYQIaQnpJgqLp/images/edit-customer.png?fit=max&auto=format&n=z-wBYQIaQnpJgqLp&q=85&s=530d59d9a5b2320fbcb1b6b6b601cb7c" data-path="images/edit-customer.png" />
</Frame>

You can update the **Customer name** and **Email address**. The Identifier is fixed after creation and cannot be changed.

### Archive a customer

Archiving makes a customer inactive and revokes their access. Click the **three dots** and select **Archive**.

<Frame>
  <img height="200" src="https://mintcdn.com/kelviq/8ggvZoirdKoWHD96/images/archive-customer.png?fit=max&auto=format&n=8ggvZoirdKoWHD96&q=85&s=f903dd2adafcf7304b8e66779e1a5a81" data-path="images/archive-customer.png" />
</Frame>

You will see a confirmation warning. Click **Confirm** to proceed.

Kelviq archives customers; it does not hard-delete them. The archived record keeps its Identifier, so that value cannot be reused. To create another customer with the same email address, use a new Identifier.

<Warning>
  You cannot archive a customer with an active subscription. You must cancel their subscription first.
</Warning>

## Customer details

Click on any customer row to open their full profile.

This page holds the source of truth for that user. You can see their unique Billing ID and timestamps for when they joined or were last updated.

<Frame>
  <img height="200" src="https://mintcdn.com/kelviq/z-wBYQIaQnpJgqLp/images/customer-details.png?fit=max&auto=format&n=z-wBYQIaQnpJgqLp&q=85&s=39cb803d7a8d7104aab328fca23d1d0d" data-path="images/customer-details.png" />
</Frame>

### Subscriptions

This section lists active and past plans. It shows the status, such as Active or Canceled, and the relevant dates.

### Files, links, and license keys

The customer detail page shows the deliverables the customer received through their plans:

* **Files** — View and download digital files available to the customer.
* **Links** — Open private or external resource links attached to the plan.
* **License keys** — View issued license keys and use the available license-management controls.

These sections let support teams confirm access without opening each order separately.

For catalog setup, see [Digital Downloads](/product-catalog/digital-downloads), [Links](/product-catalog/links), and [License Key Management](/product-catalog/license-keys).

### Entitlements

This view shows exactly what the customer can do right now based on their plan.

**Overrides**
You often need to make exceptions for specific users. You can do that here without changing the underlying plan.

* Change the value of a specific feature.
* Update the usage limit for a metered feature.

Changes made here apply only to this specific customer.

<Frame>
  <img height="200" src="https://mintcdn.com/kelviq/zxuAZ9x4rKMm5CXp/images/entitlements-details.png?fit=max&auto=format&n=zxuAZ9x4rKMm5CXp&q=85&s=8e9cd6766b157de04d3645b83d0176ec" data-path="images/entitlements-details.png" />
</Frame>

### Usage

This tracks consumption for usage-based billing.

* Graphs show usage trends over time.
* Hover over the data to see exact numbers for specific periods.

<Frame>
  <img height="200" src="https://mintcdn.com/kelviq/zxuAZ9x4rKMm5CXp/images/entitlements-full-details.png?fit=max&auto=format&n=zxuAZ9x4rKMm5CXp&q=85&s=cd730e68809535f69ecc8004372db962" data-path="images/entitlements-full-details.png" />
</Frame>
