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

# Add labels to Gmail message

> Add labels to a Gmail message as part of a Workflow.

Use the **Add Labels to Gmail Message** action to apply labels to a Gmail message from within a [Workflow](/workflows/overview). This helps you automatically organize and categorize incoming emails.

## Set up the action

<Steps>
  <Step title="Add the action">
    While editing a Workflow, click the **+** button between existing blocks. Select **Add Labels to Gmail Message** from the action list.

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-0.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=c6b3a393237c5dbb0fa82b9a7d58b4b8" alt="Selecting the Add Labels to Gmail Message action" width="962" height="538" data-path="images/reference/add-labels-to-gmail-message-img-0.png" />
    </Frame>
  </Step>

  <Step title="Rename the action (optional)">
    Click the action name to give it a more descriptive label for easier reference.

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-1.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=e2a20be5979899dcd5428e4840955e08" alt="Renaming the Add Labels to Gmail Message action" width="1036" height="162" data-path="images/reference/add-labels-to-gmail-message-img-1.png" />
    </Frame>
  </Step>

  <Step title="Connect your Gmail account">
    If you haven't already, connect your Gmail account to Cassidy.

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-2.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=a3a85a9b66a37156ae9e10e6b19cff8d" alt="Adding a Gmail connection for the action" width="1036" height="1396" data-path="images/reference/add-labels-to-gmail-message-img-2.png" />
    </Frame>
  </Step>

  <Step title="Toggle on add labels to trigger email (optional)">
    If you're using this action with the **New Email Received in Gmail** trigger, enable **Add Labels to Trigger Email** to automatically apply labels to the email that started the Workflow.

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-3.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=ac7592ce324ab5c7004ce918bb912be1" alt="Add Labels to Trigger Email toggle" width="1040" height="140" data-path="images/reference/add-labels-to-gmail-message-img-3.png" />
    </Frame>
  </Step>

  <Step title="Enter the email (optional)">
    Enter an email ID manually, use a variable from previous steps (such as the message ID from a trigger), or click the list icon to search and select an email from the trigger.

    <Tip>If **Add Labels to Trigger Email** is enabled, this field can be left empty.</Tip>

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-4.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=525b23aeffe071c7ba1feaa9ac6e7bc5" alt="Email field with variable reference" width="1040" height="222" data-path="images/reference/add-labels-to-gmail-message-img-4.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-5.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=c40d0b66ddcd5481d8f6c27b49a10ae7" alt="Searching for an email to label" width="1042" height="222" data-path="images/reference/add-labels-to-gmail-message-img-5.png" />
    </Frame>
  </Step>

  <Step title="Enter labels to add">
    Search for and select existing Gmail labels, or click the pencil icon to manually enter label names. You can add multiple labels to organize your emails effectively.

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-6.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=9b0fafcb563316c63a24843f26a95011" alt="Searching for Gmail labels to add" width="1038" height="230" data-path="images/reference/add-labels-to-gmail-message-img-6.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/Z6P2Z1FAlUR83Sw5/images/reference/add-labels-to-gmail-message-img-7.png?fit=max&auto=format&n=Z6P2Z1FAlUR83Sw5&q=85&s=9aac656a034f7ed0ae36ad2a22f36890" alt="Selected Gmail labels" width="1036" height="216" data-path="images/reference/add-labels-to-gmail-message-img-7.png" />
    </Frame>
  </Step>
</Steps>

## Related

<CardGroup cols={2}>
  <Card title="New email trigger" icon="envelope" href="/integrations/google-workspace/gmail/new-email-trigger">
    Trigger a Workflow when a new email is received.
  </Card>

  <Card title="Send email with Gmail" icon="paper-plane" href="/integrations/google-workspace/gmail/send-email">
    Send an email from a Workflow.
  </Card>
</CardGroup>
