Get component settings (Beta)

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

This feature is released as part of a Beta program and may change in 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'

Designer Ability

Checks for authorization only

Designer AbilityPermissionLocaleBranchWorkflowSitemode
canAccessCanvasanyanyanyanyany