Skip to main content
The paraModalConfig prop passed to ParaProvider controls the modal’s runtime behavior and accepts a number of customization options.
In v3, the partner record is the source of truth for configuration (auth methods, theme, 2FA, guest mode, layout, branding). The matching paraModalConfig props below — such as oAuthMethods, theme, twoFactorAuthEnabled, isGuestModeEnabled, authLayout, logo — are deprecated and act only as a lowest-priority fallback. Configure these in the Developer Portal, and read How Configuration Works for the supported in-code override (configOverrides). The props that remain code-only are runtime/behavior props like currentStepOverride, defaultAuthIdentifier, and onClose.
Para Modal Customization

Basic Setup

Pass the paraModalConfig object to your ParaProvider to customize the modal:

Configuration Options

A full list of available configuration options for the paraModalConfig prop available on the ParaProvider component:

Complete Example

Here’s a comprehensive example showcasing multiple configuration options:
Test your modal configuration with our interactive tool:

Next Steps

Explore detailed configuration guides for specific aspects of the modal: