How to Add a Pop-Up Message on the Okta Sign-In Page for a Custom Brand
May 12, 2026
Okta Identity Engine
Administration
Overview
Some organizations may be required to display a pop-up message on the sign-in page when a user accesses their org, which they must interact with before proceeding. This article provides the details needed to implement this for the custom brand.
NOTE: This requires customization of the Sign-In Widget (SIW) code; to customize the SIW code, a custom domain must be applied to the brand.
Applies To
- Custom Brands
- Sign-In Page
- Okta Identity Engine (OIE)
Solution
Please follow the steps below to implement a pop-up message that must be interacted with when users access the custom brand's domain.
- In the Admin Console, navigate to Customizations > Brands.
- Select a custom brand with an existing custom domain to apply this change.
- Click on the Pages tab.
- Click the Configure button for the Sign-in page option.
- If the Code editor is not enabled, enable it now.
- The screen will now show the code for the sign-in page. Modify the HTML within the
<head>section of the code. - Click the Edit button in the top-right corner of the code editor box.
- Just above the
</head>line, add the following:<script>alert("Enter whatever message you need displayed in the pop-up window here surrounded by the double quotes")</script>. - Click the Save as draft button that replaced the Edit button in the top-right corner.
- The Preview button displays the changes, while the Publish button applies them.
The custom brand should now have a pop-up window displaying the message added in the <script> section when a user accesses the custom domain. They will need to click OK to proceed with the sign-in flow.
