> ## 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.

# What Are Group Your Customers by Tags?

> Use tags to manually group customers and customize special rewards and communication campaigns to be sent only to your tagged customers.

Tags let you group your customers manually. They are great for highlighting VIP customers who may need VIP rewards, loyal customers who should be treated differently, or when you need to simulate different rewards based on the assigned tags. For example, if you want to create and send communication campaigns, notifications, or assign reward campaigns to only a specific group of customers, tags are a great way to link between these customers and the assigned notifications, emails, or reward campaigns.

<Note>
  The maximum number of tags that can be created is **15 tags**.
</Note>

***

## How to Create Customer Tags

<Note>
  The following steps are also what you need to completely remove or delete a tag.
</Note>

<Steps>
  <Step title="Navigate to Customer Tags">
    On your Gameball dashboard, go to **Settings > Admin Settings > Customer Tags**.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/customer-tags-settings.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=cfe16d8fb9be539117c97ef46b1cf3d0" alt="Customer tags settings page" width="2424" height="1598" data-path="images/product-docs/understanding-your-customers/customer-tags-settings.png" />
    </Frame>
  </Step>

  <Step title="Create a new tag">
    On the top right of the page, click **Create New Tag**.

    <Frame>
      <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/create-new-tag-button.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=b2c192f6927afd6c861c16d35486abca" alt="Create new tag button" width="1782" height="824" data-path="images/product-docs/understanding-your-customers/create-new-tag-button.png" />
    </Frame>
  </Step>

  <Step title="Configure and save the tag">
    Add the tag **name** and choose the tag **color**, then click **Create**.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/tag-name-color-config.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=55f9dea935380695a0a10bae95e862bc" alt="Tag name and color configuration" width="1930" height="1054" data-path="images/product-docs/understanding-your-customers/tag-name-color-config.png" />
    </Frame>
  </Step>
</Steps>

***

## How to Tag Your Customers

<Tabs>
  <Tab title="Manual Tagging (Single)">
    <Note>
      The following steps are also what you need to remove tags from a customer.
    </Note>

    <Steps>
      <Step title="Open a customer profile">
        On your Gameball dashboard, go to **Customers**, then open any customer page.

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

      <Step title="Add a tag">
        Under the **Segments** section, beside **Tags**, click on **+Add**.

        <Frame>
          <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/add-tag-to-customer.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=8359acf73b2292f93e8e93e4289e7c3a" alt="Add tag to customer" width="2392" height="1382" data-path="images/product-docs/understanding-your-customers/add-tag-to-customer.png" />
        </Frame>
      </Step>

      <Step title="Select the tag">
        Search for the available tags and assign the tag to the customer.

        <Info>
          This is also where you remove a tag from a customer.
        </Info>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Bulk Tagging (Group)">
    <Steps>
      <Step title="Go to the Customers page">
        On your Gameball dashboard, go to **Customers**.

        <Frame>
          <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/customers-page-bulk.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=bebcbd36ea1a869364bc098ae331671c" alt="Customers page" width="2810" height="1520" data-path="images/product-docs/understanding-your-customers/customers-page-bulk.png" />
        </Frame>
      </Step>

      <Step title="Apply filters">
        Click on the **Filter Icon**.

        <Frame>
          <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/filter-icon-bulk-tag.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=32678b49ba062164f4bc6f89d526db7a" alt="Filter icon" width="2330" height="1414" data-path="images/product-docs/understanding-your-customers/filter-icon-bulk-tag.png" />
        </Frame>

        Filter your customers according to your needs, then click **More**.

        <Frame>
          <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/more-actions-bulk-tag.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=514a95e43d9e45a43d775f626ea844c5" alt="More actions menu" width="2328" height="1138" data-path="images/product-docs/understanding-your-customers/more-actions-bulk-tag.png" />
        </Frame>
      </Step>

      <Step title="Add or remove tags">
        Choose between adding or removing tags, then click on **+Add**.

        <Frame>
          <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/add-remove-tags-option.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=e9759ad85df80a70d81e34048f4c01ab" alt="Add or remove tags option" width="1406" height="780" data-path="images/product-docs/understanding-your-customers/add-remove-tags-option.png" />
        </Frame>
      </Step>

      <Step title="Select and apply tags">
        Scroll down and pick the desired tag(s), then click **Apply**.

        All customers in the currently active filter will be tagged with the selected tags.

        <Warning>
          If no filter is applied, the operation will automatically tag all customers on Gameball at the moment of the operation.
        </Warning>
      </Step>
    </Steps>
  </Tab>

  <Tab title="API Tagging">
    You can also tag customers using Gameball APIs. Check our [technical documentation](https://developer.gameball.co/rest-api/customers/customer-tags) for more details.
  </Tab>
</Tabs>

***

## What is Next?

<CardGroup cols={2}>
  <Card title="Configure Rewards by Tags" icon="gift" href="/product-documentation/loyalty-programs/configure-different-rewards-based-on-tags">
    Configure different rewards through reward campaigns for your customers based on tags.
  </Card>

  <Card title="Shopify Tag Sync" icon="shopify" href="/product-documentation/integrations/shopify-customer-tags-sync">
    Customer tags automatically sync with Gameball customers' tags on Shopify.
  </Card>
</CardGroup>
