Document custom external scripts with loading strategies

[mintlify]

Summary

• Added documentation for the integrations.customScripts configuration option, which allows loading third-party scripts from external URLs with configurable loading strategies
• Documented the new beforeInteractive loading strategy alongside the existing afterInteractive and lazyOnload options
• Added customScripts properties to the settings reference table

The customScripts feature lets users load external scripts (e.g., analytics, consent managers, chat widgets) via docs.json and control when they execute relative to page load using a strategy option.

---

Note

Low Risk
Low risk documentation-only change; no runtime behavior or security logic is modified.

Overview
Adds documentation for loading external third-party scripts via integrations.customScripts in docs.json, including examples and constraints (HTTPS-only, max 20 scripts, disallowed file types).

Updates the docs.json schema reference to include customScripts entries and the supported load strategy values (beforeInteractive, afterInteractive, lazyOnload).

^{Written by Cursor Bugbot for commit fa96e5a. This will update automatically on new commits. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Mar 27, 2026, 9:53 PM

[ethanpalm]

Closing as duplicate of #4981. That PR is more recent and covers the same customScripts documentation. The most comprehensive version will be reviewed separately.