Gmail’s signature settings don’t include a raw HTML code field, so pasting HTML source directly won’t work. The method that does work: open your HTML signature in a browser so it displays as a formatted signature, copy that rendered version, and paste it into Gmail’s signature editor as rich text.
What You Need Before You Start
- Your HTML signature file, ready to open in a browser
- Any images in the signature hosted online with absolute URLs
- A Gmail account accessed through a desktop browser (not the mobile app, which handles signatures differently)
- A few minutes to check formatting after pasting
How to Add an HTML Signature in Gmail
- Open your HTML signature file in a browser so it renders as a formatted signature, not code.
- Select the entire rendered signature and copy it.
- Open Gmail and click the gear icon (Settings), then See all settings.
- Stay on the General tab and scroll down to the Signature section.
- Click Create new, name the signature, and click into the empty signature box.
- Paste the copied signature.
- Under signature defaults, choose whether it applies to new emails, replies and forwards, or both.
- Scroll down and click Save Changes.
Why You Can’t Just Paste Raw HTML Code
Gmail’s signature editor is a WYSIWYG rich-text box, the same kind of editor used for composing emails, not a code editor. If you paste raw HTML source into it, Gmail treats the angle brackets and tags as literal text rather than instructions, so you’ll see the actual code sitting in your signature instead of a formatted result.
Rendering the HTML in a browser first sidesteps this entirely. Once the browser has interpreted the code into a visual signature, copying and pasting carries over the formatting as rich text, which is what Gmail’s editor is built to handle.
Gmail Mobile Signatures Work Differently
The Gmail Android and iOS apps only support plain text signatures. HTML formatting, images, and clickable design elements set up on desktop won’t carry over to the mobile app signature, which is a separate setting entirely (found under the app’s own Settings → your account → Mobile Signature). If you want a consistent signature across desktop and mobile, expect the mobile version to be a simplified, text-only fallback rather than a match.
Troubleshooting HTML Signatures in Gmail
Signature shows as raw code instead of formatting
This means HTML source was pasted directly rather than a rendered version. Go back to the browser, confirm the signature displays as a formatted design (not code), copy it again, and paste fresh into the Signature box.
Images aren’t showing
Confirm every image is hosted online with a working absolute URL, not a local file or relative path. Gmail can’t display an image it can’t reach over the web.
Formatting looks different after pasting
Gmail can strip some CSS on paste, particularly background images, custom fonts, and precise spacing. Rebuilding the layout with HTML tables and inline styles rather than external or head-based CSS tends to survive the paste process more reliably.
Signature doesn’t appear on the mobile app
This isn’t a fault. Gmail’s mobile app uses a separate plain-text-only signature setting, so your HTML signature from desktop was never going to carry over. Set a simplified text version under the app’s own signature setting if you want something on mobile.
FAQs
Can I edit the HTML of my Gmail signature directly, once it's set up?
Not through Gmail’s own settings. Any changes need to go back through the render-and-paste process: edit the source HTML, re-render it in a browser, and re-paste the updated version.
Why does my signature look right in Gmail but broken when someone replies to me in Outlook?
Different email clients render HTML differently. Gmail is comparatively forgiving; Outlook’s Word-based rendering engine is stricter. Table-based layouts with inline styling hold up best across both.
Can I set different signatures for different Gmail accounts?
Yes, if you manage multiple Gmail accounts, each has its own independent Signature section under Settings, so they need to be set up separately.
Does Gmail support animated GIFs in signatures?
Yes, Gmail displays animated GIFs in signatures, though not every email client your recipients use will render the animation. Confirm the image still makes sense as a static frame for clients that don’t support it.
If your team needs consistent, branded HTML signatures across Gmail, Outlook, and mobile without everyone doing this manually, get in touch and we’ll set it up properly once.
Does an admin-managed Workspace signature override my personal one?
Yes. If your Google Workspace admin has set an organisation-wide signature through the Admin console, it takes priority over anything configured in your individual Gmail settings. Check with your admin if a personal signature you’ve set up isn’t appearing as expected.
If You’re on Google Workspace
If you’re on a Google Workspace account rather than a personal Gmail account, check with your admin before spending time on this. Workspace admins can push a signature to everyone in an organisation through the Admin console, and an admin-managed signature will override whatever you set individually in your own settings. It’s worth confirming which situation you’re in first, since building a personal signature only to have it overridden is a common source of confusion on managed accounts.
