Finds a Gmail label by its name.
class GmailApp method .getUserLabelByName()
GmailApp is the Apps Script service.
.getUserLabelByName() is the method name you will see after a dot in your code.
What it does
Why it's used
- Find your Invoices or Leads label before sorting mail.
- Apply existing labels instead of creating duplicates.
Common errors
- Forgetting parentheses on getUserLabelByName. Write GmailApp.getUserLabelByName(), not GmailApp.getUserLabelByName or getUserLabelByName by itself.
- Skipping dots between chained calls. Each step needs a dot, like GmailApp.search('label:inbox').getUserLabelByName().
- Adding spaces where they do not belong. Write GmailApp.getUserLabelByName(), not GmailApp .getUserLabelByName(), GmailApp.getUserLabelByName (), or GmailApp . getUserLabelByName().
- Wrong capitalization. Use GmailApp and getUserLabelByName, not gmailapp or getuserlabelbyname.
Snippets using this method
Explore
Related methods
-
.createLabel()
Creates a new Gmail label.
-
.sendEmail()
Sends an email from the user's Gmail account.
-
.search()
Finds Gmail threads that match a search query.
-
.getAliases()
Returns the email addresses the user can send from.
-
.getMessageById()
Loads a single email message by its ID.
More Apps Script
Better Sheets tutorials
Tag Emails From A List of Members in Google Sheets
Related blog posts
Written guides about GmailApp.getUserLabelByName().
How I Send Invoice Emails Straight From a Google Sheet (With a Script You Can Copy)
A copy-ready Apps Script that emails invoices from a Google Sheet, flags bad rows, and nudges overdue clients once a week. A guest post by Tahir Abbas.
Read post →Automated Project Management in Google Sheets
When you have multiple people working on multiple tasks, and you want everyone to be on the page, what do you do? You can use a Google Sheet. But managing projects can be an intimidating task in Google Sheets. It's a lot of data entry, right? Especially when you have multiple people working on different tasks with different statuses across different projects. Data entry for multiple projects, with different people, tasks, and statuses – it gets messy fast! I'm no stranger to these issues...
Read post →Email Yourself a Cell from a Google Sheet, Every Day
I'll show you how to email yourself one single cell data. That's one sheet, one cell, one email every single day.
Read post →