The Heading element represents an element within the Webflow Designer. The following methods are specific to Heading elements.

Properties

Property	Description	Type	Example
`id`	Unique identifier for the element composed of two identifiers, the `component` and the `element`.	`object`	`{component: "64c813...", element: "5edf8e59-71f9..."}`
`type`	Specifies the type of the element.	‘string'	'Heading’
`children`	Indicates if the element can contain child elements.	`boolean`	`true`
`customAttributes`	Indicates if the element can contain custom attributes.	`boolean`	`true`
`styles`	Indicates if the element can contain styles.	`boolean`	`true`
`textContent`	Indicates if the element can contain text content	`boolean`	`true`

Methods

`element.getHeadingLevel()`

Retrieves the heading level of a heading element.

Syntax

1 element.getHeadingLevel(): Promise<null | 1 | 2 | 3 | 4 | 5 | 6>

Returns

Promis<level>: Number - 1 | 2 | 3 | 4 | 5 | 6

A Promise that resolves to the value of the heading level.

Example

1 const selectedElement = await webflow.getSelectedElement()
2 
3 if (selectedElement?.type === 'Heading'){
4 
5   const headingLevel = await selectedElement.getHeadingLevel()
6   console.log(headingLevel)
7 
8 } else {
9   console.log("Selected Element is not a Heading Element")
10 }

Designer Ability

Checks for authorization only

Designer Ability	Locale	Branch	Workflow	Sitemode
canAccessCanvas	Any	Any	Any	Any

`element.setHeadingLevel(level)`

Set the heading level of a heading element.

Syntax

1 element.setHeadingLevel(level: 1 | 2 | 3 | 4 | 5 | 6): Promise<null>

Parameters

level: Number - 1 | 2 | 3 | 4 | 5 | 6

Returns

Promise<null>

A Promise that resolves to null

1 const selectedElement = await webflow.getSelectedElement()
2 
3 if (selectedElement?.type === 'Heading'){
4 
5   const headingLevel = await selectedElement.setHeadingLevel(1)
6   console.log(headingLevel)
7 
8 } else {
9   console.log("Selected Element is not a Heading Element")
10 }

Designer Ability

Designer Ability	Locale	Branch	Workflow	Sitemode
canEdit	Any	Any	Canvas	Any

1	const selectedElement = await webflow.getSelectedElement()
2
3	if (selectedElement?.type === 'Heading'){
4
5	const headingLevel = await selectedElement.getHeadingLevel()
6	console.log(headingLevel)
7
8	} else {
9	console.log("Selected Element is not a Heading Element")
10	}