English
Configuration Options

Options (all opt-in and compatible)

  • lockBodyScroll (boolean, default: true)

    • Locks body scroll while the modal is open.
  • injectResponsiveStyles (boolean, default: false)

    • Injects a CSS variable --pf-popup-height and uses fallback for iOS (dvh).
  • forceMobileViewport (boolean, default: false)

    • Forces "mobile" width on the host even on desktop.
    • Use with mobileMaxWidth (e.g., 480).
  • mobileMaxWidth (number|null, default: null)

    • Maximum width of the modal container when forceMobileViewport is active.
  • showCloseButton (boolean|null, default: null)

    • null: follows existing autoOpenValidation.
    • true/false: forces showing/hiding the close button.
  • optimizeResizeUpdates (boolean, default: true)

    • 150ms debounce for layout calculations on resize.
  • strictLang (boolean, default: false) and allowedLangs (array, default: ["pt","en","es"])

    • When active, normalizes the received language to the allowed list.

Other existing options:

  • enableRedirect (boolean) -- reserved; your front-end does not emit redirect.
  • allowedPostMessageOrigins (string[]) -- defaults to kycFrontOrigin.

See Also