From e0d4cdcf59470a0be881e14cb74c2eb75cab75a3 Mon Sep 17 00:00:00 2001
From: Simeon Vincent <svincent@gmail.com>
Date: Tue, 14 May 2024 09:40:40 -0700
Subject: [PATCH] Add email troubleshooting guide (#1850)

Co-authored-by: rebloor <git@sherpa.co.nz>
Co-authored-by: Andreas Wagner <mail@andreaswagner.org>
---
 .../publish/developer-accounts.md             | 22 +++++++++++++++++++
 src/data/pages.json                           |  4 ++++
 2 files changed, 26 insertions(+)

diff --git a/src/content/documentation/publish/developer-accounts.md b/src/content/documentation/publish/developer-accounts.md
index 84ee06c49..b041ae4e1 100644
--- a/src/content/documentation/publish/developer-accounts.md
+++ b/src/content/documentation/publish/developer-accounts.md
@@ -59,5 +59,27 @@ If you believe your account has been incorrectly blocked, please email amo-admin
 %}
 
 <!-- END: Single Column Body Module -->
+<!-- Single Column Body Module -->
+
+{% capture content %}
+
+## Issues receiving emails from AMO
+
+If you're expecting but haven't received emails from the https://addons.mozilla.org (AMO) platform, check that:
+
+1. Your Mozilla account's primary email address is correct. To update it, see the support article [Change primary email address on Mozilla account](https://support.mozilla.org/en-US/kb/change-primary-email-address-firefox-accounts).
+1. The email isn't in your spam or junk folder. If it is, consider adding the AMO email domain (@mozilla.org) to your [approved senders](https://clean.email/blog/email-security/how-to-whitelist-an-email) list.
+1. Your inbox isn't full.
+1. Your mail provider hasn't implemented a security filter that blocked the email delivery.
+
+If you're still experiencing issues after making these checks, posting details of your issue to the [add-ons community forum](https://discourse.mozilla.org/c/add-ons/35) may help.
+
+{% endcapture %}
+{% include modules/one-column.liquid,
+  id: "email-issues"
+  content: content
+%}
+
+<!-- END: Single Column Body Module -->
 
 
diff --git a/src/data/pages.json b/src/data/pages.json
index 30ccce58c..6d91bcab8 100644
--- a/src/data/pages.json
+++ b/src/data/pages.json
@@ -885,6 +885,10 @@
                   {
                     "title": "Blocked accounts",
                     "id": "blocked-accounts"
+                  },
+                  {
+                    "title": "Issues receiving emails from AMO",
+                    "id": "email-issues"
                   }
                 ]
               },