Definition

The Update Gmail Label action allows you to update properties of an existing Gmail label for a user within your Google Workspace domain. Using a Google Workspace Administration connection with domain-wide delegation, this action enables administrators to modify label names, adjust their visibility in the Gmail web interface (both in the label list and message list), and ensure consistent label management across user accounts. This is useful for maintaining a standardized email organization system, enhancing user experience, and supporting email governance policies.

Example Use Cases

1. Standardize Labels Across Accounts
Update label names and visibility settings across multiple user accounts to maintain consistent email organization throughout the organization.

2. Rebrand or Rename Labels
Easily rename labels when a department or project name changes without needing users to manually update their own Gmail settings.

3. Hide or Show Labels Based on Policy
Adjust the visibility of labels to hide sensitive or outdated categories from user view, or show new important labels prominently.

4. Improve User Email Navigation
Make important labels visible in users' inboxes to help them quickly find and manage key emails, improving productivity.

5. Automate Label Management
Integrate this action into automated workflows to dynamically update labels based on organizational changes, user roles, or activity.

Inputs

Connection
A Google Workspace Administration connection. You must upload a credential JSON file for a service account with domain-wide delegation. Guide to create one.

User Email
The email address of the user whose label you want to update.

Label
The ID or the Title of the label you want to update. You can find the Label ID or Title using actions like "List Gmail Labels" or "Find Gmail Label."

Select Fields for Update
Choose the specific label fields you want to update:

• Name: Update the display name of the label.
• Label List Visibility: Set how the label appears in the label list (options: Label show, Label show if unread, Label hide).
• Message List Visibility: Set the visibility of messages with this label in the message list (options: Show, Hide).

Outputs

Label Id
The immutable and unique ID assigned to the label. It remains the same even if you update other properties of the label.

Name
The updated display name of the label as it appears in the Gmail web interface.

Message List Visibility
Indicates how messages with this label are displayed in the message list. Possible values include "show" or "hide."

Label List Visibility
Indicates how the label itself appears in the Gmail label list. Options include "label show", "label show if unread" or "label hide".

Example of using

An IT administrator wants to organize user mailboxes by updating old project labels across the company. For instance, a label named "Project Alpha" needs to be renamed to "Project Alpha (Archived)" and hidden from the main label list to avoid clutter.

Using the Update Gmail Label action, the admin selects the label to update, changes the Name to "Project Alpha (Archived)," sets the Label List Visibility to "label hide," and keeps the Message List Visibility as "show" so emails under this label remain accessible via search. This way, mailboxes stay clean without losing important historical data.