Advanced Filtering

Advanced Filtering Guide

This guide covers the comprehensive filtering system in R2 Bucket Manager, including basic text filtering and advanced filters for extensions, file size, and upload dates.

---

Overview

R2 Bucket Manager provides a powerful multi-layered filtering system that helps you quickly locate files in large buckets. You can combine multiple filter types simultaneously for precise results.

Filter Types

1. Basic Text Filter - Search by filename or folder name
2. Type Filter - Show all items, files only, or folders only
3. Extension Filter - Filter by file extensions with quick presets
4. Size Filter - Filter by file size ranges
5. Date Filter - Filter by upload date ranges

---

Basic Filtering

Text Search

Located at the top of the file list, the text search filters files and folders by name.

How to Use:

1. Type in the search box above the file list
2. Results update in real-time as you type
3. Click the ✕ button to clear the search
4. View the match counter: "23 of 156"

Features:

• Case-insensitive search
• Searches filename/folder name only (not full paths)
• Real-time updates
• Works in both grid and list views

Example:

• Searching "report" will match:
  • monthly-report.pdf
  • Q4-Report.xlsx
  • sales_report_2024.csv

Type Filter

Filter to show only files, only folders, or both.

Options:

• All - Shows both files and folders (default)
• Files Only - Shows only files
• Folders Only - Shows only folders

---

Advanced Filtering

Extension Filter

Filter files by their file extension using quick presets or custom selection.

Quick Filter Buttons

One-click filters for common file type groups:

Button	Extensions Included
📷 Images	.jpg, .jpeg, .png, .gif, .webp, .avif, .heic, .svg, .bmp, .psd
📄 Documents	.pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .txt, .csv, .md, .rtf
🎬 Videos	.mp4, .mov, .webm, .avi, .mkv, .wmv, .flv, .mpeg, .mpg, .3gp, .m4v, .ogg, .ogv
🎵 Audio	.mp3, .wav, .flac, .aac, .m4a, .ogg, .oga, .opus
💻 Code	.js, .ts, .jsx, .tsx, .py, .java, .cpp, .cs, .go, .rs, .html, .css, .json, .xml, .yaml, .yml, .sql
📦 Archives	.zip, .rar, .7z, .tar, .gz
🔤 Fonts	.ttf, .otf, .woff, .woff2, .eot

How to Use Quick Filters:

1. Click the Extensions button
2. Click a quick filter button (e.g., "📷 Images")
3. All matching extensions in your bucket are selected
4. Click the same button again to deselect

Custom Extension Selection

Select specific extensions from files available in your current folder.

How to Use:

1. Click the Extensions button
2. Scroll through "Available Extensions" section
3. Check/uncheck individual extensions
4. Each extension shows count: .pdf (23)
5. Click Clear to reset selection

Features:

• Multi-select: Choose multiple extensions simultaneously
• Extension counts: See how many files of each type
• Sorted by frequency: Most common extensions appear first
• Only shows extensions that exist in current folder

Example Use Cases:

• Select only .pdf and .docx to view documents
• Filter all image formats except .svg
• Find all code files (.js, .ts, .jsx, .tsx)

---

Size Filter

Filter files by their size with preset ranges or custom min/max values.

Preset Size Ranges

Range	Description
All Sizes	No size filtering (default)
< 1 MB	Files smaller than 1 megabyte
1 - 10 MB	Files between 1 and 10 megabytes
10 - 50 MB	Files between 10 and 50 megabytes
50 - 100 MB	Files between 50 and 100 megabytes
> 100 MB	Files larger than 100 megabytes

How to Use Presets:

1. Click the Size button
2. Select a preset range (radio buttons)
3. Filter applies immediately
4. Active range shows in button: "Size: 1-10 MB"

Custom Size Range

Set your own minimum and maximum file sizes.

How to Use:

1. Click the Size button
2. Scroll to "Custom Range" section
3. Enter Min (MB) (optional)
4. Enter Max (MB) (optional, leave empty for no limit)
5. Click Apply

Examples:

• Min: 5, Max: 15 → Files between 5-15 MB
• Min: 50, Max: empty → Files larger than 50 MB
• Min: 0, Max: 0.5 → Files smaller than 500 KB

Tips:

• Use decimals for KB precision: 0.5 = 500 KB
• Leave Max empty for "greater than" filters
• Set Min to 0 for "less than" filters

---

Date Filter

Filter files by their upload date with preset ranges or custom date selection.

Preset Date Ranges

Range	Description
All Dates	No date filtering (default)
Today	Files uploaded today
Last 7 Days	Files uploaded in the past week
Last 30 Days	Files uploaded in the past month
Last 90 Days	Files uploaded in the past quarter
This Year	Files uploaded this calendar year

How to Use Presets:

1. Click the Date button
2. Select a preset range (radio buttons)
3. Filter applies immediately
4. Active range shows in button: "Date: Last 7 Days"

Custom Date Range

Select specific start and end dates.

How to Use:

1. Click the Date button
2. Scroll to "Custom Range" section
3. Select From date (optional)
4. Select To date (optional)
5. Click Apply

Date Pickers:

• Native HTML5 date inputs
• Cannot select future dates
• End date must be after start date
• Leave either field empty for open-ended ranges

Examples:

• From: 2024-10-01, To: 2024-10-31 → October 2024
• From: 2024-01-01, To: empty → All files from 2024 onward
• From: empty, To: 2024-09-30 → All files before October 2024

---

Filter Management

Active Filter Badges

Visual badges show all active filters at the top of the file list.

Features:

• Icon-coded badges - Each filter type has a unique icon
• Removable - Click the ✕ on any badge to clear that filter
• Condensed display - Long extension lists show "3 more"
• Clear All button - Remove all filters with one click

Badge Examples:

🔍 Search: "report" ✕
📄 Extensions: .pdf, .xlsx ✕
📏 Size: 1-10 MB ✕
📅 Date: Last 7 Days ✕
[Clear All Filters]

Filter Statistics

When filters are active, a statistics bar shows aggregate information about filtered results.

Displayed Stats:

• Showing: Number of filtered items vs total (e.g., "23 of 156 items")
• Total Size: Combined size of filtered files (e.g., "45.2 MB")
• Date Range: Upload date span of filtered files (e.g., "Jan 15 - Oct 23, 2025")

Example:

📊 Showing 23 of 156 items | Total Size: 45.2 MB | Date Range: Jan 15 - Oct 23, 2025

Clear Filters

Multiple ways to clear filters:

1. Individual Clear - Click ✕ on filter badge
2. Filter Dropdown Clear - Click Clear link in dropdown header
3. Clear All Filters - Click red button to reset all filters
4. Text Search Clear - Click ✕ in search input

---

Combining Filters

The real power comes from combining multiple filter types for precise results.

Example Scenarios

Scenario 1: Find Recent Large Videos

Goal: Find video files larger than 100MB uploaded in the last 30 days

Steps:

1. Click Extensions → Click "🎬 Videos" quick filter
2. Click Size → Select "> 100 MB"
3. Click Date → Select "Last 30 Days"
4. View filtered results with statistics

Result: All video files over 100MB uploaded in the past month

---

Scenario 2: Locate Specific Document Types

Goal: Find Word and PDF documents under 5MB from Q1 2024

Steps:

1. Click Extensions → Check .pdf and .docx
2. Click Size → Custom: Min 0, Max 5
3. Click Date → Custom: From 2024-01-01, To 2024-03-31
4. Review filtered list

Result: PDF and Word documents under 5MB from January-March 2024

---

Scenario 3: Clean Up Old Large Files

Goal: Find files larger than 50MB uploaded before 2024

Steps:

1. Click Size → Select "> 50 MB"
2. Click Date → Custom: From empty, To 2023-12-31
3. Select files from results
4. Use bulk delete if needed

Result: All large files from 2023 or earlier, ready for cleanup

---

Best Practices

Performance Optimization

1. Start Broad, Narrow Down - Begin with one filter, then add more
2. Use Quick Filters - Faster than checking individual extensions
3. Combine Strategically - Use most selective filter first
4. Clear Unused Filters - Reset filters when switching tasks

Workflow Tips

1. Save Filter Combinations - Remember common filter patterns for regular tasks
2. Check Statistics - Review filtered totals before bulk operations
3. Use Type Filter - Combine with advanced filters for files-only view
4. Verify Results - Always check filtered count before bulk operations

Common Patterns

Weekly Review:

Date: Last 7 Days → Review recent uploads

Storage Cleanup:

Size: > 50 MB + Date: > 90 Days → Find old large files

Project Files:

Extensions: Code (quick filter) → Find all code files

Media Management:

Extensions: Images or Videos + Size: Custom range → Organize media

---

Keyboard Navigation

All filter components support full keyboard navigation:

• Tab - Move between filters
• Enter/Space - Open dropdown, select option
• Arrow Keys - Navigate dropdown options
• Escape - Close dropdown

Fully accessible for screen readers with ARIA labels and live regions.

---

Mobile Experience

Filters are fully responsive on mobile devices:

• Vertical Layout - Dropdowns stack on small screens
• Touch-Friendly - Large tap targets for buttons and checkboxes
• Swipeable Badges - Easy removal on touch devices
• Optimized Menus - Full-screen dropdowns on mobile

---

Troubleshooting

Filters Not Working

Issue: Filters don't seem to apply Solution:

• Ensure you've selected values in dropdown (presets or checkboxes)
• Check if filter badges appear below filter bar
• Try refreshing the bucket view

No Results Shown

Issue: Filter returns zero results Solution:

• Filters may be too restrictive (no files match all criteria)
• Clear individual filters to see which one eliminates results
• Try broader ranges (size, date) or fewer extensions
• Use filter statistics to verify file counts

Wrong Extension Count

Issue: Extension count doesn't match expectations Solution:

• Count shows files in current folder only (not recursive)
• Hidden/system files may not be counted
• Navigate to root to see bucket-wide extensions

Date Filter Confusion

Issue: Custom date range seems incorrect Solution:

• Dates are based on upload time, not file modification time
• Time zone differences may affect "today" cutoff
• Ensure end date is after start date

---

API Integration

Filters are purely client-side for performance:

• No API calls - All filtering happens in browser
• Works Offline - Filters function without network
• Fast Performance - Instant results even with 1000+ files
• Memory Efficient - Uses React memoization for optimization

---

Related Documentation

• File Operations - File management features
• Bucket Management - Bucket-level operations
• Quick Start Guide - Getting started
• Troubleshooting - Common issues and solutions

---

Future Enhancements

Planned improvements for filtering system:

• Saved Filter Presets - Save and recall common filter combinations
• Advanced Search Operators - Boolean logic (AND, OR, NOT)
• Regex Support - Pattern matching in text search
• Folder Recursive Filters - Include subfolders in extension detection
• Filter History - Recently used filters quick access

See the Roadmap for more planned features.

---

Need help? See the FAQ or ask in GitHub Discussions.