← All articles
White-label · Failure mode #11

Custom CSS broke my dashboard layout

Validate against the supported CSS selectors; reset to default to recover; contact support with the specific rule causing the issue.

What's happening

Tier 3 includes custom CSS injection — you can add styles to override the default agency-brand colours, fonts, spacing, and component visuals. We sandbox the CSS to a small set of supported selectors and prevent things that would break the app (like display: none on critical buttons or position: fixed overlays), but it's still possible to write a rule that distorts a layout in a way that's hard to recover from in the UI.

The "I can't see the reset button because my custom CSS hid it" recovery path is documented below.

How to fix it

  1. Open AgencyLens with a query parameter to disable custom CSS: https://dashboard.agencylens.app/?nocss=1. This bypasses your custom rules just for this session.
  2. Once the dashboard is usable again, go to Settings → Branding → Custom CSS.
  3. Click Reset to default. Your custom rules are saved in case you want to bring them back, but the active stylesheet returns to the AgencyLens default.
  4. If you want to keep most of your custom CSS, click Edit instead. Remove the most recent rule first (the one you added just before the layout broke) and click Validate. Our validator flags rules that target unsupported selectors, use !important on layout properties, or include position: fixed.
  5. Re-add rules one at a time, validating after each, until you find the one causing the issue.

Most layout breaks come from one of: too-large fixed widths, padding values that overflow the viewport on narrow screens, or font sizes that push text out of buttons. Stick to relative units (rem, %, em) and you'll have fewer of these.

When to email support

If ?nocss=1 doesn't restore the layout, the issue isn't your custom CSS — that's a bug on our side. Email support@agencylens.app with: a screenshot of the broken layout, the browser + OS, and (if you remember) the most recent change you made.

Screenshots needed (operator notes)
  • Custom CSS editor with validator output
  • Before/after of a layout break
  • Reset to default confirmation dialog