Gmail Promotional Annotations

Understand how to put the most valuable parts of email right at people's fingertips.



Public Beta

This feature is released in Public Beta and is available in the new CleverTap campaigns UI.

Gmail Promotional Annotations enables you to highlight your email on the Gmail Promotions tab. Your email can include additional information, such as promotion codes, a featured image, and deal expiration dates. This information is visible to your email subscribers before opening the email. It is an excellent way to excite your users to open your message by setting it apart from other emails in the user's inbox. CleverTap provides you with a no-code way to annotate your email messages.


Feature Deprecation

Google has deprecated the Single Image annotations.


Annotated Email

Annotate Emails with Deal Annotations

Follow the steps to annotate emails in an email campaign:

  1. Create an email campaign.
  2. Define the message content from the Email Editor.
  3. Click Sender details.
  4. To annotate your email, select Highlight with Gmail promotional annotations . The following options display:

Annotate Emails

  1. Add the required information.
ElementDescriptionBest Practices
Sender nameAdd your business name.This field is populated automatically using the From part of the Sender Details.
Subject lineAdd a unique and relevant subject line for the inbox. We recommend a 44-character limit for optimal rendering.This field is populated automatically using the Subject part of the Sender Details. This alternative subject will only be displayed if the discount code or sale badges are also displayed. For example, if the original subject was 20% Off Sale Ends Today and the offer badge is 20% Off, add a subject line that says Sale Ends Today to avoid duplication.
Company logoUpload an image or add a URL. Check that the URL is https (not http).Ensure that you use an https (not http) URL. This logo selection only shows in the email preview.
Discount offerHighlight any offerings such as 20% off or Free Shipping. We recommend a 20-character limit for optimal rendering.Avoid using more than four words or full sentences in this space, as it competes with your subject line. When your email text space is full, the offer title truncates (for example, "...").
  • Do not repurpose. Use promotional offerings to ensure clarity and simplicity. Do not utilize it for other actions like Open now.

  • Do not use run-on sentences. Avoid saying things such as 25% off unless you’ve already purchased from us in which case other ... Long sentences are truncated.

Offer codeAdd the promo code. We recommend a 20-character limit for optimal rendering.Only use a discount code if you have it featured in the email. Do not repurpose this space because it always says Code before the text.
Offer periodSelect the offer date range.Using this feature allows an email to be previewed twice at the top in a bundle:
  • once when it is first sent.
  • again within three days of the offer expiry.
When personalizing Offer period, specify the time and timezone. For example, 2018-12-30T23:59:59-0700.
  1. Click Preview & Test to preview the annotated email message.


Supported Inboxes

The Gmail app for Android and iOS supports highlighting emails with promotional annotations. Google plans to extend this capability to Gmail for desktop soon.

Test Annotation

Create a unique Gmail testing account ending with [email protected] for your team. For example, [email protected]. This unique account will have a more aggressive email ranking and bundling to make testing easier and faster.


Before troubleshooting a problem, check your account-level settings in your Gmail app. Check that you have enabled the following settings to test the latest experiences in the Gmail promotions tab. These are the default settings:

  • Images: Always show.
  • Conversation view: On.
  • Enable Bundling of Top Email: On.

The following sections discuss common issues encountered when attempting to test:

Not seeing email bundles at all.

  • Check that the device has the latest version of the Gmail app. Refresh your email within the Promotions tab.
  • Try restarting your device.
  • Try viewing the bundle on another device if the issue is still unresolved. For example, a tablet may have a different Gmail version and show the bundle differently.


Email is held up

There is a chance your email could be in a holdback group. If none of the measures worked, create a new account ending with [email protected]. For example, create [email protected] and use that new account for testing.

Email does not show up on the Promotions tab.

Use the following measures:

  • Check if the marketing email was sent from the usual subdomain. Sending from less recognized subdomains can confuse the Gmail tab classifier and prevent an email from being placed on the Promotions tab.
  • Check that your account has no email filters that send email to the primary tab because annotations are only visible on the Promotions tab.
  • Send from different sender subdomains to ensure the email lands under the correct tab. For more information about the Gmail classifier, refer to Bulk Senders Guidelines.
  • If you use a [email protected] account, the first email does not appear on the Promotions tab. Drag the email onto the Promotions tab, and send an email from the same sender address, with a different subject line, to the testing account.

Cannot see your brand's annotated email in a bundle.

  • Check if the email is on the Gmail Promotions tab.
  • Annotated emails are currently not available for Gmail for Business accounts. Ensure that you are testing on your personal Gmail address.
  • Check that the email was not opened or sent on the previous day.
  • An email does not populate in a bundle on another device after viewing it on one device. You must send a new test email to preview.
  • Create multiple testing accounts if you want to visualize on multiple devices. One of your team members might open the email, thus making it unavailable in the bundle for the rest of the team.
  • Check that the annotation is not past the expiration date.
  • Check that you are using the latest version of the Gmail app. Try viewing on another device. For example, a tablet may have a different version of the Gmail app and show email differently.
  • Refresh the Gmail app by pulling down the Gmail Promotions tab screen.
  • Check that you are not using sensitive categories in the Gmail Promotions tab. For example, adult content or debt collection.

The email bundle is visible on one device but not another.

  • Check that you are viewing from the same email account.
  • If email is opened on one device first, it may change the ranking of the bundle on another device.