[Google Drive] List Files
The [Google Drive] List Files block retrieves a list of files from a specified Google Drive folder and returns their metadata.
List files in a Google Drive folder
The [Google Drive] List Files block retrieves a list of files from a specified Google Drive folder and returns their metadata. It connects to Google Drive via an OAuth connection and accepts a folder ID to target a specific directory, or defaults to the root folder if no ID is provided. A limit parameter controls how many files are returned, with a default of 20.
The block outputs an array of file objects, each containing fields such as the file's ID, name, MIME type, size, web view link, created time, and modified time. Results can be stored in a workflow variable in either JSON or plain text format, depending on how downstream blocks need to consume the data.
This block fits into workflows that need to audit or process Drive contents, such as dynamically generating file lists for a user interface, triggering actions based on recently modified files, or feeding file metadata into subsequent blocks that download, categorize, or summarize documents.
What you can build
Real-world workflows powered by the [Google Drive] List Files block.
Document Inventory Report
Retrieve all files in a project folder and compile a structured inventory report listing file names, types, and last modified dates.
Recent File Notifications
List files in a shared Drive folder and filter by modification time to notify team members when new documents have been added.
Automated File Processing
Fetch a list of files from a designated intake folder and pass each file's ID to downstream blocks for parsing or transformation.
Dynamic File Picker
Populate a user-facing file selection interface by listing available Drive files and presenting their names and web view links as options.
Content Audit Workflow
List all files in a Drive folder and evaluate MIME types and sizes to identify oversized or unsupported file formats.
Backup Verification Check
List files in a backup Drive folder and compare the returned file names and counts against an expected manifest to confirm completeness.
Ready to add [Google Drive] List Files to your workflow?
Get Started FreeCommon questions about [Google Drive] List Files
What parameters does this block require?
The block requires a Google OAuth connection ID with Drive scope. The folder ID is optional — if omitted, the block defaults to listing files in the root Drive folder. You can also set a limit on the number of files returned (default is 20) and specify a destination variable and output format (JSON or text).
What does the block return for each file?
Each file in the output array includes the following fields: id, name, mimeType, size, webViewLink, createdTime, and modifiedTime.
How do I target a specific folder instead of the root?
Set the folderId parameter to the Google Drive folder ID of the directory you want to list. If folderId is left blank, the block lists files in the root folder by default.
What kinds of workflows commonly use this block?
This block is commonly used in workflows that process or audit Drive contents, such as automated document pipelines, file notification systems, dynamic file selection interfaces, and backup verification checks.
Can I control how many files are returned?
Yes. The limit parameter sets the maximum number of files the block will return. The default value is 20 if no limit is specified.
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] List Files to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.