Gmail Promotional Annotations
Understand how to put the most valuable parts of email right at people's fingertips.
Overview
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.
Beta Release
This feature is available in the new CleverTap campaigns UI.
Supported Inboxes
The Gmail app for Android & iOS supports highlighting emails with promotional annotations. Google plans to extend this capability to Gmail for desktop soon.

Annotated Email
Annotate Emails
Follow the steps to annotate emails in an email campaign:
- Create an email campaign.
- Define the message content from the Email Editor.
- Click Sender details.
- To annotate your email, click Highlight with Gmail promotional annotations . The following options display:

Annotate Emails
- Add the required information.
Element | Description | Best Practices |
---|---|---|
Sender name for inbox | Add your business name. | Add your Business Name or From Name for the Campaign. |
Subject line for inbox | Add a unique and relevant subject line for the inbox. We recommend a 44 character limit for optimal rendering. | Add a unique subject line for the inbox to avoid duplicate text between the subject, deal badge, and discount code. 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. |
Add company logo | Upload an image or add a URL. Check that the URL is https (not http). | Be sure to use an https (not http) URL. This logo selection only shows in the email preview. |
Add card image | Add an image to display on the email frame. |
|
Offer title | Highlight 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, "...").
|
Promo code | Add 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. Don't repurpose this space, because it always says Code before the text. |
Offer period | Select the offer date range. | Using this feature allows an email to be previewed twice at the top in a bundle:
|
- Click Preview & Test to preview the annotated email message.
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.
Troubleshooting
Before troubleshooting a problem, check your account-level settings in your Gmail app. Check that you've 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 email by pulling down on the screen within the promotions tab.
- Try restarting your device.
- If the issue is still not resolved, try viewing the bundle on another device. 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 email ends up on the correct tab. Refer to Bulk Senders Guidelines for more detail about the Gmail classifier.
- If you are using 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 a previous day.
- An email does not populate in a bundle on another device after it is viewed 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.
Single image preview display is not visible when the annotation includes the image.
- Refresh the Gmail app by pulling down the Gmail Promotions tab screen.
- If your image is considered a sensitive topic, the image may not be shown in the Gmail Promotions tab (for example, adult content or debt collection).
- Gmail may decide not to render the image for your device. It is not guaranteed for the Single image to display for every email.
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.
Updated 6 months ago