Gmail Signature Template Guide: Setup, Tips & Common Fixes (2026)
Gmail is where most people expect their email signature to “just work.” It often does — but there are enough quirks (CSS stripping, dark mode behavior, the mobile/desktop split) that knowing them in advance saves a lot of frustration. This guide covers everything from setting up a Gmail signature from scratch to making HTML templates paste in correctly.
By the NeatStamp Team · Updated March 2026 · 15 min read
Gmail signature basics
Gmail’s signature feature has been around for years but has been significantly improved. As of 2026, you can:
- Create multiple named signatures per account
- Assign different signatures to different email aliases
- Set a separate signature for new emails and for replies/forwards
- Paste formatted HTML signatures (with logos, colors, and links)
- Insert images from Google Drive or by URL
What Gmail’s signature editor does NOT support:
- CSS class-based styling (it strips class attributes)
- External stylesheets (<link> tags or @import)
- <style> blocks (Gmail removes these in rendering)
- Custom web fonts loaded via Google Fonts or similar
- SVG images
This is why professionally-designed signatures often look worse in Gmail than they do in a browser preview. The solution is to build specifically for Gmail’s constraints — which is exactly what Gmail-optimized signature tools do.
Step-by-step Gmail signature setup (desktop)
This covers Gmail in a web browser (Chrome, Firefox, Safari, Edge). The interface is the same across all desktop browsers.
- 1
Open Gmail Settings
Click the gear icon in the top-right corner of Gmail. In the dropdown that appears, click 'See all settings.' This opens the full settings page.
- 2
Navigate to Signatures
You're on the General tab by default. Scroll down until you see the Signature section — it's about halfway down the page.
- 3
Create a new signature
Click '+ Create new.' A dialog appears asking you to name your signature. Give it a descriptive name — 'Full Signature' or your name. Click Create.
- 4
Add your signature content
The signature editor is a rich text box. You can type directly for a basic text signature. For a formatted HTML signature with a logo and colors, see the section on pasting HTML below.
- 5
Set signature defaults
Scroll up slightly to the 'Signature defaults' area. Select your email address from the dropdown and choose your signature for 'For New Emails Use' and optionally 'On Reply/Forward Use.' A shorter, simpler signature for replies is good practice.
- 6
Save Changes
Scroll to the bottom of the Settings page and click 'Save Changes.' Gmail saves the whole page at once — if you close without saving, your signature is gone.
- 7
Test it
Click Compose. Your signature should appear automatically in the email body. Send a test email to yourself and check how it renders. Also send to a colleague on Outlook if you have one — cross-client testing is important.
Remember: Save Changes at the bottom of the page
Gmail’s Settings page saves all changes at once when you click the Save Changes button at the very bottom. Navigating away from the page without saving loses all your edits. This catches people out more than almost any other Gmail gotcha.
Why Gmail strips your formatting (and how to work around it)
Here’s what’s actually happening when Gmail removes your carefully crafted styles: Gmail’s rendering pipeline sanitizes incoming HTML to prevent CSS class collisions with its own interface and to block potential security vectors. It removes:
Gmail removes:
<style> blocksWhy: Gmail wraps all email content in its own CSS. External style blocks would interfere with that wrapper.
Fix: Use inline styles on every element. style="color: #333; font-size: 14px;" on each tag.
Gmail removes:
class attributesWhy: Gmail removes class names from all HTML elements. Any styling tied to classes simply disappears.
Fix: Never rely on CSS classes for email signatures. Every style must be inline.
Gmail removes:
Google Fonts and custom webfontsWhy: Gmail blocks external stylesheet loading, including Google Fonts @import statements.
Fix: Use web-safe fonts: Arial, Georgia, Verdana, Trebuchet MS, Tahoma. Optionally declare your preferred font first with a web-safe fallback.
Gmail removes:
SVG imagesWhy: SVG can contain executable JavaScript. Gmail blocks all SVG for security.
Fix: Export all icons and logos as PNG. Use 2x dimensions for retina (display at half the actual size using width/height attributes).
Other Gmail rendering behaviors to know
- Line breaks: Gmail compresses multiple empty lines. If you want vertical spacing, use explicit padding or margin on elements, or use a table cell with a fixed height for spacing.
- Image blocking: Gmail on desktop shows all externally hosted images by default (unlike Outlook). On mobile Gmail, behavior can vary by account settings. Always include descriptive alt text.
- Link colors: Gmail overrides link colors to its default blue in some views. Use !important on link colors or set the color directly on the <a> tag with an explicit inline style.
- Quote collapsing: In reply threads, Gmail hides repeated signature content under a '...' expander. This is normal. Recipients can see it by clicking the expander.
How to paste an HTML signature into Gmail
This is the most common question about Gmail signatures, and there’s a lot of confusion about it. Here’s the clearest explanation.
The right method: paste the rendered version
Gmail’s signature editor accepts formatted HTML — but not raw HTML source code. If you paste <p style="color:red">Hello</p> directly, it shows up as literal text, not as rendered HTML.
What you need to paste is the rendered output — the visual result of the HTML, not the source code. When you copy from a tool like NeatStamp, the copy button copies the rendered version to your clipboard. Your clipboard contains formatted, styled content, not angle brackets.
Then when you paste into Gmail’s signature editor, Gmail receives that rendered content and converts it to its own internal representation. The formatting, images, and links all carry over.
Step by step
- 1.Build your signature in the NeatStamp editor.
- 2.Click 'Copy Signature' — this copies the rendered version.
- 3.Go to Gmail Settings → Signature → Create new.
- 4.Click inside the signature editor box.
- 5.Paste (Ctrl+V on Windows, Cmd+V on Mac).
- 6.You should see your formatted signature appear with correct styling.
- 7.Scroll down and click Save Changes.
The wrong method: pasting raw HTML source
If you copy the raw HTML source code from a text editor and paste it into Gmail’s signature box, you get a wall of <table><tr><td> appearing as literal text. This is the most common mistake.
Some advanced users need the raw HTML for specific customization. In that case, the workaround is:
- 1.Open a blank HTML file in your browser (create a file called sig.html and open it with your browser).
- 2.Paste the HTML source into that file.
- 3.View it in the browser — you see the rendered result.
- 4.Select all (Ctrl+A) and copy.
- 5.Paste that into Gmail's signature editor.
This is more work than using a tool that handles it for you. For most people, the NeatStamp editor copy button is the right approach.
Multiple signatures and email aliases
Gmail allows you to create multiple signatures and assign them differently based on context. This is one of its most useful features and one of the least-known.
Full signature vs. reply signature
Create two signatures:
Full signature (new emails)
Your name, title, company, phone, email, logo, LinkedIn. Everything a new contact needs to know who you are and how to reach you.
Reply signature (replies & forwards)
Name, title, phone. 2–3 lines maximum. The person already knows your email. A short signature keeps long threads readable.
In Gmail Settings → Signature, set “For New Emails Use” to your full signature and “On Reply/Forward Use” to your short signature. Done.
Multiple email addresses / aliases
If you have multiple email addresses (addresses added in Gmail Settings → Accounts and Import → Send mail as), you can assign a different signature to each one.
In the Signature defaults section, there’s a dropdown to select “For emails sent from [address].” Create the appropriate signature for each address and assign it here. When you compose from that address, Gmail automatically inserts the right signature.
Useful scenarios: a work Gmail account (@company.com added as an alias) uses a corporate signature with a logo; a personal Gmail uses a minimal personal signature. Or a sales alias (sales@) uses a signature with a booking link; a support alias (support@) uses a signature with your support hours.
Gmail mobile: the separate signature problem
This is one of the most frustrating Gmail signature limitations: your desktop signature and your mobile signature are completely independent. Setting one does not affect the other.
How to set your Gmail mobile signature
- 1
Open the Gmail app on your phone
This works the same on iOS and Android.
- 2
Tap your profile picture
It's in the top-right corner. This opens a small account menu.
- 3
Tap 'Manage your Google Account'
This opens your Google Account settings.
- 4
Go back to the Gmail app menu
Tap the three horizontal lines (hamburger menu) at the top left of Gmail.
- 5
Tap Settings
Scroll to the bottom of the left-side menu.
- 6
Select your account
If you have multiple Gmail accounts, tap the one you want to set a signature for.
- 7
Tap 'Mobile Signature'
This is separate from the regular Signature setting. Type your mobile signature here. Plain text only — no HTML formatting available in the mobile app.
Gmail mobile only supports plain text
The Gmail mobile app doesn’t support HTML signatures natively. You get a plain text field. The practical approach is to set a minimal plain text signature on mobile (name, title, phone) and reserve your full HTML signature for emails sent from desktop. Most important professional emails are sent from desktop anyway.
How your desktop signature looks on your recipients’ phones
There’s an important distinction here: your mobile signature (the one you send from your phone) vs. how your signature looks when a recipient reads it on their phone.
For your signature to look good on recipients’ phones, it needs to be built for mobile rendering: max-width 600px, minimum 11px text, explicit image dimensions, tappable phone links. The mobile-friendly signature guide has all the specifics. NeatStamp’s templates are built to these standards automatically.
Dark mode in Gmail
Dark mode behavior in Gmail varies significantly by platform. Here’s what actually happens:
Gmail on desktop (web)
Gmail desktop applies dark mode to its interface but generally leaves email content (including signatures) in light mode. Your signature should look normal for most desktop Gmail users.
Gmail on Android
Gmail on Android applies a dark background but attempts to preserve inline-styled colors. If your signature elements don't have explicit background-color declarations, Android Gmail may apply dark styling inconsistently — making light text hard to read or inverting colors unexpectedly.
Gmail on iOS
Similar to Android. iOS Gmail in dark mode preserves content colors more reliably than Android but can still show issues with transparent backgrounds.
How to make your Gmail signature dark-mode-safe
- Declare explicit background-color on your outer table: Add background-color: #ffffff to your outer <table> element. This tells Gmail (and other clients) that this area is explicitly white, so they don't apply their dark background to it.
- Use #333333 for text, not #000000: Pure black (#000000) can cause color inversion issues in some dark mode implementations. #333333 is dark enough to be readable on light backgrounds but handles dark mode more gracefully.
- Declare colors on every element, not just the container: If only your outer table has a color declaration but inner cells don't, dark mode can apply differently to nested elements. Set color explicitly on each <td> that contains text.
- Test on Android Gmail in dark mode: This is the most aggressive dark mode implementation. If your signature survives Gmail on Android in dark mode, it will be fine everywhere else.
For a thorough treatment of this, the dark mode email signature guide covers every major email client’s behavior with code examples.
Common Gmail signature issues — fixed
Signature not appearing in new emails
Cause: The signature isn't set as the default for new emails.
Fix: Go to Gmail Settings → Signature → Signature defaults. Under 'For New Emails Use,' select your signature name from the dropdown. Save Changes.
Signature disappears in reply threads
Cause: This is expected Gmail behavior. Gmail hides repeated content in reply chains under the '...' expander. Your signature is there — the recipient can see it by clicking the expander.
Fix: No fix needed — this is correct behavior. If you want the signature visible in all replies, set a shorter reply signature that's less likely to be collapsed.
Logo appears broken / shows alt text
Cause: The image URL is not publicly accessible, uses http (not https), or the image has been moved or deleted.
Fix: Verify your image URL is publicly accessible by opening it in an incognito window. Use https. If you're on NeatStamp Pro, use the built-in CDN hosting.
Formatting looks different after saving
Cause: Gmail modifies the HTML when you save it — it normalizes inline styles and restructures some elements. This is normal. The result should still look correct.
Fix: Don't re-paste your signature after every minor tweak. Make all your changes first, paste once, then save. If the rendering is wrong, check that your source HTML uses only inline styles.
Links aren't clickable in the signature
Cause: Sometimes pasting stripped the href attributes from your links.
Fix: After pasting, verify your links work by right-clicking them in the editor and checking that 'Edit link' shows the correct URL. If links are broken, paste again from a fresh copy.
Extra blank lines appear above the signature
Cause: Gmail automatically adds a blank line above the signature when you compose. This is a Gmail UI behavior, not a problem with your signature.
Fix: This is expected. Recipients see your email content followed by the signature without excessive spacing. The blank line is a compose-view artifact.
Signature shows up on all replies even though I set a shorter one
Cause: The reply signature default wasn't saved, or it was set to 'No signature' accidentally.
Fix: Go back to Gmail Settings → Signature defaults. Verify the 'On Reply/Forward Use' dropdown shows your short reply signature. Save Changes again.
Signature not working on Gmail mobile
Cause: Desktop and mobile signatures are set separately. Setting the desktop signature doesn't affect mobile.
Fix: Set the mobile signature separately in the Gmail app: three lines → Settings → your account → Mobile Signature.
For Gmail-specific problems like your signature not working at all, the Gmail signature not working guide has a dedicated troubleshooting checklist.
Using a Gmail-optimized signature generator
The fastest and most reliable way to get a professional Gmail signature is to use a generator that’s built for Gmail’s specific constraints.
The NeatStamp editor is designed specifically for this. It generates HTML that:
- Uses only inline styles (no classes, no external CSS)
- Uses web-safe fonts with proper fallbacks
- Uses PNG images with explicit width/height attributes
- Includes explicit background-color declarations for dark mode safety
- References images at external URLs (not base64 embedded)
- Works in Gmail desktop, Gmail on Android, and Gmail on iOS
- Also works in Outlook, Apple Mail, and other clients
The workflow: open the editor, fill in your details, upload your logo, pick a template from the template library, click Copy, paste into Gmail. About 5 minutes total.
For design inspiration before you start, the email signature examples guide has 15+ real examples across industries. For the complete design framework, the best practices guide covers fonts, colors, sizing, and what to include.
Frequently asked questions
Why does my Gmail signature look different from what I designed?
Gmail strips CSS class names and external stylesheets. If your signature uses a <style> block or class-based CSS, Gmail removes it. Everything must be inline styles. Gmail also compresses whitespace, so use <br> tags for line breaks rather than empty paragraphs.
How do I add an HTML signature to Gmail?
Go to Gmail Settings → See all settings → General → Signature → Create new. The most reliable method is to build your signature in NeatStamp, click Copy, then paste directly into the Gmail signature editor box. The formatting transfers because you're pasting rendered HTML, not raw code.
Does my Gmail desktop signature appear on Gmail mobile too?
No. Gmail desktop and Gmail mobile maintain separate signature settings. You set the desktop signature in Gmail's web settings. The mobile signature is set inside the Gmail app: tap your profile picture → Manage your Google Account → Settings → your account → Mobile Signature.
Can I have different signatures for different email addresses in Gmail?
Yes. If you've added multiple accounts to Gmail (or multiple aliases), you can set a different signature for each one. In Gmail Settings → Signature, each signature can be assigned to a specific email address in the 'Signature defaults' section.
Why do images in my Gmail signature show as attachments?
Images that are embedded as base64 or attached inline often get treated as attachments by Gmail. Use externally hosted images with a public URL (https://yourwebsite.com/logo.png) instead. NeatStamp Pro hosts images on a CDN; on the free plan, upload your logo to your website and reference that URL.
How do I make my Gmail signature work in dark mode?
Gmail on Android applies dark mode by inverting colors when background-color isn't explicitly declared. Add background-color: #ffffff to your outer table and key cells to prevent this. Use #333333 for text rather than #000000, and declare all colors explicitly rather than relying on defaults.
Related guides
Build your Gmail signature now
NeatStamp generates Gmail-compatible signatures with inline styles, web-safe fonts, and proper dark mode support. Free, no account needed.