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

# How Do I Manage My Customer List?

> Learn how to view, filter, and perform actions on your customer list in the Gameball dashboard.

You can access your **Customers** tab through the **Gameball Admin Dashboard**.

<Frame>
  <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/customers-tab-dashboard.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=06d4f8c337120bca2d70e7f2596b2687" alt="Customers tab in Gameball dashboard" width="2866" height="1316" data-path="images/product-docs/understanding-your-customers/customers-tab-dashboard.png" />
</Frame>

***

## Customer List Overview

Once you access the **Customers** tab on your Gameball dashboard, you will see a list of all customers along with key profile attributes that help you better understand and manage each customer's engagement level.

### Understand the Columns in the Customer List

| Column | Description |
| - | - |
| **Creation Date** | The date and time the customer profile was created in Gameball. |
| **Customer** | Displays the customer's full name and their unique Gameball ID. |
| **Customer Email** | The registered email address associated with the customer. |
| **VIP Tier** | The current tier of the customer based on your configured loyalty program. This includes both the tier order and tier name. |
| **Score / Total Amount Spent / Total Points Earned** | This column varies depending on your configured tiering-up method: if based on **Score**, this shows the current score; if based on **Amount Spent**, it shows cumulative spend; if based on **Points**, it shows the total points earned. You can learn more about the [Tiering-up methods](/product-documentation/programs/vip-tiers/tier-settings/tiering-up-methods). |
| **Points Balance** | Displays two types of points: **Active Points** (redeemable points currently available) and **Pending Points** (non-redeemable points awaiting the completion of the configured return window). Learn more about [Pending Points and Return Window](/product-documentation/programs/loyalty-points-earn/launch-and-configure-your-earn-pointing-system). |
| **Guest Tag** | Indicates that the customer placed an order as a guest and has not yet created an account on your platform. This tag is automatically displayed if the customer's status is identified as a guest. The [guest customers](/product-documentation/guides-strategies-faqs/supportive-guides/integrate-guest-customers) feature is available by default in Shopify or through custom integration with Gameball. |
| **Tags and Segments** | Lists any tags manually added to the customer, and the segments they belong to, based on dynamic rules or RFM logic. |

### Actions Available on Each Row

<Frame>
  <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/customer-row-actions.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=e89936a159d99b6f167fb6a00bc7113d" alt="Customer row actions" width="2202" height="754" data-path="images/product-docs/understanding-your-customers/customer-row-actions.png" />
</Frame>

Each customer in the list has a quick action menu that allows you to perform individual updates or actions directly from the list view. Here are the available actions:

| Action | Description | Availability |
| - | - | - |
| **View Customer** | Opens the detailed customer profile page, where you can review full data, points history, events, and more. | All platforms |
| **Adjust Tier** | Manually update the customer's VIP tier. This allows you to override the default tiering logic when needed. | All platforms |
| **Adjust Balance** | Manually add or deduct points from the customer's current balance. | All platforms |
| **Reward a Campaign Manually** | Manually reward a customer with a configured campaign. Useful for ad-hoc or support-related rewards. | All platforms |
| **Shopify Page** | Opens the customer's profile directly within your Shopify admin. | Shopify only |
| **Delete** | Permanently deletes the customer profile from Gameball. This option is **not available for Shopify or Salla integrations**. | Non-platform clients only |

***

## Customers Page-Level Actions

This section covers how to filter your customer list and how to apply single actions and bulk actions to one or more selected customers.

### Apply Filters to Refine the View

<Frame>
  <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/customer-list-filters.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=d3164f6eebbbacddf306a93ab5c7df2c" alt="Customer list filters" width="3002" height="772" data-path="images/product-docs/understanding-your-customers/customer-list-filters.png" />
</Frame>

You can use filters to narrow down the customer list based on specific attributes or behavioral data. Multiple filters can be applied at the same time for more advanced segmentation.

<Steps>
  <Step title="Open the filter panel">
    Click the **Filter** icon at the top of the Customers page.
  </Step>

  <Step title="Select filter options">
    Select from the available filter options listed below.
  </Step>

  <Step title="Define your criteria">
    Define your criteria (e.g., ranges, keywords, status).
  </Step>

  <Step title="Apply the filter">
    Click **Apply Filter** to view only the customers matching your selected criteria.
  </Step>
</Steps>

#### Available Filters

| Filter | Description |
| - | - |
| **Creation Date** | Filter by the date the customer was added to Gameball. |
| **Customer Type** | Filter between registered users and guests. |
| **Customer ID** | Search for a specific customer using their unique ID. |
| **Customer Name** | Search by full name. |
| **Customer Email** | Filter by email address. |
| **Customer Phone Number** | Filter by mobile number. |
| **Total Amount Spent** | Filter customers based on how much they've spent in total (or based on your configured tiering-up method). |
| **Points** | Filter by current total points. |
| **Pending Points** | Filter customers based on points currently in a pending state. |
| **Included** | Filter by inclusion or exclusion from your loyalty program. |
| **Tags** | Filter by one or more tags applied to customers. |
| **Segments** | Filter based on the customer's assigned dynamic segments. |
| **RFM Segments** | Filter by customers' RFM segments. |
| **Tier** | Filter by current VIP tier. |

<Note>
  All applied filters will remain active until you manually reset or remove them. The customer list and any bulk actions will reflect only the filtered results.
</Note>

### Perform Bulk Actions

<Frame>
  <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/bulk-actions-menu.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=04163ba149413c983d64fc5ae3603364" alt="Bulk actions menu" width="2508" height="772" data-path="images/product-docs/understanding-your-customers/bulk-actions-menu.png" />
</Frame>

You can apply actions to multiple customers simultaneously. This is useful when managing a filtered segment or performing large-scale updates.

<Warning>
  If a filter is applied, bulk actions will be applied **only to the filtered customers** currently visible in the list.
</Warning>

#### Available Bulk Actions

| Action | Description |
| - | - |
| **Reward a Campaign** | Manually assign a configured reward campaign to all selected customers. This is useful for delivering one-time rewards or campaign incentives in bulk instead of waiting for the customer to accomplish the reward campaign rules. |
| **Add/Deduct Points** | Directly adjust the points balance of selected customers by adding or deducting points. Useful for corrections or manual point rewards. |
| **Tag Filtered Customers** | Apply one or more tags to the selected customers for future targeting or segmentation. |
| **Include/Exclude Customers** | Bulk include or exclude selected customers from your Gameball loyalty program. |
| **Update Customers** | Update customer data in bulk via CSV. Labeled **"Update Customers"** on Shopify/Salla to update existing customer data. Labeled **"Update/Migrate Customers"** on non-platform integrations to support customer migration and updates. Customer creation and deletion are not allowed through Gameball for Shopify or Salla users -- these operations must be handled through the platform, and Gameball will sync automatically. |
| **Extract** | Export the filtered customer list to a CSV file, including detailed fields beyond those shown on screen. Read more about this through [Export Your Customer List](/product-documentation/understanding-your-customers/your-customers/export-your-customer-list). |

<Note>
  1. You cannot delete customers in bulk.
  2. There are some other bulk actions you can apply using the [batch creation API](/api-reference/batches/batch-creation).
</Note>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Export Your Customer List" icon="file-export" href="/product-documentation/understanding-your-customers/your-customers/export-your-customer-list">
    Export your customer data to a CSV file with detailed fields.
  </Card>

  <Card title="Customer Activity Log" icon="list-timeline" href="/product-documentation/understanding-your-customers/your-customers/customer-activity-log">
    Track all customer transactions and activities.
  </Card>

  <Card title="Group Customers by Tags" icon="tags" href="/product-documentation/understanding-your-customers/customer-profile/group-your-customers-by-tags">
    Use tags to manually group and target customers.
  </Card>

  <Card title="Explore a Customer Profile" icon="user" href="/product-documentation/understanding-your-customers/customer-profile/explore-and-manage-a-customer-profile">
    View and manage individual customer data.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.