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.
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
No tagged tutorials yet. Fetch Apps Script from the harvest table and this page fills automatically.
Related blog posts
Written guides about GmailApp.getUserLabelByName().
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 →Simply Email Yourself From a Google Sheet
I wanted to share with you one of the simplest apps scripts that has immense power. Email! You can email others, but you can also email yourself.
Read post →