File Filtering Guide

Drive Toolbox provides a powerful filter system for finding exactly the files you need.

---

Filter Syntax

Filters use the format: field:operation:value

Basic Examples

name:contains:report
size:gt:10485760
is:folder
recently:modified:7d

---

Common Fields

File Properties

Field	Description	Example
name	File or folder name	name:contains:budget
mime_type	MIME type	mime_type:contains:pdf
size	File size in bytes	size:gt:1048576 (>1MB)
is	File type shortcut	is:folder or is:file

Time-Based Fields

Field	Description	Example
modified_time	Last modification time	modified_time:since:30d
created_time	When file was created	created_time:since:2024-01-01
viewed_by_me_time	Last time you viewed	viewed_by_me_time:since:7d

Ownership & Sharing

Field	Description	Example
owner_name	Owner display name	owner_name:contains:John
owner_email	Owner email address	owner_email:equals:user@example.com
permissions:anyone	Public sharing	permissions:anyone:reader
permissions:type	Permission type	permissions:type:user

Labels

Field	Description	Example
label	Custom labels	label:equals:project-alpha

---

Operations

String Operations

• equals - Exact match (case-insensitive)
• contains - Substring match
• starts_with - Starts with value
• ends_with - Ends with value

Numeric Operations

• gt (>) - Greater than
• lt (<) - Less than
• gte (>=) - Greater than or equal
• lte (<=) - Less than or equal

Time Operations

• since - After this time
• before - Before this time

---

Time Formats

Relative Time (Recommended)

7d          # 7 days ago
1w          # 1 week ago
30d         # 30 days ago
1h          # 1 hour ago

Absolute Time

2024-01-01
2024-01-01T12:00:00

---

Shortcuts

is: Shortcut

is:folder       # Show only folders
is:file         # Show only files

recently: Shortcut

recently:modified:7d    # Modified in last 7 days
recently:viewed:1w      # Viewed in last week
recently:created:30d    # Created in last 30 days

permissions: Shortcut

permissions:anyone:reader       # Publicly readable files
permissions:type:user           # Shared with specific users

---

Logical Operators

Combine multiple conditions with logical operators.

AND - All conditions must match

is:file AND name:contains:report
size:gt:1000000 AND mime_type:contains:pdf

OR - At least one condition must match

name:contains:doc OR name:contains:pdf
is:folder OR size:gt:10485760

NOT - Negates a condition

NOT is:folder
NOT label:archived
is:file AND NOT mime_type:contains:image

Parentheses - Group conditions

(name:contains:doc OR name:contains:pdf) AND is:file
is:file AND NOT (label:archived OR label:deleted)

---

Common Examples

Find Large PDFs

mime_type:contains:pdf AND size:gt:10485760

Find Stale Documents

mime_type:contains:document AND modified_time:before:1y

Find Public Spreadsheets

mime_type:contains:spreadsheet AND permissions:anyone:reader

Find Recently Shared Images

mime_type:contains:image AND recently:shared:7d

Security: Find Public Files

permissions:anyone:reader

Cleanup: Find Old Large Files

size:gt:104857600 AND modified_time:before:1y

---

File Sizes Reference

Size	Bytes	Filter Example
1 KB	1,024	size:gt:1024
1 MB	1,048,576	size:gt:1048576
10 MB	10,485,760	size:gt:10485760
100 MB	104,857,600	size:gt:104857600
1 GB	1,073,741,824	size:gt:1073741824

---

Tips

1. Use Quotes for values with spaces:

   name:contains:"Q1 Report"

2. Test Incrementally - Build complex filters step by step

3. Use Quick Filters - Start with pre-built filters in the sidebar

4. Save Frequently-Used Filters - Use the saved filters feature