---
title: "Canvas element"
summary: "Renders as a link to a canvas."
url: "https://docs.slack.dev/reference/block-kit/block-elements/canvas-element"
type: "reference"
subtype: "block-kit"
available_in_surfaces:
  - "Modals"
  - "Messages"
  - "Home tabs"
works_with_blocks:
  - "Rich text"
---

Source: https://docs.slack.dev/reference/block-kit/block-elements/canvas-element

# Canvas element

This is a rich text element, compatible only with the [`rich_text`](https://docs.slack.dev/reference/block-kit/blocks/rich-text-block.md) block. It must be used within the [`rich_text_list`](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-list-element.md), [`rich_text_quote`](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-quote-element.md), or [`rich_text_section`](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-section-element.md) block element within the `rich_text` block's `elements` array.

## Fields {#fields}

Field

Type

Description

Required?

`type`

String

The type of object; in this case, "canvas".

Required

`file_id`

String

The ID of the canvas to link to.

Required

`label`

String

What the canvas is labeled.

Optional

`hide_title`

Boolean

Whether the title should be hidden.

Optional

`section_id`

String

The section ID.

Optional

`style`

Object

An object of optional boolean properties that dictate style: `bold`, `italic`, `strike`, `highlight`, `client_highlight`, `underline`, and `unlink`.

Optional

`text`

String

Title of the canvas.

Optional

`url`

String

URL of the canvas.

Optional

`is_skill_invocation`

Boolean

True when this canvas element was inserted as a skill invocation.

Optional

## Example {#example}

*   JSON

```
{    "blocks": [        {            "type": "rich_text",            "elements": [                {                    "type": "rich_text_section",                    "elements": [                        {                            "type": "canvas",                            "file_id": "F123ABC456"                        }                    ]                }            ]        }    ]}
```

[View in Block Kit Builder](https://app.slack.com/block-kit-builder/E7T5PNK3P/builder#%7B%22blocks%22:%5B%7B%22type%22:%22rich_text%22,%22elements%22:%5B%7B%22type%22:%22rich_text_section%22,%22elements%22:%5B%7B%22type%22:%22canvas%22,%22file_id%22:%22F123ABC456%22%7D%5D%7D%5D%7D%5D%7D)