Gmail Annotation Builder
Generate the JSON-LD or microdata code Gmail needs to show your deal badge, promo code, and product carousel in the Promotions tab — with a live inbox preview and inline validation.
Allowlist Required
Gmail only renders annotations from manually approved senders. To apply, email p-Promo-Outreach@google.com with your sending domains and a landing page URL. Approval takes 7–10+ business days and is not guaranteed.
Deal Annotation (Optional)
Short badge text shown next to the subject line in Gmail. Keep under 60 chars.
Displayed as a code chip in the inbox preview.
Auto-converts to ISO 8601 with your timezone.
Powers the "Expires in X days" countdown in Gmail.
Required for Deal Card action buttons in Gmail.
Brand Logo (Optional)
Shown beside your sender name. PNG recommended, HTTPS required.
Product Carousel (Optional)
All carousel images must use the same aspect ratio (4:5, 1:1, or 1.91:1). Google requires at least 2 items for a carousel.
Inbox Simulation
Estimate only — actual rendering varies by Gmail version and frequency caps.
Fill in at least one field to generate code.Gmail Annotations: Common Questions
Why do annotations only show in the Promotions tab?
Gmail designed annotations specifically to enhance the Promotions tab experience. They won't render in Primary, Social, or Updates tabs, and not in Outlook, Apple Mail, or other clients.
Do I need re-approval for each campaign?
No. Approval is per sending domain, not per campaign. Once approved, all campaigns from that domain can use annotations. Subdomains require separate approval.
Why aren't my annotations showing even with valid code?
Three common reasons: (1) your domain isn't allowlisted, (2) Gmail's quality filters are suppressing them for low engagement history, or (3) your ESP is stripping <script> tags — switch to Microdata format.
What image specs does Gmail require?
PNG or JPEG only (no WebP, GIF). HTTPS required. Minimum 256×256px. All carousel images must use the same aspect ratio: 4:5, 1:1, or 1.91:1. Avoid text overlays — quality filters penalize them.
Why We Built This Tool
Gmail Promotions tab annotations (deal badges, product carousels, promo codes) require JSON-LD schema markup that Gmail's parser understands — but you need allowlisting and exact schema compliance. Manual JSON-LD construction is error-prone. This tool generates validated code that Gmail accepts and renders.
What Goes Wrong Without This
Annotations require Gmail allowlisting (7-10+ days, not guaranteed), exact image specs (256×256px+, HTTPS, specific aspect ratios), and carousel requirements (minimum 2 items, same aspect ratio). Misconfiguration silently fails — Gmail rejects your markup without explanation, and you never know why.
Who This Tool Is For
E-commerce & DTC Brands
Generate deal badges and product carousels for promotional campaigns. Annotations boost engagement in Gmail's Promotions tab by 30-50% when properly configured.
Email Marketing Agencies
Build allowlist-approved annotation code for client campaigns. Once domain is allowlisted, all campaigns from that domain can use annotations.
B2B SaaS & Outbound Teams
Enhance visibility of time-limited offers and product launches. Annotations only render in Promotions tab, so they complement cold email in Primary inbox.
Frequently Asked Questions
Do I need allowlisting to use Gmail annotations?
Why aren't my annotations showing in Gmail?
What image formats and sizes does Gmail require?
Do I need an InboxEagle account to use this tool?
Annotations Get You Into the Inbox — InboxEagle Keeps You There
Gmail annotations boost visibility in the Promotions tab, but only if your email reaches Gmail in the first place. InboxEagle monitors your sender reputation, SPF/DKIM/DMARC health, and blacklist status 24/7 — so deliverability issues never silently kill your campaigns.
Start Free 14-Day TrialNo credit card required · Cancel anytime