Skip to main content

​
URL color overrides

You can override Members Portal colors directly from the page URL. This is useful when you want campaign-specific branding, embedded portal styling, or quick design tests without changing saved styling settings in Nexudus.

​
When to use this

Use URL color overrides when you want to:
  • apply a temporary color set for a campaign or event
  • match the portal colors to a partner or white-label site
  • test a new style direction before saving it as the default
Saved colors in Nexudus remain unchanged. URL overrides only affect the session opened with that URL.

​
How it works

When a page loads with supported Theme.* parameters:
  1. Nexudus reads the saved colors for the location.
  2. URL color values are applied on top of the saved colors.
  3. A dynamic stylesheet is generated and loaded with the merged values.
This means the back-end remains the source of saved colors, and URL parameters are applied after those saved colors are returned.

​
Supported parameters

​
Behaviour parameter

ParameterValuesWhat it controls
Theme.DisableDarkModetrue or falseForces light mode if set to true
Theme.DisableLightModetrue or falseForces dark mode if set to true
Theme.ForceDarkModetrue or falseForces dark mode for the session when dark mode is not disabled
Theme.ForceLightModetrue or falseForces light mode for the session

​
Light mode color parameters

ParameterTypical use
Theme.PrimaryColorMain brand color
Theme.SecondaryColorSecondary brand color
Theme.TertiaryColorTertiary accent
Theme.BrandBlackDark neutral brand color
Theme.SuccessSuccess states
Theme.WarningWarning states
Theme.AlertError and alert states
Theme.InfoInformational states
Theme.Highlight1Highlight palette 1
Theme.Highlight2Highlight palette 2
Theme.Highlight3Highlight palette 3
Theme.Highlight4Highlight palette 4
Theme.Highlight5Highlight palette 5
Theme.GroundBase ground color
Theme.SurfaceSurface color

​
Dark mode color parameters

Use the same colors for dark mode with the DarkMode suffix:
  • Theme.PrimaryColorDarkMode
  • Theme.SecondaryColorDarkMode
  • Theme.TertiaryColorDarkMode
  • Theme.BrandBlackDarkMode
  • Theme.SuccessDarkMode
  • Theme.WarningDarkMode
  • Theme.AlertDarkMode
  • Theme.InfoDarkMode
  • Theme.Highlight1DarkMode
  • Theme.Highlight2DarkMode
  • Theme.Highlight3DarkMode
  • Theme.Highlight4DarkMode
  • Theme.Highlight5DarkMode
  • Theme.GroundDarkMode
  • Theme.SurfaceDarkMode

​
Example URL

https://your-portal.nexudus.com/nexudus?Theme.PrimaryColor=%23D6BF57&Theme.SecondaryColor=%23161616&Theme.TertiaryColor=%2385878A&Theme.BrandBlack=%230B0A12&Theme.PrimaryColorDarkMode=%236092C0
Use %23 instead of # in hex values. Example: #D6BF57 must be sent as %23D6BF57.

​
Priority order

If the same visual token exists in multiple places, Nexudus applies values in this order:
  1. URL override parameter
  2. Saved color in Nexudus styling settings
  3. Default portal fallback

​
Light and dark mode behaviour

  • If portal mode is light, light-mode values are used.
  • If portal mode is dark, dark-mode values are used.
  • If Theme.ForceDarkMode=true, the portal is forced to dark mode for that session.
  • If Theme.ForceLightMode=true, the portal is forced to light mode for that session.
  • If Theme.DisableDarkMode=true, the portal is forced to light mode for that session.
  • If Theme.DisableLightMode=true, the portal is forced to dark mode for that session.

​
Mode priority

When multiple mode parameters are present, Nexudus applies this order:
  1. Theme.DisableDarkMode=true or Theme.ForceLightMode=true (light mode)
  2. Theme.DisableLightMode=true or Theme.ForceDarkMode=true (dark mode)
  3. Customer saved mode preference

​
Mode examples

https://your-portal.nexudus.com/nexudus?Theme.ForceDarkMode=true&Theme.PrimaryColorDarkMode=%236092C0

https://your-portal.nexudus.com/nexudus?Theme.ForceLightMode=true&Theme.PrimaryColor=%23D6BF57

​
Troubleshooting

If colors are not changing as expected:
  1. Confirm parameter names are exact, including capitalization and Theme. prefix.
  2. Confirm hex values are URL-encoded with %23.
  3. Confirm you are passing the parameters on the page URL, not only after redirect steps.
  4. Confirm dark mode is not disabled when testing dark-mode colors.
  5. Hard refresh the page to avoid stale browser CSS.