Attachment Hero User Guide & Usage Quotas

πŸ“– Version 1.0 β€’ πŸ•’ Updated for Manifest V3 β€’ πŸ”’ 100% Client-Side Architecture

1. Getting Started

Welcome to the official Attachment Hero User Guide. Attachment Hero is a lightweight, privacy-first Google Chrome extension designed to streamline email thread tracking, historical attachment discovery, and 1-click organized packaging in Gmail.

πŸ”’ Client-Side Guarantee: Attachment Hero operates 100% in your local Chrome browser session. Your emails, attachments, and contacts never route through external servers.

Installation & Authorization

  1. Install Attachment Hero from the official Chrome Web Store (or via "Load Unpacked" during beta testing).
  2. Open mail.google.com in your Chrome browser.
  3. Look for the Hero Shield icon in your Gmail toolbar (located in the top-right header and inside individual conversation toolbars).
  4. On first use, click the shield. A Google OAuth prompt will request read-only permissions for Gmail. Review and authorize your account.

2. Attachment Hub Sidebar

When you send a group email requesting files, keeping track of who replied and who hasn't can quickly become overwhelming. Attachment Hero eliminates this mental friction with the Attachment Hub.

How to Monitor a Thread

  1. Open any conversation thread in Gmail.
  2. In the top toolbar (adjacent to the email subject line), click the Hero Shield icon labeled "Add to Attachment Hub".
  3. The Attachment Hub sidebar will expand on the right side of Gmail showing monitored conversations and participant status.
What the Sidebar Shows:
  • βœ… Responded: Lists all participants who have replied to your email, along with the number of emails and total attachments they contributed.
  • ⏳ Waiting: Lists participants who have not yet replied, making it impossible to overlook missing files.
  • πŸ”„ Dynamic Participant Sync: If new people are Cc'd or added to the thread later, simply click the Refresh (πŸ”„) button to automatically sync them into your dashboard.

3. Structured ZIP Exports & Organization Modes

Instead of manually clicking "Download" on every single attachment across dozens of replies, Attachment Hero packages everything into a structured ZIP archive in seconds.

Exporting Attachments

  1. Open the Attachment Hub sidebar on your desired thread.
  2. Click the blue "Download All Attachments" button.
  3. Optional Original Attachments: If you originally sent files in your initiating email (such as a template, form, or project brief), check [βœ“] Include sender's original attachments to bundle them too.

Multiple Archive Organization Structures

Attachment Hero allows files in the exported ZIP archive to be structured in multiple ways to match your operational workflow:

  • Organized by Sender's Email / Name (Default): Creates a clean subfolder for each participant who contributed files.
    Project_Discussion/
    β”œβ”€β”€ [Original Sender] initiator@company.com/
    β”œβ”€β”€ john.smith@client.com/
    └── jason.doe@partner.org/
  • Organized by Company Domain: Automatically groups senders by their email domainβ€”perfect for transactions with multiple law firms, escrow officers, and lenders.
    Deal_Export/
    β”œβ”€β”€ firstrealty.com/
    β”œβ”€β”€ pacificescrow.org/
    └── primeinspections.com/
  • Organized by Email Subject / Project: Groups files into folders matching the conversation thread subject.
    Archive/
    └── Purchase_Contract_104_Main_St/

4. Direct-to-Draft Attaching (Skip the Download-Upload Dance)

One of Attachment Hero's most powerful capabilities is allowing you to search past attachments and directly attach them into an email you are currently drafting, without saving them to your computer first.

How to Attach Past Files Directly into a Draft:

  1. Open a new or existing Compose window in Gmail.
  2. Click the Attachment Hero Shield icon in the compose formatting toolbar (adjacent to the formatting 'A' and paperclip icon).
  3. A responsive discovery modal window appears.
  4. Search by file name or contact, or switch between the Inbox and Sent tabs.
  5. Select the checkbox next to each file you wish to attach (you can select multiple files at once).
  6. Click "Attach Selected". Attachment Hero automatically streams the binary files directly into your Gmail draft attachments area.
πŸ’‘ Why this matters: You avoid downloading 50 MB of temporary files to your computer's Downloads/ folder, finding where they landed, and manually dragging them back into Gmail. Everything happens seamlessly inside the browser memory.

5. Standalone Search & Discovery Modal

When you need to export past files or find historical documents across months or years of emails:

  1. Click the Attachment Hero shield in the top-right Gmail header and select "Search & Export Files".
  2. The master discovery window will display recent attachments with real-time debounced search.
  3. Filter results by Inbox vs. Sent mail.
  4. Easily spot file formats with visual character badges: PDF, XLS, DOC, IMG.
  5. Custom ZIP Filename: Type your preferred archive name (e.g. Taxes_2026.zip) directly into the bottom filename field.
  6. Click "Export Selected as Zip" to generate and save your customized package in one click.

6. Deduplication & Signature Noise Filtering

Email threads are notoriously cluttered with redundant file copies and signature icons. Attachment Hero includes two native filters to keep your local drive clean:

Zero-Duplicate Engine (SHA-256)

When recipients quote previous emails or re-attach the same file across multiple replies, Attachment Hero computes a cryptographic SHA-256 hash of each file stream in memory. If an identical file is detected, it is preserved only once, saving disk space and avoiding confusion.

Signature Noise Filter

Modern email signatures often contain tiny company logos, LinkedIn badges, Twitter icons, and 1x1 tracking pixels. Attachment Hero automatically analyzes attachment dimensions and file metadata, skipping images smaller than 5 KB so your downloaded ZIP contains only legitimate work documents.

7. Sending Automated Bulk Follow-ups

Don't waste time typing individual reminder emails to everyone who hasn't sent their files.

  1. In the Attachment Hub detail view, navigate to the ⏳ Waiting section.
  2. Click the Waiting β–Ύ options dropdown.
  3. Select "Send follow-up email".
  4. Attachment Hero instantly launches a standard Gmail compose window with the To: field pre-populated strictly with participants who haven't replied.

8. Google Account Types & Daily Quota Limits

Because Attachment Hero operates client-side through Google's official Gmail REST API, it operates within Google's cloud bandwidth and quota policies.

⚠️ Important Notice Regarding Google Quota Limits:
Google enforces download and bandwidth thresholds across all Gmail accounts to ensure system stability. These Google account limits apply to both Free and Pro Attachment Hero license holders. Purchasing an Attachment Hero Pro license lifts tracking and download limits inside the extension, but does not modify Google's cloud server thresholds. Google sets and adjusts these quotas independently at any time without notice; please consult official Google Gmail documentation for the most up-to-date account figures.

Google Web Client Download Limits

Google Channel Estimated Daily Download Threshold* Estimated Hourly Threshold* Typical Real-World Capacity
Gmail Web Client (Browser) ~1,250 MB (1.25 GB) / day ~750 MB / hour ~50–100 typical project ZIP packages / day

* Threshold figures are estimated based on published Google Gmail documentation and are subject to change by Google LLC at any time without notice. Consult official Google Workspace and Gmail administrator guides for current policies.

What happens if you reach Google's daily download limit?

If you reach Google's daily threshold, Attachment Hero ZIP downloads and Direct-to-Draft attaching will temporarily pause until your Google account quota refreshes.

  • Automatic Recovery: You simply need to wait for Google's system to reset your allowance. Because these quotas are enforced directly by Google's infrastructure, no browser extension can manually override or expedite the reset.
  • Your Account Is 100% Safe: Your Google account is never penalized or locked. Day-to-day Gmail operations—such as reading, sending, and receiving messages—continue completely uninterrupted.

9. Troubleshooting & FAQ

Why did an attachment download pause?

When downloading multiple attachments in quick succession, Attachment Hero automatically paces requests to avoid triggering Google's temporary rate limits. Simply wait a moment for the download to finish, or click "Check for updates".

Multi-Account Switching

Attachment Hero supports multiple Google accounts (e.g. personal and work) in the same browser profile. Each account manages isolated OAuth tokens securely through Chrome's native chrome.identity framework.