Summary
Gmail promotional tab annotations are a powerful feature for email marketers, enabling visual enhancements to campaigns directly within the inbox. These annotations are implemented using JSON-LD, a data format embedded in the email's HTML, and are explicitly designed not to use JavaScript. This is because email clients universally block JavaScript for security concerns, ensuring that all interactive or dynamic elements for annotations are pre-rendered from static JSON data. While some sources suggest no formal registration is required, official Google documentation and most marketers indicate that senders must register their email address or domain with Google through a one-time process, provided they meet specific sender reputation and volume criteria. Implementing these annotations enhances visibility and engagement, displaying key offer details like discounts and expiration dates without requiring the recipient to open the email, making them a strategic tool for modern email marketing.
Key findings
- JSON-LD Implementation: Gmail promotional tab annotations are exclusively implemented using JSON-LD markup, which is embedded directly within the HTML head of the email. This structured data allows for rich visual enhancements like logos, discounts, expiration dates, and product carousels.
- No JavaScript Support: These annotations do not rely on JavaScript for their functionality, and JavaScript is generally not supported or is blocked by email clients, including Gmail, due to security reasons. The annotations function purely as a static display driven by the JSON-LD data.
- Enhanced Engagement: While not strictly mandatory for the promotional tab itself, utilizing these annotations significantly improves email visibility and engagement. They allow key offer details to be displayed directly in the inbox, potentially increasing open rates and click-through rates by providing at-a-glance information.
Key considerations
- Sender Registration: For Gmail promotional tab annotations to display, senders often need to register or be whitelisted with Google through a one-time process. This typically involves meeting specific prerequisites such as maintaining a low spam rate, sending a significant volume of emails, and having valid SPF, DKIM, and DMARC setups for the sending domain.
- Deliverability Impact: Even with correctly implemented JSON-LD, annotations may not appear if the sender's domain has a poor reputation or if emails frequently land in the spam folder. Overall email deliverability and adherence to Google's sending guidelines are critical for the successful display of promotional annotations.
What email marketers say
11 marketer opinions
Implementing Gmail promotional tab annotations is a key strategy for enhancing email visibility and engagement. These visual enhancements are powered by JSON-LD, a static data format embedded within the HTML head of an email. Crucially, traditional JavaScript is not supported within emails due to widespread client security restrictions, meaning all annotation elements must be derived from this static JSON data. While there's some variation in understanding, the consensus is that senders must typically register their domain or be whitelisted with Google, a process contingent on maintaining a strong sender reputation, consistent email volume, and proper authentication protocols like SPF, DKIM, and DMARC. When correctly deployed and combined with good deliverability practices, these annotations allow marketers to showcase rich offer details directly in the inbox, driving higher click-through rates without requiring recipients to open the email.
Key opinions
- JSON-LD Foundation: Gmail promotional tab annotations are built exclusively on JSON-LD, a data format integrated into the email's HTML, enabling rich visual elements like logos, discounts, and expiration dates.
- No JavaScript Compatibility: JavaScript is unsupported and typically blocked by email clients, including Gmail, for security reasons; therefore, annotations rely entirely on static JSON-LD for their display.
- Enhanced Inbox Visibility: Utilizing these annotations significantly boosts email engagement by displaying crucial offer details directly in the Promotions tab, helping to capture recipient attention and potentially increase open and click-through rates.
Key considerations
- Google Registration or Whitelisting: For annotations to display, senders generally need to complete a one-time registration or whitelisting process with Google, which often depends on factors like sending volume, low spam rates, and proper email authentication.
- Sender Reputation and Deliverability: The successful rendering of annotations is highly dependent on a sender's overall reputation and adherence to deliverability best practices, as a poor sending history or frequent spam placements can prevent them from appearing.
Marketer view
Email marketer from Email Geeks explains that you can use JSON LD in emails, but not JavaScript. They clarify that JSON is a data format distinct from JavaScript, and JavaScript in emails typically breaks with many email clients because clients lag behind browser support for such features.
22 Jul 2021 - Email Geeks
Marketer view
Email marketer from Email Geeks responds that there is no registration requirement to enable annotations for the Gmail promotional tab, and refers to Google documentation for comprehensive details and testing tools.
1 May 2022 - Email Geeks
What the experts say
2 expert opinions
Gmail promotional tab annotations are implemented through the strategic placement of JSON-LD script blocks within the head of an email's HTML. Experts clarify that there is no formal registration or signup requirement for these annotations; they will automatically appear for senders whom Gmail recognizes as having sufficient email volume and a consistent sending history. Furthermore, because these annotations are driven by static JSON-LD data and not by executable code, JavaScript compatibility is not a relevant factor for their display or functionality within the promotional tab.
Key opinions
- JSON-LD Implementation: Gmail promotional tab annotations are exclusively implemented by embedding JSON-LD script blocks directly within the HTML header of an email, serving as the sole mechanism for conveying the necessary structured data.
- No Formal Registration: Crucially, the utilization of these annotations does not require any formal registration or signup process with Google; they appear automatically for senders recognized by Gmail as having sufficient email volume and a good sending reputation.
- JavaScript Not Required: The display functionality of these annotations relies entirely on static JSON-LD data and does not involve or require JavaScript execution. Therefore, JavaScript compatibility is not a concern for their successful display.
Key considerations
- Sender Recognition: The appearance of promotional tab annotations hinges on Gmail's internal recognition of the sender, which is primarily driven by consistent, sufficient email volume and sender reputation, rather than a formal registration process. Valid SPF, DKIM, and DMARC setups are still crucial for this recognition.
- Accurate JSON-LD: While no registration is needed, precise and valid JSON-LD implementation within the email's HTML head is paramount for the annotations to display correctly in the promotional tab. Any errors in the structured data can prevent them from appearing.
- Static Information: Marketers must remember that annotations are derived from static JSON-LD data. All desired visual elements and offer details, such as discounts and expiration dates, must be accurately embedded within this data as dynamic JavaScript is not supported.
Expert view
Expert from Spam Resource explains that Gmail promotional tab annotations are implemented using JSON-LD script blocks embedded within the head of the email's HTML. These annotations do not require any formal registration or signup; they will appear for senders recognized by Gmail with sufficient email volume. The implementation relies on JSON-LD data, not JavaScript code execution for the annotations themselves, thus JavaScript compatibility is not a direct concern for their display.
13 Oct 2021 - Spam Resource
Expert view
Expert from Word to the Wise shares that Gmail promotional tab annotations are achieved by placing JSON-LD code in the HTML header of the email. They confirm that there are no registration or signup requirements to utilize these annotations. Since the annotations are powered by JSON-LD data and not executable scripts, there are no specific JavaScript compatibility considerations for their functionality within the promotional tab.
23 Jan 2023 - Word to the Wise
What the documentation says
3 technical articles
Based on Google's official documentation, Gmail promotional tab annotations are exclusively powered by JSON-LD markup embedded directly in the email's HTML, confirming that JavaScript is neither used nor required for their functionality. A key aspect for senders is the mandatory, one-time registration of their sending email address with Google. This process is contingent upon meeting specific criteria, including maintaining a low spam rate, sending a significant volume of emails, and having a robust email authentication setup, such as SPF, DKIM, and DMARC. The underlying technical structure for these rich features, such as displaying discounts and coupon codes, is derived from the Promotion schema defined by Schema.org, providing a standardized way to convey promotional information via JSON-LD.
Key findings
- JSON-LD Markup Only: Gmail promotional tab annotations are exclusively implemented using JSON-LD markup embedded directly within the email's HTML, confirming that JavaScript is neither used nor required for their functionality.
- Schema.org Basis: The foundational technical specification for displaying rich promotional details, such as discounts and coupon codes, is based on the Promotion schema from Schema.org, conveyed through JSON-LD.
- Required Google Registration: Utilizing Gmail promotional tab annotations necessitates a mandatory, one-time registration of the sender's email address with Google, a prerequisite for activating email markup features.
Key considerations
- Registration Prerequisites: To qualify for the required Google registration, senders must meet specific prerequisites, including maintaining a low spam rate, sending a significant volume of emails, and ensuring a valid SPF, DKIM, and DMARC setup for their domain.
- Static JSON-LD: Given that JavaScript is not supported in email clients, all details for promotional annotations, such as offer specifics and timing, must be accurately conveyed through the static JSON-LD data embedded in the email.
Technical article
Documentation from Google Developers explains that Gmail promotional tab annotations exclusively use JSON-LD markup, which is embedded directly within the HTML of the email. It clarifies that these annotations do not rely on JavaScript for their functionality. Furthermore, senders are required to register their sending email address with Google through a one-time process to enable the use of email markup for promotional annotations.
13 Oct 2024 - Google Developers
Technical article
Documentation from Schema.org explains the Promotion schema, a structured data vocabulary that forms the basis for rich email features like Gmail promotional tab annotations. It details the properties such as discount, couponCode, promoStartTime, and promoEndTime, which are used to convey promotional information in a machine-readable format via JSON-LD. While not specific to Gmail, it provides the foundational technical specification for the data structure.
11 Dec 2024 - Schema.org
Do Google Annotations impact email deliverability or inbox placement?
How do I implement Gmail Annotations and troubleshoot common issues?
How do I register with Gmail for Email Markup?
How does the Gmail promotions tab affect email open rates and pixel loading?
Is BIMI required for Gmail Markup and what setup is needed for AMP?
What is the new layout of the Gmail promotions tab and how do annotations help?
