Finds Gmail threads that match a search query.
class GmailApp method .search()
GmailApp is the Apps Script service.
.search() is the method name you will see after a dot in your code.
What it does
Why it's used
- Find emails from a client, with an attachment, or from last week.
- Pull matching threads into a tracker automatically.
Common errors
- Forgetting parentheses on search. Write GmailApp.search(), not GmailApp.search or search by itself.
- Skipping dots between chained calls. Each step needs a dot, like GmailApp.search('label:inbox').search().
- Adding spaces where they do not belong. Write GmailApp.search(), not GmailApp .search(), GmailApp.search (), or GmailApp . search().
- Wrong capitalization. Use GmailApp and search, not gmailapp or search.
Snippets using this method
Explore
Related methods
-
.getThreadById()
Loads an email thread by its ID.
-
.getInboxThreads()
Returns email threads from the user's inbox.
-
.sendEmail()
Sends an email from the user's Gmail account.
-
.getUserLabelByName()
Finds a Gmail label by its name.
-
.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.search().
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 →