Gmail Promotions annotations for Marketing Cloud

Gmail Annotation Generator

Fill in your offer and product images. You get annotation markup that survives Content Builder, a version for Google’s preview tool, a live check against Google’s rules, and the allowlist request that got our own domains approved — so the deal badge and carousel actually show in the Promotions tab.

Start here — the allowlist is the long pole

Nothing renders until Google allowlists your sending domain. There is no form: you email their Promotions team. Ours took 8 working days. Hover or tap any step for the detail.

1 · Build the markup and send once half a day 2 · Request the allowlist ~8 working days 3 · Send to 100+ personal Gmail per campaign

Needs your own authenticated sending domain. Google won’t allowlist a shared Marketing Cloud domain.i

Phase 1Build the markup— send it once for real

Deal

4 words or fewer, and a real offer: “20% off”, “Free shipping”.
Only if the code also appears in the email. Gmail shows it as “Code SAVE20”.
The countdown only appears two days before expiry.i

Product images

0 of 10
No images yet. Add one for a single image preview, or two to ten for a product carousel.
256–4096 px, HTTPS, one shared aspect ratio.i

Brand and preview details

Logo goes in the markup. Sender and subject are only for the preview.
Rarely rendered now — include it anyway.i

Promotions tab preview

approximate

Markup checks

against Google’s spec

    Image check

    Loads each image to check its size (256 to 4096 px) and aspect ratio. Carousels need 4:5, 1:1 or 1.91:1, the same for every card. A single image must be 1.91:1.

      Your code

      
    
        
    
        Can’t edit the email head? Google also accepts Microdata in the body.i
        
  
        

  
        Phase 2Get allowlisted by Google— one time · the only multi-day wait
        

  
  
        
    
        Get allowlisted by Google
        one time, before your first annotated send
        
    
        
      
        No form — you email Google’s Promotions team your sending details plus one real sent email that already carries the markup. This builds that email for you.i
        
      
        
        
        
        
        
        
        
      
        
      
        
        
        Annotations only show for mail from this exact allowlisted domain.
        
        
        
      
        
      
        
        
        
        
        
        
        
      
        
      
        The offer and image links from your annotation above are added automatically.
        
      Authentication on the sending domain
      
        
        
        
        
      
        
      Annotation types you’ll use (filled in from your annotation above)
      
        
      
          
      
          To: [email protected]. Attach or forward one real sent email that contains the markup.
        Open in email
          
      
          
    
          
  
          

  
          Phase 3Send day— nine conditions, none of them checked by SFMC
          

  
  
          
    
          Send-day checklist: the 9 conditions
          0 of 9 ready
          
    
          
      
          
      
          
      
          Gmail still applies its own quality filters, so valid markup is necessary but not sufficient.
          

      
          
        
          
          Take this with you
          3-page PDF · fill-in request template, printable checklist, the caveats that bite.
        
          
        
          
          
          
          
          
        
          
        
          
          
          Download the PDF
        
          
      
          
    
          
  
          

  
          
    Want it set up end to end?
    
          Genetrix handles the sending domain, Google allowlisting, the markup and the qualifying send in Marketing Cloud. genetrix.tech
          
  
          
  
          Markup follows Google’s Promotions annotation reference (PromotionCard, DiscountOffer, Organization). Everything runs in your browser. Nothing you type is sent anywhere, and the image check only loads the image URLs you enter.