--- title: "Custom CSS: troubleshooting layout issues" slug: "custom-css-troubleshooting" updated: 2026-11-13T16:33:36Z published: 2026-11-13T16:33:36Z canonical: "help.userflow.com/custom-css-troubleshooting" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.userflow.com/llms.txt > Use this file to discover all available pages before exploring further. # Custom CSS: troubleshooting layout issues Custom CSS lets you change how Userflow content looks beyond what a theme's settings allow. This page covers the common problems: CSS that changes your app's layout, and the tooltip and avatar changes themes can't make. Add custom CSS on a theme in **Settings > Themes**; see [Customizing Themes](/userflow/docs/themes). ## Does custom CSS change the rest of my app? No. Userflow loads a theme's custom CSS only into the frames that Userflow content runs in, so even broad rules like `body` or `p` only style Userflow content that uses that theme. Your app's own pages aren't affected. If your app's layout changes when Userflow content shows, the cause is somewhere else, for example a backdrop or a Resource Center covering part of the page. See [Troubleshooting Userflow.js Performance](https://help.userflow.com/docs/troubleshooting-userflow-js-performance) or contact support. **How to test custom CSS:** 1. Add the CSS to a copy of your theme, not the live one. 2. Switch one flow to the copy and preview it on a representative page of your app. 3. Check it on desktop and mobile sizes if your app is responsive. ## Tooltip spacing and avatar placement: what themes can't do ### Add space between a tooltip and the element it points to Userflow themes don't have a setting for the gap between a tooltip and the element it points to. The tooltip settings in **Settings > Themes** don't cover spacing. Spacing isn't something custom CSS supports either, because it would mean overriding Userflow's internal styles, which can change in any release. Contact support if the gap is a problem, and we'll pass it to the product team. ### Show the avatar on speech bubbles but not on modals The **Avatar type** setting in a Userflow theme applies to modals and speech bubbles together, so there's no theme setting that shows the avatar on one and not the other. Custom CSS doesn't support this either, because the avatar uses Userflow's internal styles. If you need it, contact support and we'll pass the request to the product team. If a tooltip or step sits under your app's own modals, see the z-index check in [Launcher or banner not showing](/userflow/docs/launcherbanner-not-showing#is-the-zindex-lower-than-your-application-content).