Get resolved settings (Beta)

element.getResolvedSettings()

Get the resolved values for all settings on an element.

This method returns the final output value for each setting. Bindings are resolved to their actual values rather than returned as binding references. For example, a setting bound to a component prop returns the current value of that prop rather than a binding reference object.

Limitation: this method does not return resolved values for settings that are bound to CMS fields; it returns the binding reference instead.

To get the binding references instead of the resolved values, use element.getSettings().

Syntax

1
element.getResolvedSettings(): Promise<Record<string, ResolvedValue | null>>

Returns

Promise<Record<string, ResolvedValue | null>>

A Promise that resolves to an object mapping setting keys to their resolved values.

Related types:

1
type ResolvedValue =
2
  | string
3
  | number
4
  | boolean
5
  | null
6
  | LinkResolvedValue
7
  | VideoResolvedValue
8
  | RichTextResolvedValue

Example

1
const element = await webflow.getSelectedElement()
2
3
if (element) {
4
  const settings = await element.getResolvedSettings()
5
  console.log(settings)
6
7
  /*
8
  {
9
    tag: 'h2',
10
    domId: 'my-heading',   // prop binding resolved to its current value
11
    altText: 'A sunset photo',
12
  }
13
  */
14
}

Designer Ability

Checks for authorization only.