[Google Drive] Search Files
The [Google Drive] Search Files block queries a connected Google Drive account and returns a list of files matching a given keyword.
Search for files in Google Drive by keyword
The [Google Drive] Search Files block queries a connected Google Drive account and returns a list of files matching a given keyword. It uses Google Drive's fullText search, meaning it searches across both file names and file content. The search is scoped to a Google OAuth connection you configure, and results can be stored in a workflow variable in either JSON or plain text format.
The block accepts a query string as its primary input, along with an optional limit parameter that controls how many files are returned (defaulting to 20). Each file in the results includes its ID, name, MIME type, size, a web view link, and both created and modified timestamps. This gives downstream blocks enough information to display, filter, or act on specific files without additional lookups.
This block fits into workflows that need to locate files before performing further operations — for example, finding a document to read, identifying recently modified files, or surfacing assets based on user-provided search terms. It works alongside other Google Drive or document-processing blocks to build end-to-end file retrieval and processing pipelines.
What you can build
Real-world workflows powered by the [Google Drive] Search Files block.
Locate Documents by Topic
A user submits a topic or keyword, and the block searches Google Drive to surface relevant documents for review or summarization.
Find Recent Project Files
Search for files matching a project name and use the returned modifiedTime field to identify the most recently updated assets.
Drive-Based Knowledge Retrieval
Query Google Drive for files related to a user's question, then pass the webViewLink or file ID to a reading block to extract and summarize content.
Asset Discovery for Reports
Search for spreadsheets or presentations by keyword before compiling them into an automated report or digest.
File Existence Check
Run a keyword search to verify whether a specific file or category of files already exists in Drive before creating a new one.
Content Audit Workflow
Search for files matching a naming convention or topic to build an inventory list, using the returned name, mimeType, and size fields.
Ready to add [Google Drive] Search Files to your workflow?
Get Started FreeCommon questions about [Google Drive] Search Files
What parameters does this block require?
The only required parameter is a query string, which is the keyword used to search Google Drive. You also need a Google OAuth connection configured with Drive scope. Optional parameters include a limit (maximum number of files to return, defaulting to 20), a destination variable name, and an export format of either JSON or text.
What does the block return?
The block returns an array of file objects. Each object includes the file's id, name, mimeType, size, webViewLink, createdTime, and modifiedTime. This data can be stored in a workflow variable for use by downstream blocks.
How does the search work — does it search file names only?
The block uses Google Drive's fullText search, which searches across both file names and file content, not just file names.
What kinds of workflows commonly use this block?
This block is commonly used in workflows that need to locate files before taking further action — such as retrieving a document to read or summarize, checking whether a file exists, or surfacing assets based on user input. It typically appears early in a workflow, with its output passed to other blocks for processing.
Can I control how many files are returned?
Yes. The limit parameter lets you set the maximum number of files the block returns. If no limit is specified, it defaults to 20.
Related capabilities
[Google] Create Google Doc
Create a new Google Document and optionally populate it with content.
[Google] Update Google Doc
Update the contents of an existing Google Document.
[Google] Fetch Google Doc
Fetch the contents of an existing Google Document.
[Google] Create Google Sheet
Create a new Google Spreadsheet and populate it with CSV data.
[Google] Update Google Sheet
Update a Google Spreadsheet with new data.
[Google] Fetch Google Sheet
Fetch contents of a Google Spreadsheet range.
Add [Google Drive] Search Files to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.