> This page is for Designer API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.webflow.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server.

# Get settings (Beta)

> Get the raw values for all settings on an element.

## `element.getSettings()`

Get the raw values for all settings on an element.

This method returns the current value for each setting as it is stored.
Statically set values are returned as-is.
Values that are bound to a data source are returned as binding reference objects with a `sourceType` field.

To get the resolved values instead of the binding references, use [`element.getResolvedSettings()`](/designer/reference/element-settings/getResolvedSettings).

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

For Collection List elements, this method also returns structured Collection List settings.
See [Collection List settings](/designer/reference/element-settings/collection-list-settings).

## Syntax

```typescript
element.getSettings(): Promise<ElementSettingSummaries>
```

Related types:

```typescript
/**
 * Each key is a setting key (e.g., 'domId', 'tag', 'visibility').
 * Static values are bare (string, number, boolean, etc.).
 * Bound values include binding metadata (sourceType + source fields).
 * Settings with no value and no default are null.
 */
type ElementSettingSummaries = Record<string, ResolvedValue | BindingValue | null>;
```

## Returns

**Promise\<ElementSettingSummaries>**

A Promise that resolves to an object mapping setting keys to their raw values.
Static values are returned as-is, and bound settings are returned as binding reference objects.

For elements that support custom attributes, the returned object includes an `attributes` key containing an array of `AttributeEntry` objects.
Each entry's `name` and `value` can be a string or a `BindingValue` if the attribute is bound.

## Example

```typescript
const element = await webflow.getSelectedElement()

if (element) {
  const settings = await element.getSettings()
  console.log(settings)

  /*
  {
    tag: 'h2',
    domId: { sourceType: 'prop', propId: 'prop_3' },
    altText: 'A sunset photo',
    attributes: [
      { name: 'data-label', value: 'primary' },
      { name: 'data-index', value: '1' },
    ],
  }
  */
}
```

## Designer Ability

Checks for authorization only.

| Designer Ability    | Locale | Branch | Workflow | Sitemode |
| :------------------ | :----- | :----- | :------- | :------- |
| **canAccessCanvas** | Any    | Any    | Any      | Any      |