---
updatedAt: 2025-09-04T18:39:27.000Z
agentTools:
  projectIndex: https://developer.clickup.com/llms.txt
---

# Docs API limitation

Learn about the limitations of the Docs endpoints.

The <Glossary>Docs</Glossary> API has some formatting limitations compared to the product that are important to be aware of when [importing or exporting Docs.](https://developer.clickup.com/reference/getpage)

# Text

The following elements are supported by plain and markdown text when importing or exporting <Glossary>Docs</Glossary>.

<Table>
  <thead>
    <tr>
      <th>
        Element
      </th>

      <th>
        Plain and markdown text support
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Normal text
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        Heading 1
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        Heading 2
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        Heading 3
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        Heading 4
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        Alignment
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Bulleted List
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        Numbered List
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        Toggle List
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        <Glossary>Checklist</Glossary>
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Banner
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Code Block
      </td>

      <td>
        Yes, but code formatting is lost
      </td>
    </tr>

    <tr>
      <td>
        Quote
      </td>

      <td>
        Yes
      </td>
    </tr>
  </tbody>
</Table>

# Inline

Inline elements are not supported by plain or markdown text when importing or exporting <Glossary>Docs</Glossary>.

# Views

Views are not supported by plain and markdown text when importing or exporting <Glossary>Docs</Glossary>.

# Embeds

The following embed elements are supported by plain and markdown text when importing or exporting <Glossary>Docs</Glossary>:

<Table>
  <thead>
    <tr>
      <th>
        Element
      </th>

      <th>
        Plain and markdown text support
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        YouTube
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Vimeo
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Loom
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Miro
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Giphy
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Google Drive
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Google Slides
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Google Docs
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Google Sheets
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        <Glossary>Attachment</Glossary>
      </td>

      <td>
        Yes, but sizing is not retained
      </td>
    </tr>

    <tr>
      <td>
        Embed a task
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Embed a Doc
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Embed a Whiteboard
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        Embed org chart
      </td>

      <td>
        No
      </td>
    </tr>
  </tbody>
</Table>

# Formatting

The following formatting elements are supported by plain and markdown text when importing or exporting <Glossary>Docs</Glossary>:

| Element       | Plain and markdown text support |
| ------------- | ------------------------------- |
| Bold          | Yes                             |
| Italic        | Yes                             |
| Underline     | No                              |
| Strikethrough | Yes                             |
| Indent        | No                              |
| Inline code   | Yes                             |
| Website link  | Yes                             |

# Advanced blocks

The following advanced block elements are supported by plain and markdown text when importing or exporting <Glossary>Docs</Glossary>:

| Element                  | Plain and markdown text support            |
| ------------------------ | ------------------------------------------ |
| Synced content           | No                                         |
| Columns                  | No                                         |
| Divider                  | Yes                                        |
| Button                   | Yes, but it turns into an unformatted link |
| Table of contents        | No                                         |
| Table                    | Yes, but it loses formatting               |
| Sticky table of contents | No                                         |
| New slide                | No                                         |

# Text colors, background colors, and badges

Text colors, background colors, and badges are not supported by plain and markdown text when importing or exporting <Glossary>Docs</Glossary>.

# Covers, icons, comments, page styles, and wikis

Covers, icons, comments, page styles, and wikis are not supported by plain and markdown text when importing or exporting <Glossary>Docs</Glossary>.