<scripttype="application/ld+json">
[{"@context":"http://schema.org/","@type":"Organization","logo":"https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png"},{"@context":"http://schema.org/","@type":"EmailMessage",// An alternative subject line shown when deal badge or discount code is also displayed."subjectLine":"Alternate Subject Line"}]
</script>
[null,null,["最后更新时间 (UTC):2025-08-04。"],[],[],null,["# Troubleshooting\n\n| **Note:** For assistance with troubleshooting or to learn more about the following annotation features, send an email to [p-Promo-Outreach@google.com](mailto:p-Promo-Outreach@google.com).\n\nAccount settings\n----------------\n\nBefore you begin troubleshooting a problem, check your account-level settings.\nBe sure you've enabled the settings below in order to test the\nlatest experiences in the Gmail Promotions tab. These are the default settings.\n\n- **Images:** Always show.\n- **Conversation view:** On.\n- **Enable Bundling of Top Email:** On.\n\nChallenges with email construction\n----------------------------------\n\nIf you are having issues when building your email, the following sections\nmay help:\n\n### Can't put code into the head\n\nDepending upon how your email construction works, the system responsible for the\ndeal/product in the body of the email is separate from what handles the HTML\nhead (it may not know what deal to inject into the head). Feel free to insert\npart or all of the script tag in the body of the email, so that the part of the\nsystem handling the deal information can inject the entire script tag or the\npart containing the deal `\u003cscript\u003e{\"@type\": \"DiscountOffer\", ...}\u003c/script\u003e` into\nthe body.\n\n### Script tags get stripped by your email service provider\n\nSchema.org has a microdata way to annotate that may be allowed if your ESP won't\nmake an exception.\n\nInstead of `\u003chead\u003e\u003cscript\u003e...\u003c/script\u003e\u003c/head\u003e`, a microdata example could be\nanywhere in the html and look like this: \n\n \u003cdiv itemscope itemtype=\"http://schema.org/Organization\"\u003e\n \u003cmeta itemprop=\"logo\" content=\"https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png\" /\u003e\n \u003c/div\u003e\n \u003cdiv itemscope itemtype=\"http://schema.org/DiscountOffer\"\u003e\n \u003cmeta itemprop=\"description\" content=\"20% off\" /\u003e\n \u003cmeta itemprop=\"discountCode\" content=\"PROMO\" /\u003e\n \u003cmeta itemprop=\"availabilityStarts\" content=\"2018-01-01T08:00:00-07:00\" /\u003e\n \u003cmeta itemprop=\"availabilityEnds\" content=\"2018-04-30T23:59:59-07:00\" /\u003e\n \u003c/div\u003e\n \u003cdiv itemscope itemtype=\"http://schema.org/PromotionCard\"\u003e\n \u003cmeta itemprop=\"image\" content=\"https://www.google.com/gmail-for-marketers/promo-tab/markup-tool/sample.png\" /\u003e\n \u003c/div\u003e\n\nThis alternate method can also be tested in our [preview tool](/workspace/gmail/promotab/overview).\n\n### Separate script tag for easier implementation\n\nYou can split the annotation to avoid sending old content or if features come\nfrom a content block. Place a portion of the script tag in the head and the\nrest in a block of the body.\n\nHere is an example of placing only the logo and alternate subject line in the\nhead, with the badges, expiration date, and image preview of the annotation in\nthe body of the email:\n\n#### In the `\u003chead\u003e`\n\n \u003cscript type=\"application/ld+json\"\u003e\n [{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"Organization\",\n \"logo\": \"https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png\"\n },{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"EmailMessage\",\n // An alternative subject line shown when deal badge or discount code is also displayed.\n \"subjectLine\": \"Alternate Subject Line\"\n }]\n \u003c/script\u003e\n\n#### In the `\u003cbody\u003e`\n\n \u003cscript type=\"application/ld+json\"\u003e\n [{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"DiscountOffer\",\n \"description\": \"20% Off\",\n \"discountCode\": \"PROMO\",\n \"availabilityStarts\": \"2019-01-01T08:00:00-07:00\",\n \"availabilityEnds\": \"2019-12-30T23:59:59-07:00\"\n },{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"PromotionCard\",\n \"image\": \"https://www.google.com/gmail-for-marketers/promo-tab/markup-tool/sample.png\"\n }]\n \u003c/script\u003e\n\n| **Note:** You can't distribute your annotation fields between the head and body. For example, you can't place the deal badge and promo code of a discount offer (`\"@type\": \"DiscountOffer\"`) in the body while placing the expiration date in the head. If you attempt this, only one indeterminate portion of the annotation is displayed.\n\nChallenges seeing or testing email\n----------------------------------\n\nThe following sections discuss common issues encountered when attempting to view\nor test email:\n\n### Not seeing email bundles at all\n\n- Make sure you are on a device with the latest version of the Gmail App. Refresh email by pulling down on the screen within the Promotions tab.\n- Try restarting your device.\n- Still not working? Try viewing on another device---for example, a tablet may have a different Gmail version and show the bundle differently.\n- Only consumers see the email bundles. The experience does not impact Google Workspace users.\n\n| **Note:** There is a chance your email could be in a holdback group. If none of the above worked, create a new account ending in `promotabtesting@gmail.com`. For example, create `mycompanypromotabtesting@gmail.com` and use that new account for testing.\n\n### Email not going into the Promotions tab\n\n- Check if the email was sent from the usual subdomain marketing email are sent from. Sending from less recognized subdomains can confuse the Gmail tab classifier and prevent an email from being placed on the Promotions tab.\n- Check to make sure your account has no email filters which are sending email to the primary tab.\n- Send from separate sender subdomains to ensure email ends up in the correct tab. See [Bulk Senders Guidelines](https://support.google.com/mail/answer/81126) for more detail about the Gmail classifier.\n- If you are using a promotabtesting@gmail.com account this is the intended behaviour for the first email. Please drag the email into the Promotions tab, and send an email from the same sender address, with a different subject line, to the testing account. You should now be able to visualize it.\n\n### Seeing bundles, but not seeing your brand's annotated email in a bundle\n\n- Check if the email is in the Gmail Promotions tab.\n- Ensure the email has not yet been opened, and was not sent on a previous day.\n- If email in a bundle is viewed on one device, then that email doesn't populate in a bundle again on another device. You must send a new test email to preview.\n- We recommend creating multiple testing accounts if you want to visualize on multiple devices. One of the members of your team might open the email thus causing it not to populate in the bundle for the rest of the team.\n- Make sure the annotation in the sent email's code is correct (the expiration can cause email not to display if before the start date or expired).\n- Be sure 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 Gmail app and show email differently.\n- Refresh the Gmail app by pulling down the Gmail Promotions tab screen.\n- Try restarting your device.\n- You cannot use sensitive categories in the Gmail Promotions tab (for example, adult content or debt collection).\n\n### Not seeing an image preview display when image is included in the annotation\n\n- Check the script tag to ensure the correct URL is in your sent image.\n- Refresh the Gmail app by pulling down the Gmail Promotions tab screen.\n- If your image is considered to be a sensitive topic, the image may not be shown in the Gmail Promotions tab (for example, adult content or debt collection).\n\n### Seeing bundle on one device but not another\n\n- Make sure you are viewing from the same email account.\n- If email is opened on one device first, it may change the ranking and not show in bundle in the other device."]]