> ## Documentation Index
> Fetch the complete documentation index at: https://developers.smarterservices.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Heading

> A block that displays a heading with a specified level

## Basic Example

```json theme={null}
{
  "type": "heading",
  "level": 1,
  "text": "Sample headingblock content",
  "margin": "sample-margin",
  "textAlign": "left"
}
```

## Live Example

<iframe src="https://app.smarterservices.com/elements/blockkit/renderer?data=eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0.eyJibG9ja3NKc29uIjoiW3tcInR5cGVcIjpcImhlYWRpbmdcIixcImxldmVsXCI6MixcInRleHRcIjpcIkNvdXJzZSBPdmVydmlld1wiLFwibWFyZ2luXCI6XCJtZWRpdW1cIn0se1widHlwZVwiOlwidGV4dFwiLFwidGV4dFwiOlwiVGhpcyBjb21wcmVoZW5zaXZlIGNvdXJzZSB3aWxsIGd1aWRlIHlvdSB0aHJvdWdoIHRoZSBmdW5kYW1lbnRhbHMgb2Ygd2ViIGRldmVsb3BtZW50LlwiLFwiYXNcIjpcInBcIn1dIn0." width="100%" height="200" class="elements-example" />

```json Example Code expandable theme={null}
[
  {
    "type": "heading",
    "level": 2,
    "text": "Course Overview",
    "margin": "medium"
  },
  {
    "type": "text",
    "text": "This comprehensive course will guide you through the fundamentals of web development.",
    "as": "p"
  }
]
```

## Properties

<ParamField path="type" type="string" required="true">
  Identifies this as a heading block

  Must be <code>heading</code>
</ParamField>

<ParamField path="level" type="integer" required="true">
  The heading level (1-6)

  **Allowed values:** `1`, `2`, `3`, `4`, `5`, `6`
</ParamField>

<ParamField path="text" type="string" required="true">
  The text content of the heading
</ParamField>

<ParamField path="margin" type="string" required="false">
  Optional margin setting for the heading
</ParamField>

<ParamField path="textAlign" type="string" required="false">
  Text alignment for the heading

  **Allowed values:** `left`, `center`, `right`
</ParamField>

## Usage Notes

* This element is part of the BlockKit system for building dynamic user interfaces
* All properties marked as **(required)** must be included in your JSON structure
* Optional properties can be omitted and will use their default values when applicable