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
      • Create a component instance
      • Open a component canvas
      • Set the selected variant
      • Select a component
      • Exit out of a component
      • Get root element
      • Get component name
      • Get component
      • Set component name
      • Get component settings
      • Set component settings
      • Get props
      • Create a prop
      • Create multiple props
      • Get a prop
      • Get a prop by name
      • Set prop settings
      • Remove a prop
  • Variables & Collections
    • Variable Collections
    • Variables
    • Variable Modes
  • Assets
  • Pages & Folders
  • Utilities
    • User Events & Notifications
    • App Intents & Connections
  • Additional Resources
    • API Playground
    • FAQs
LogoLogo
Resources
Get started
On this page
  • component.getSettings()
  • Syntax
  • Returns
  • Example
  • Designer Ability
ComponentsManaging Components

Get component settings (Beta)

Was this page helpful?
Previous

Set component settings (Beta)

Next
Built with

component.getSettings()

Retrieves the settings of a component, including its name, group, and description. Returns empty strings for group and description if they are not set. To get only the name of a component, see Get component name.

Beta

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

Syntax

1component.getSettings(): Promise<ComponentSettings>

Returns

Promise<ComponentSettings>

A Promise that resolves to a ComponentSettings object with the following properties:

PropertyTypeDescription
namestringThe name of the component.
groupstringThe group the component belongs to. Empty string if not set.
descriptionstringThe description of the component. Empty string if not set.

Example

1const components = await webflow.getAllComponents();
2const component = components[0];
3
4const settings = await component.getSettings();
5console.log(settings.name); // 'Hero Section'
6console.log(settings.group); // 'Sections'
7console.log(settings.description); // 'A reusable hero with heading and CTA'

Try this example


Designer Ability

Checks for authorization only

Designer AbilityPermissionLocaleBranchWorkflowSitemode
canAccessCanvasanyanyanyanyany