Docs Customer Email Verification How to Customize the Popup Style?

How to Customize the Popup Style?

Once you’re in the Customizer (see Customization for how to get there), click Design → Popup Style to reach the settings on this page. Adjust the settings below, then click Publish to save your changes.

Overlay & Background Settings

SettingDescriptionDefault
Overlay Background ColorColor of lightbox overlay behind popup#ffffff
Widget Background ColorBackground color of popup widget#f5f5f5
The overlay is a solid, fully-opaque color — there’s currently no separate opacity/transparency control for it, so pick a color with enough contrast against your popup card rather than expecting a translucent dim effect.

Popup Layout Settings

SettingDescriptionRangeDefault
Content AlignmentAlign popup contentCenter, LeftCenter
Content WidthWidth of popup widget300px – 600px440px
Content PaddingInternal spacing10px – 100px30px

Popup Header Settings

SettingDescriptionRangeDefault
Header ImageUpload logo or custom imageMedia uploadEmail icon
Image WidthWidth of header image25px – 250px80px
Header Font SizeSize of header text10px – 30px18px

Verification Button Settings

SettingDescriptionDefault
Button ColorBackground color of verify button#2296f3
Button Font ColorText color of verify button#ffffff
Button Font SizeSize of button text14px
Button PaddingInternal padding of button15px
Expand ButtonMake button full-widthDisabled

How to Customize the Popup Content?

  • In the customizer, click Popup Content.
  • Select the Widget Type from the dropdown.
  • Edit the content fields for your selected type.
  • Click Publish to save changes.

Available Widget Types

Widget TypeDescription
RegistrationPopup shown during account registration
Checkout Email PopupInitial email entry popup at checkout
Checkout OTP PopupOTP entry popup after code is sent
Login AuthenticationPopup for suspicious login attempts — see Settings to enable this feature
Checkout Email Popup and Checkout OTP Popup have no separate Button Text field — their button label isn’t customizable in this version, unlike Registration and Login Authentication.

How to Customize the Registration Popup Content?

  • In the customizer, click Popup Content.
  • Select Widget Type: Registration from the dropdown.
  • Edit the following fields:
FieldDescriptionDefault Value
Header TextTitle at top of popup“Verify it’s you.”
Verification MessageMain message body“We sent verification code to {customer_email}. To verify your email address, please check your inbox and enter the code below.”
Footer TextText below form“Didn’t receive an email? {cev_resend_verification}”
Button TextVerify button text“Verify Code”

How to Customize the Checkout Email Popup Content?

  • In the customizer, click Popup Content.
  • Select Widget Type: Checkout Email Popup from the dropdown.
  • Edit the following fields:
FieldDescriptionDefault Value
Header TextTitle at top of popup“Verify it’s you.”
Verification MessageMain message body“Please verify your email address to proceed to checkout.”
Footer TextText below form“Already have an account? Login now”

How to Customize the Checkout OTP Popup Content?

  • In the customizer, click Popup Content.
  • Select Widget Type: Checkout OTP Popup from the dropdown.
  • Edit the following fields:
FieldDescriptionDefault Value
Header TextTitle at top of popup“Verify it’s you.”
Verification MessageMain message body“We sent verification code to {customer_email}. To verify your email address, please check your inbox and enter the code below.”
Footer TextText below form“Didn’t receive an email? {cev_resend_verification}”

How to Customize the Login Authentication Popup Content?

  • In the customizer, click Popup Content.
  • Select Widget Type: Login Authentication from the dropdown.
  • Edit the following fields:
FieldDescriptionDefault Value
Header TextTitle at top of popup“Verify it’s you.”
Verification MessageMain message body“We sent verification code to {customer_email}. To verify your email address, please check your inbox and enter the code below.”
Footer TextText below form“Didn’t receive an email? {cev_resend_verification}”
Button TextVerify button text“Verify Code”

Popup Content Placeholders

PlaceholderDescriptionExample
{customer_email}Customer’s email address[email protected]
{cev_resend_verification}Clickable resend linkResend Code

Not every popup accepts every placeholder. {site_title} works everywhere; {customer_email} and {cev_resend_verification} are only available on some:

Widget TypeAvailable placeholders
Registration{site_title} only
Checkout Email Popup{site_title} only
Checkout OTP Popup{site_title}, {customer_email}, {cev_resend_verification}
Login Authentication{site_title}, {customer_email}, {cev_resend_verification}

Troubleshooting

  • The popup doesn’t appear at all — confirm the matching feature is enabled first (e.g. Checkout Verification or Login Authentication in Settings) — the Customizer only changes the appearance of a popup that’s already active, it doesn’t turn one on.
  • Colors or layout look different on the live site than in the preview — your theme’s own CSS may be more specific than the popup’s styles. Check your browser’s inspector for a conflicting rule and add a more specific override in your theme’s custom CSS if needed.

Related