For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Resources
Get started
ReferenceGuidesExamplesChangelog
ReferenceGuidesExamplesChangelog
  • Designer API
    • Introduction
    • Getting Started
    • Webflow CLI
    • Error Handling
    • App Modes
  • Elements
    • Creating & Retrieving Elements
    • Element Properties & Methods
    • Element Types & Methods
  • Styles
    • Managing Style Properties
    • Managing Variable Modes
  • Components
  • Variables & Collections
    • Variable Collections
    • Variables
    • Variable Modes
  • Assets
  • Pages & Folders
  • Utilities
      • Get site information
      • Resize the extension
      • Close the extension
      • Get the current breakpoint
      • Get user ID token
      • Get user's Designer capabilities
      • Get the current Designer mode
      • Check for a Designer mode
      • Get the Designer's pseudo-state
      • Get launch context
      • Get app subscriptions
      • Get theme
      • Get theme styles
    • User Events & Notifications
    • App Intents & Connections
  • Additional Resources
    • API Playground
    • FAQs
LogoLogo
Resources
Get started
On this page
  • webflow.getThemeStyles(themeName)
  • Syntax
  • Parameters
  • Returns
  • Example
  • Designer Ability
UtilitiesSite Information & Settings

Get Theme Styles (Beta)

Was this page helpful?
Previous

Get element snapshot

Next
Built with

webflow.getThemeStyles(themeName)

Returns the structured CSS token values (colors, shadows, controls, opacities) for a given Designer theme. Use these tokens to style your extension’s UI to match the Designer’s visual language.

Beta

These methods are in public beta and may change with future releases.

Syntax

1webflow.getThemeStyles(themeName: AppearanceSettings): Promise<ThemeStyles>

Parameters

  • themeName: AppearanceSettings — The theme to retrieve tokens for. One of 'darkDefault', 'darkDarker', 'darkBrighter', or 'light'. Use webflow.getTheme() to get the currently active theme name.

Returns

Promise<ThemeStyles>

A Promise that resolves to a ThemeStyles object with the following shape:

1{
2 colors: Record<string, string>; // CSS color token values
3 boxShadows: Record<string, string>; // CSS box-shadow token values
4 controls: Record<string, string>; // CSS control/border token values
5 opacities: Record<string, string>; // CSS opacity token values
6}

Each property is a flat key-value map of token names to CSS values.

Example

1const theme = await webflow.getTheme();
2const styles = await webflow.getThemeStyles(theme);
3
4// Apply the Designer's primary background color to your extension
5document.body.style.backgroundColor = styles.colors['bg-primary'];

Try this example

Designer Ability

Designer AbilityLocaleBranchWorkflowSitemode
canAccessCanvasAnyAnyAnyAny