Get HTML tag

`element.getTag()`

Retrieve the HTML tag of an element.

Syntax

1 element.getTag(): Promise<null | BlockElementTag | HeadingTag | ListTag>

This method also returns the binding metadata for Heading elements:

1 // Heading elements only — returns binding metadata when tag is bound to a CMS field
2 element.getTag(options: { bindings: true }): Promise<HeadingTag | BindingValue | null>

Returns

The return type depends on the element type:

Element type	Return type	Valid tag values
`Block`, `Section`, `VFlex`, `HFlex`, `Container`, `Row`, `Column`, `BlockContainer`, `RichText`, `Slot`, `NavbarContainer`, `TabsContent`	`BlockElementTag \| null`	`div`, `header`, `footer`, `nav`, `main`, `section`, `article`, `aside`, `address`, `figure`
`Heading`	`HeadingTag \| null`	`h1`, `h2`, `h3`, `h4`, `h5`, `h6`
`List`	`ListTag \| null`	`ul`, `ol`

Returns null if the element is not found or the tag is not set.

Example

1 const el = await webflow.getSelectedElement();
2 
3 if (el?.type === 'Block') {
4   const tag = await el.getTag(); // BlockElementTag | null
5   console.log(tag); // e.g. 'section'
6 }
7 
8 if (el?.type === 'Heading') {
9   const tag = await el.getTag(); // HeadingTag | null
10   console.log(tag); // e.g. 'h2'
11 }
12 
13 if (el?.type === 'List') {
14   const tag = await el.getTag(); // ListTag | null
15   console.log(tag); // 'ul' or 'ol'
16 }

Designer Ability

Designer Ability	Locale	Branch	Workflow	Sitemode
canAccessCanvas	Any	Any	Any	Any

1	// Heading elements only — returns binding metadata when tag is bound to a CMS field
2	element.getTag(options: { bindings: true }): Promise<HeadingTag \| BindingValue \| null>

1	const el = await webflow.getSelectedElement();
2
3	if (el?.type === 'Block') {
4	const tag = await el.getTag(); // BlockElementTag \| null
5	console.log(tag); // e.g. 'section'
6	}
7
8	if (el?.type === 'Heading') {
9	const tag = await el.getTag(); // HeadingTag \| null
10	console.log(tag); // e.g. 'h2'
11	}
12
13	if (el?.type === 'List') {
14	const tag = await el.getTag(); // ListTag \| null
15	console.log(tag); // 'ul' or 'ol'
16	}