Edit for Customize Email section (#426)

Author: hazel-nut

main/docs.json

@@ -1244,42 +1244,40 @@
                         "group": "Customize Emails",
                         "pages": [
                           "docs/customize/email",
-                          "docs/customize/email/manage-email-flow",
-                          {
-                            "group": "Email Templates",
-                            "pages": [
-                              "docs/customize/email/email-templates",
-                              "docs/customize/email/email-templates/use-liquid-syntax-in-email-templates",
-                              "docs/customize/email/email-templates/email-template-descriptions"
-                            ]
-                          },
                           {
-                            "group": "Configure a Custom Email Provider",
+                            "group": "SMTP Email Providers",
                             "pages": [
-                              "docs/customize/email/configure-a-custom-email-provider",
-                              "docs/customize/email/configure-a-custom-email-provider/configure-a-custom-email-provider-with-terraform",
-                              "docs/customize/email/configure-a-custom-email-provider/action-triggers-custom-email-provider-event-object",
-                              "docs/customize/email/configure-a-custom-email-provider/action-triggers-custom-email-provider-api-object"
+                              "docs/customize/email/smtp-email-providers",
+                              "docs/customize/email/smtp-email-providers/amazon-ses",
+                              "docs/customize/email/smtp-email-providers/azure-communication-services",
+                              "docs/customize/email/smtp-email-providers/mailgun",
+                              "docs/customize/email/smtp-email-providers/mandrill",
+                              "docs/customize/email/smtp-email-providers/microsoft-365-exchange-online",
+                              "docs/customize/email/smtp-email-providers/sendgrid",
+                              "docs/customize/email/smtp-email-providers/sparkpost",
+                              "docs/customize/email/smtp-email-providers/smtp-server",
+                              {
+                                "group": "Custom Configuration with Actions",
+                                "pages": [
+                                  "docs/customize/email/smtp-email-providers/custom",
+                                  "docs/customize/email/smtp-email-providers/custom/configure-action",
+                                  "docs/customize/email/smtp-email-providers/custom/action-triggers-custom-email-provider-event-object",
+                                  "docs/customize/email/smtp-email-providers/custom/action-triggers-custom-email-provider-api-object"
+                                ]
+                              },
+                              "docs/customize/email/smtp-email-providers/troubleshooting"
                             ]
                           },
-                          "docs/customize/email/customize-blocked-account-emails",
-                          "docs/customize/email/send-email-invitations-for-application-signup",
                           {
-                            "group": "SMTP Email Providers",
+                            "group": "Email Templates",
                             "pages": [
-                              "docs/customize/email/smtp-email-providers",
-                              "docs/customize/email/smtp-email-providers/configure-amazon-ses-as-external-smtp-email-provider",
-                              "docs/customize/email/smtp-email-providers/configure-azure-comm-service-as-smtp-email-provider",
-                              "docs/customize/email/smtp-email-providers/configure-mandrill-as-external-smtp-email-provider",
-                              "docs/customize/email/smtp-email-providers/configure-365-exchange-as-smtp-email-provider",
-                              "docs/customize/email/smtp-email-providers/configure-sendgrid-as-external-smtp-email-provider",
-                              "docs/customize/email/smtp-email-providers/configure-sparkpost-as-external-smtp-email-provider",
-                              "docs/customize/email/smtp-email-providers/configure-mailgun-as-external-smtp-email-provider",
-                              "docs/customize/email/smtp-email-providers/configure-custom-external-smtp-email-provider"
+                              "docs/customize/email/email-templates",
+                              "docs/customize/email/email-templates/customize-email-templates",
+                              "docs/customize/email/email-templates/supported-liquid-syntax"
                             ]
                           },
-                          "docs/customize/email/configure-test-smtp-email-servers",
-                          "docs/customize/email/troubleshoot-custom-email-provider-delivery-issues"
+                          "docs/customize/email/manage-email-flow",
+                          "docs/customize/email/send-email-invitations-for-application-signup"
                         ]
                       },
                       {
@@ -7621,6 +7619,78 @@
     ]
   },
   "redirects": [
+    {
+      "source": "/docs/customize/email/email-templates/use-liquid-syntax-in-email-templates",
+      "destination": "/docs/customize/email/email-templates/supported-liquid-syntax"
+    },
+    {
+      "source": "/docs/customize/email/email-templates/email-template-descriptions",
+      "destination": "/docs/customize/email/email-templates"
+    },
+    {
+      "source": "/docs/customize/email/configure-a-custom-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/custom"
+    },
+    {
+      "source": "/docs/customize/email/configure-a-custom-email-provider/configure-a-custom-email-provider-with-terraform",
+      "destination": "/docs/customize/email/smtp-email-providers/custom/configure-action"
+    },
+    {
+      "source": "/docs/customize/email/configure-a-custom-email-provider/action-triggers-custom-email-provider-event-object",
+      "destination": "/docs/customize/email/smtp-email-providers/custom/action-triggers-custom-email-provider-event-object"
+    },
+    {
+      "source": "/docs/customize/email/configure-a-custom-email-provider/action-triggers-custom-email-provider-api-object",
+      "destination": "/docs/customize/email/smtp-email-providers/custom/action-triggers-custom-email-provider-api-object"
+    },
+    {
+      "source": "/docs/customize/email/customize-blocked-account-emails",
+      "destination": "/docs/customize/email/email-templates/customize-email-templates"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-amazon-ses-as-external-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/amazon-ses"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-azure-comm-service-as-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/azure-communication-services"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-mandrill-as-external-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/mandrill"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-365-exchange-as-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/microsoft-365-exchange-online"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-sendgrid-as-external-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/sendgrid"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-sparkpost-as-external-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/sparkpost"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-mailgun-as-external-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/mailgun"
+    },
+    {
+      "source": "docs/customize/email/smtp-email-providers/configure-custom-external-smtp-email-provider",
+      "destination": "/docs/customize/email/smtp-email-providers/smtp-server"
+    },
+    {
+      "source": "/docs/customize/email/configure-test-smtp-email-servers",
+      "destination": "/docs/customize/email/smtp-email-providers"
+    },
+    {
+      "source": "/docs/customize/email/troubleshoot-custom-email-provider-delivery-issues",
+      "destination": "/docs/customize/email/smtp-email-providers/troubleshooting"
+    },
+    {
+      "source": "/docs/customize/custom-domains/self-managed-certificates/configure-akamai-for-use-as-reverse-proxy",
+      "destination": "/docs/customize/custom-domains/self-managed-certificates"
+    },
     {
       "source": "/docs/get-started/auth-for-genai",
       "destination": "/docs/get-started/auth0-for-ai-agents"

main/docs/customize/email.mdx

@@ -1,47 +1,29 @@
 ---
-description: Describes the Auth0 built-in email services.
-'og:image': https://cdn2.auth0.com/docs/1.14553.0/img/share-image.png
-'og:title': Customize Emails
-'og:url': https://auth0.com/docs/
-permalink: email
-sidebarTitle: Overview
 title: Customize Emails
-'twitter:description': Describes the Auth0 built-in email services.
-'twitter:title': Customize Emails
+sidebarTitle: Overview
+description: Manage and customize emails sent by Auth0, including account verification, welcome messages, and breached password detection.
+'og:image': https://cdn2.auth0.com/docs/1.14553.0/img/share-image.png
 ---
-You can configure a test SMTP email server in your development or test environments to check for successful email delivery and view how emails you send appear to recipients prior to going to production. To learn more, read [Configure Test SMTP Email Server](/docs/customize/email/configure-test-smtp-email-servers).
-
-Auth0's built-in email provider is **not supported for use in a production environment**, should only be used for testing, and has several restrictions:
 
-* You will not be able to use any of the email customization features. The content of the emails sent for testing will be restricted to the format of the existing templates.
-* All emails will be sent from a predefined **from address** (`[email protected]`).
-* You will be restricted to sending no more than 10 emails per minute, regardless of email type.
-* Your ability to send email from your tenant may be reduced (or even temporarily blocked) if your emails result in high bounce rates.
+Auth0 offers several email-based workflows, like [user account verification](/docs/manage-users/user-accounts/verify-emails) and [breached password detection](/docs/secure/attack-protection/breached-password-detection).
 
-To remove these restrictions, you must set up your own email provider. Some options are:
+To use these workflows, start by configuring an [external SMTP email provider](/docs/customize/email/smtp-email-providers) using credentials from a supported provider (like your Mandrill API key or Amazon SES access keys) or SMTP server details.
 
-* [Configure External SMTP Email Providers](/docs/customize/email/smtp-email-providers)
-* [Configure Custom External SMTP Email Providers](/docs/customize/email/smtp-email-providers/configure-custom-external-smtp-email-provider)
-* [Customize Email Handling](/docs/customize/email/manage-email-flow)
+To manage and customize emails further, you can:
 
-After you have configured your own email service provider, go to [Dashboard > Branding > Email Templates](https://manage.auth0.com/#/emails) to [customize your emails](/docs/customize/email/email-templates). If you have an Auth0 database connection, there are several email templates you can use as part of the authentication flow:
+* **Modify the appearance and content** of emails using [email templates](/docs/customize/email/email-templates) and Liquid, an open-source template language.
 
-* Verification emails (using link or code)
-* Welcome emails
-* Enroll in <Tooltip tip="Multi-factor authentication (MFA): User authentication process that uses a factor in addition to username and password such as a code via SMS." cta="View Glossary" href="/docs/glossary?term=MFA">MFA</Tooltip> emails
-* Change password emails
-* Blocked account emails
-* Password breach alert emails
+* **Fully control the email delivery process** by writing an <Tooltip tip="Action: A Node.js function that executes at defined points during the Auth0 runtime." cta="View Glossary" href="/docs/glossary?term=Actions">Action</Tooltip> that sends requests to your email provider's API and implements custom logic for your use case.
 
-You can restrict user signups to an application with user invitations as a provisioning workflow, either in conjunction with or as an alternative to self-provisioning. To learn more, read [Send Email Invitations for Application Signup](/docs/customize/email/send-email-invitations-for-application-signup).
+* **Trigger emails or create tickets outside the default workflows** using the Management API.
 
-A paid subscription plan is required for email customization. To learn more, read [Auth0 Pricing Page](https://auth0.com/pricing).
+During development, you can use our [built-in email provider](/docs/customize/email/smtp-email-providers#use-the-built-in-smtp-email-provider-for-development) to check email delivery and preview how emails appear during testing.
 
-## Learn more
+## Overview
 
-* [Customize Email Handling](/docs/customize/email/manage-email-flow)
-* [Customize Email Templates](/docs/customize/email/email-templates)
-* [Set Up Database Connections](/docs/get-started/applications/set-up-database-connections)
-* [Configure External SMTP Email Providers](/docs/customize/email/smtp-email-providers)
-* [Configure Test SMTP Email Server](/docs/customize/email/configure-test-smtp-email-servers)
-* [Customize Blocked Account Emails](/docs/customize/email/customize-blocked-account-emails)
+| Read... | To learn... |
+| --------|------------ |
+| [SMTP Email Providers](/docs/customize/email/smtp-email-providers) | <ul><li>How to configure an email provider with a supported integration or SMTP server details</li><li>How to write a custom email provider Action</li><li>The limits of the built-in email provider</li><li>How to troubleshoot email delivery issues</li></ul> |
+| [Email Templates](/docs/customize/email/email-templates) | <ul><li>How to customize emails sent as part of Auth0 workflows</li> <li>About the Liquid syntax and template-specific variables supported in email templates</li></ul>|
+| [Customize Email and Ticket Handling with the Management API](/docs/customize/email/manage-email-flow) | <ul><li>How to send workflow-based emails on demand</li><li>How to generate URLs used in email workflows on demand</li></ul> |
+| [Implement User Invitations using Password Reset Emails](/docs/customize/email/send-email-invitations-for-application-signup) | <ul><li>How to implement invitations for new user accounts on your Auth0 application using Auth0's password reset workflow</li></ul> |