Skip to content

docs: Document theme template sandbox restrictions#518

Open
promptless-for-oss wants to merge 3 commits into
mautic:5.xfrom
Promptless:promptless/theme-sandbox-generic
Open

docs: Document theme template sandbox restrictions#518
promptless-for-oss wants to merge 3 commits into
mautic:5.xfrom
Promptless:promptless/theme-sandbox-generic

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Adds a concise, generic section documenting that Mautic renders user-uploaded Theme templates in a restricted Twig sandbox environment. Follows maintainer guidance to avoid exposing implementation details of blocked functions and filters.

Trigger Events

  • New Task: Please update the docs based on this PR at mautic/mautic: 5.2.11 update mautic#16173. Note from the PR poster to update the docs:...

Tip: Send Promptless a meeting transcript in Slack to generate doc updates 📝

promptless Bot added 2 commits June 4, 2026 08:27
Document that Mautic sandboxes Twig templates in themes without
exposing implementation details of blocked functions/filters.
@promptless-for-oss promptless-for-oss requested a review from a team as a code owner June 4, 2026 08:37
@promptless-for-oss promptless-for-oss requested review from adiati98 and favour-chibueze and removed request for a team June 4, 2026 08:37
</body>
</html>

Template sandbox restrictions

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Security sandbox feature added in Mautic 5.2.11 via PR #16173. Prose follows maintainer guidance to keep documentation generic without exposing the blocked functions/filters denylist.

Source: mautic/mautic#16173

@adiati98

adiati98 commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

/aside @patrykgruszka, based on your comment in #504, can you please review this PR?

TIA! ✨

@patrykgruszka patrykgruszka left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's good now. We'll need the same for 7.x docs

@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Thanks for the approval! I've created a separate docs PR with the same sandbox documentation for the 7.x docs (targeting the 7.2 branch):

docs: Document theme template sandbox restrictions (7.x)

@adiati98

adiati98 commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

/aside @patrykgruszka a quick question.

These changes applied to all version of Mautic, right? Including version 6?

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.

3 participants