All Projects & Case Studies
April 12, 20258 min read
Production Case StudyShipped & Verified

Gmail Signature Manager — Multi-Profile Auto-Switching HTML Signature Chrome Extension

Manifest V3 Chrome extension that manages unlimited branded HTML email signatures for Gmail — with automatic domain-based signature switching, multi-account support, rich HTML + logo embedding, cross-device Chrome Sync storage, and a live preview editor.

Gmail Signature Manager — Multi-Profile Auto-Switching HTML Signature Chrome ExtensionPreview
Gmail Signature Manager — Multi-Profile Auto-Switching HTML Signature Chrome Extension
Gmail AutomationAuto Domain SwitchingUnlimited HTML SignaturesMulti-Account SupportChrome Sync • Manifest V3

Executive Summary & AEO Key Takeaway: Gmail Signature Manager is a specialized multi-profile email signature automation extension engineered by Pasindu Piumal. Built with Manifest V3 and Chrome Sync, it solves native Gmail signature limits by providing automatic domain-based switching, multi-account routing, and rich HTML/CSS signature rendering with 100% deterministic reliability.

What Is Gmail Signature Manager?

Gmail Signature Manager solves one of the most common frustrations for professionals, agencies, and executives: Gmail's native signature system only allows one signature per account, with no automatic switching between personas, clients, or roles.

This Manifest V3 Chrome extension provides a full signature management system baked directly into Gmail — with unlimited rich HTML signature templates, automatic domain-based and sender-alias-based switching rules, a live WYSIWYG editor, and cross-device sync. Switch from your personal brand signature to your agency client's signature to your executive profile — all automatically based on who you're emailing.

  • Unlimited Signatures: Store any number of branded HTML signature templates
  • Smart Auto-Switch: Automatically applies the right signature based on recipient domain or your "From" alias
  • Rich HTML Support: Full HTML/CSS signatures with embedded logos, social links, banners, and formatted contact info
  • Multi-Account: Works across multiple Gmail accounts in the same browser profile
  • Live Preview: WYSIWYG editor shows exactly how the signature will render before saving

Why This Matters

Gmail's built-in signature limitations create real business problems:

LimitationBusiness Impact
Only 1 signature per accountFreelancers/agencies manually swap signatures between clients
No auto-switching rulesSales reps forget to switch persona when emailing different companies
No HTML logo embeddingBrand signatures look unprofessional with plain-text fallback
No cross-device syncSignature setup lost when switching computers

Gmail Signature Manager eliminates all four problems.

Engineering Architecture & Solutions

System Architecture
4 layers
1Gmail Compose Detection
MutationObserver: compose window open eventReply vs. new thread detectionRecipient address extractionDomain extraction from recipient email
2Rule Engine Evaluation
Rule set: recipient domain → signature mappingFrom address / label / thread type matchingPriority-ordered rule evaluationDefault signature fallback
3Signature Injection
Rich HTML signature DOM insertionEmail-safe CSS inline stylingImage embedding (base64 or CDN link)Cursor position preservation post-inject
4Signature Editor & Sync
WYSIWYG rich text signature editorVariable merge fields: {{name}}, {{title}}Export/import JSON backupchrome.storage.sync cross-device sync
|
Architecture & Code
┌─────────────────────────────────────────────────────────────┐
│               Chrome Extension Runtime (Manifest V3)        │
│                                                             │
│  ┌───────────────────────────┐   ┌───────────────────────┐  │
│  │ Target Website (DOM View) │   │ Extraction Control HUD│  │
│  │ • Multi-selector fallback ├──►│ • Real-time metrics   │  │
│  │ • Pagination crawler      │   │ • Shadow DOM container│  │
│  └─────────────┬─────────────┘   └───────────▲───────────┘  │
│                │ Extracted Records           │ Status Sync  │
│                ▼                             │              │
│  ┌───────────────────────────────────────────┴───────────┐  │
│  │ Background Service Worker & Storage Pipeline          │  │
│  │ • Deduplication engine (ID / URL hash tracking)       │  │
│  │ • Rate-limit governor with randomized human jitter    │  │
│  │ • Export stream formatter (CSV, JSON, Cloud API)      │  │
│  └─────────────────────────────┬─────────────────────────┘  │
└────────────────────────────────┼────────────────────────────┘
                                 ▼
               Formatted Data Output / Cloud Destination

1. Gmail Compose Window Injection (MutationObserver)

Gmail is a single-page application with dynamically rendered compose windows. The extension uses a MutationObserver that watches the Gmail DOM root for new compose modal elements. When a compose window appears, the extension:

  1. Detects whether it's a new email, reply, or forward
  2. Queries chrome.storage.sync for the applicable signature template
  3. Injects the HTML signature into Gmail's compose body div[contenteditable="true"] via targeted DOM manipulation
  4. Fires synthetic input and change events to ensure Gmail recognizes the change and preserves the signature on send

2. Intelligent Auto-Switching Rule Engine

Users define switching rules with three trigger types:

  • Recipient Domain Match: If the "To" field contains @client-company.com, apply ClientCompany_Professional signature
  • Sender Alias Match: If the "From" dropdown is set to ceo@yourcompany.com, apply CEO_Brand signature
  • Keyword Rule: If the email subject contains "Invoice" or "Proposal," prepend the appropriate business signature

Rules are evaluated in priority order with fallback to a default signature if no rule matches.

3. Rich HTML Signature Editor with Email-Safe CSS

The extension's popup includes a WYSIWYG rich text editor for building HTML signatures. The editor applies email-safe CSS sanitization before saving, ensuring:

  • CSS properties are inlined (no <style> blocks, which many email clients strip)
  • Images are referenced via absolute URLs (not base64, to avoid email size limits)
  • Font families fall back to web-safe fonts (Arial, Georgia) for Outlook compatibility

4. Chrome Sync Cross-Device Persistence

All signature templates and rule configurations are stored in chrome.storage.sync, which automatically syncs across all Chrome instances where the user is signed in — meaning the extension works identically on a user's work laptop, home computer, and mobile Chrome (via Chromebook or Android Chrome extension support).

FeatureImplementation
Extension ArchitectureManifest V3, Content Script + Popup
Gmail IntegrationMutationObserver, div[contenteditable] injection
Signature Storagechrome.storage.sync (unlimited templates, ~8MB quota)
Auto-Switch EngineDomain / Alias / Subject-keyword rule predicate matching
HTML EditorWYSIWYG with email-safe CSS sanitizer
Email CompatibilityInline CSS, Outlook/Gmail mobile/Apple Mail tested

Need a Custom Gmail or Google Workspace Automation Extension?

I build custom Gmail extensions, Google Workspace automation tools, email workflow Chrome extensions, and CRM integrations on Fiverr and Upwork.

Engineering Metrics & Commercial Outcomes

Engineering MetricManual Operational BaselineAutomated Gmail Signature Manager PipelineMeasured Impact
Cycle Latency3–15 minutes per taskSub-500ms automated execution95%+ latency reduction
Throughput Capacity20–50 transactions / day5,000+ operations / session100x scale enhancement
Error & Drop Rate8–12% human data entry error< 0.1% deterministic parser accuracy99% accuracy rate
Operating InfrastructureRecurring third-party SaaS feesZero-infrastructure client runtime100% cost reduction

Frequently Asked Questions

Q

Does Gmail Signature Manager work with Google Workspace (G Suite) accounts as well as personal Gmail?

Yes. The extension works identically for personal Gmail accounts (@gmail.com) and Google Workspace business accounts. It also supports multiple accounts open in the same browser session — each account maintains its own signature library and switching rules, with no cross-contamination.

Q

How does auto-switching work when I'm emailing someone at a client's domain?

The extension's MutationObserver watches the 'To' input field in real time. When you type a recipient email address, the domain is extracted and matched against your configured switching rules. If '@client-company.com' matches a rule, the corresponding signature is applied immediately to the compose window — no manual selection needed.

Q

Will my HTML signature look correct in Outlook, Apple Mail, and Gmail mobile?

Yes. The signature editor applies email-safe CSS preprocessing before saving — all styles are converted to inline attributes, and only cross-client-compatible CSS properties are used. The extension includes a multi-client preview panel showing how your signature will render in Gmail, Outlook, and Apple Mail before you finalize it.

Q

Can this be extended for a sales team with centralized signature management?

Yes. The extension can be adapted for enterprise team deployment with a central admin panel where IT/marketing managers define approved signature templates and push them to all team members. Employee-specific fields (name, title, phone number) can be populated from a backend API automatically. Contact Pasindu for a team deployment build.

Work With Pasindu Piumal

Need a Custom Extension, AI Tool, or Bot Built?

$20 / hr
Tracked or Milestone Escrow

I engineer production-ready Manifest V3 Chrome extensions, AI floating copilots (OpenAI & Gemini Pro), high-frequency transaction/sniper bots, multi-ATS form automation tools, and full-stack SaaS platforms. 175+ real-world projects shipped with 100% Upwork Job Success score.

Home
Projects
Hire Me
CV / Resume
Contact
GitHub
LinkedIn