Skip to content

Document external CSS/font URL requirements in email HTML guidelines (DOC-2315) - #463

Open
BrindaaRC wants to merge 1 commit into
mainfrom
doc-2315-external-css-font-urls
Open

Document external CSS/font URL requirements in email HTML guidelines (DOC-2315)#463
BrindaaRC wants to merge 1 commit into
mainfrom
doc-2315-external-css-font-urls

Conversation

@BrindaaRC

Copy link
Copy Markdown
Contributor

What changed

Adds an External CSS and Font URLs section to the email HTML guidelines page (best-practices-to-be-followed-within-an-email-body-html-guidelines.mdx).

The section:

  • Advises using valid, publicly and directly accessible CSS/font URLs — a <link href> must return the file directly, not a preview/share link (e.g. a Google Drive share link) or a URL that 404s.
  • Explains the symptom: an invalid CSS URL makes the CSS-inlining step fail, so the email is delivered with broken/unstyled content — and the campaign can still be sent.
  • Notes (in a <Warning>) that MoEngage does not validate external CSS/font URLs, so verifying them before sending is the client's responsibility.
  • Cross-links to Custom Fonts as the supported way to generate a valid font CSS URL.

Why

Support ticket SUP-6995 (recurring; also SUP-6383): invalid/inaccessible external CSS URLs caused broken styling while the campaign still sent, with no clear signal to the marketer. Engineering (Apurv Tiwari) confirmed MoEngage cannot validate arbitrary external CSS URLs.

Reviewer notes

  • Behavior is engineering-confirmed; no external input needed.
  • Internal CSS error strings from the ticket were intentionally omitted (a marketer does not see them in the dashboard).
  • Addresses DOC-2315.

🤖 Generated with Claude Code

Add a section explaining that invalid or non-directly-accessible external
CSS/font URLs cause CSS inlining to fail and result in broken styling, while
the campaign can still be sent. Notes that MoEngage does not validate these
URLs and it is the client's responsibility to verify them before sending.

Addresses SUP-6995 (recurring; also SUP-6383).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
moengage 🟢 Ready View Preview Jul 27, 2026, 9:51 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant