Back to home

NudgeCSS Guide

Everything you need to start editing your website visually.

Installing NudgeCSS

NudgeCSS is a Chrome extension. It takes about 30 seconds to install and requires no account or sign-up.

  1. Click the Install Free button at the top of this page or go to the Chrome Web Store listing.
  2. Click Add to Chrome on the store page.
  3. When Chrome asks for permissions, click Add extension.
  4. You will see the NudgeCSS icon appear in your Chrome toolbar. If you do not see it, click the puzzle piece icon in the toolbar and pin NudgeCSS.
  5. Navigate to any website and click the NudgeCSS icon to open the editor panel.
Tip: The first time you open the panel on a new tab, Chrome may take a second to inject the extension. If nothing happens, try refreshing the page and clicking the icon again.

Picking an Element

Once the NudgeCSS panel is open, you can select any element on the page using these methods:

ActionWhat it does
ClickSelect the element you clicked
Cmd + ClickSelect the parent container of the clicked element
Parent button in panelMove selection up one level to the parent element
Layer panelSelect any element by clicking it in the layer list

When an element is selected, it shows a blue outline on the page and its properties load in the editor panel on the right.

Typography Controls

The Typography group lets you adjust all text-related properties on the selected element.

  • Font Family: Choose from system fonts or common web fonts.
  • Font Size: Adjust with a slider or type a value directly. Supports px, rem, and em units.
  • Font Weight: From thin (100) to black (900). Only weights supported by the font will apply.
  • Line Height: Controls the space between lines of text.
  • Letter Spacing: Adjusts the space between individual characters.
  • Text Color: Opens a color picker with hex input and opacity control.
  • Text Transform: Toggle between normal, uppercase, lowercase, and capitalize.
  • Text Align: Left, center, right, or justify.

Appearance Controls

The Appearance group controls the visual styling of the element box itself.

  • Background Color: Set a solid background color with full opacity control.
  • Opacity: Adjust the overall opacity of the element from 0 to 100%.
  • Border Radius: Round the corners of the element. You can control all corners together or each one individually.
  • Border: Set border width, style (solid, dashed, dotted), and color.
  • Box Shadow: Add and adjust drop shadows with control over offset, blur, spread, and color.
  • Visibility: Toggle the element's visibility without removing it from the layout.

Using the Layer Panel

The Layer Panel shows the elements inside your currently selected section. It is the fastest way to find and select nested elements that are difficult to click directly on the page.

Each layer is labeled by its element type: Text, Image, Button, or Div. Clicking a layer in the panel selects that element and loads it in the editor.

The Back to Layers button appears after you drill into a child element, letting you return to the parent layer view.

Tip: If you are trying to edit an image that sits inside a container or behind an overlay, use the Layer Panel to find and select it directly. The panel surfaces image layers even when they are hidden behind other elements.

Exporting Your CSS

NudgeCSS does not edit your live site files directly. Instead, it generates the CSS that represents your changes, which you copy and paste into your site's stylesheet.

When you are ready to export, click the Export button in the panel. Two options are available in the free tier:

  • Copy CSS Patch: Copies the CSS for your current element's changes. Paste this into your site's stylesheet or a <style> tag.
  • Copy for Claude: Copies the element's CSS context formatted for use with an AI assistant. See the section below for details.

Pro users also have access to Download JSON, which exports all changes from the current session as a structured file.

Copy for Claude

Copy for Claude is a special export that packages the selected element's current styles and context into a prompt-ready format. When you paste it into Claude or another AI assistant, the AI has exactly what it needs to understand the element and suggest or apply further changes.

This is useful when you have made some visual changes with NudgeCSS and want the AI to take it further, or when you want to describe a change in plain language and have the AI write the exact CSS for you.

To use it:

  1. Select the element you want to work on.
  2. Click Export, then choose Copy for Claude.
  3. Open Claude (or your preferred AI assistant) and paste the copied text.
  4. Add your request in plain language, for example: "Make the heading larger and change the color to dark navy."

FAQ

Will NudgeCSS work on my site if it was built with Squarespace, Wix, or Webflow?

Yes. NudgeCSS works on any page you can open in Chrome. It reads the live rendered HTML and CSS, so it works regardless of the platform used to build the site. Some platforms may reload the page on navigation, which would reset your unsaved changes, so export your CSS before navigating away.

My changes look right in NudgeCSS but disappear when I reload. Why?

NudgeCSS is a live preview tool. Your changes are not saved to your site's files automatically. You need to export the CSS and paste it into your site's stylesheet to make the changes permanent. This is by design: it lets you experiment freely without accidentally breaking anything.

Can I edit elements I cannot click on directly?

Yes. Use the Layer Panel to find and select any element in the page structure, including elements that are behind overlays, too small to click, or hidden under other elements.

Does NudgeCSS work on password-protected or login-required pages?

Yes, as long as you are logged in and the page loads normally in Chrome, NudgeCSS can inspect and edit it. It operates on the rendered page in your browser, not the server.

How do I paste my exported CSS into my site?

This depends on your site platform. On Astro or similar static sites, paste it into the relevant component's <style> block or your global stylesheet. On WordPress, paste it into the Additional CSS section under Appearance. On most platforms there is a "Custom CSS" option in the theme settings.