> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# TextBundle

> Import TextBundle and TextPack files into Craft with images and attachments.

TextBundle is an open file format designed to make text documents with embedded images and attachments portable across different applications. Craft supports importing both TextBundle (`.textbundle`) and TextPack (`.textpack`) files, preserving your content structure, formatting, and media.

## What is TextBundle?

TextBundle packages a Markdown file together with its associated media files (images, attachments) into a single bundle. This makes it easy to move documents between apps without losing embedded content or dealing with broken image links.

**Key features:**

* Markdown-based content with metadata
* Embedded images and attachments stay together
* Preserves document structure and formatting
* Widely supported across note-taking apps

## Importing TextBundle Files

<Tabs>
  <Tab title="macOS & iOS">
    <Steps>
      <Step>
        Open Craft and navigate to **All Documents**, **Organize**, or **Unsorted** view
      </Step>

      <Step>
        Click or tap the three-dot menu (⋯) in the upper right corner
      </Step>

      <Step>
        Select **Import** from the Import / Export section
      </Step>

      <Step>
        Choose your TextBundle or TextPack file
      </Step>
    </Steps>

    <img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/import-and-export/import/textbundle/en/content/import-menu.png?fit=max&auto=format&n=bXGV3J9qfsAQZqJz&q=85&s=c97b316deb97f685d8bc0d6e9524758c" alt="Import menu showing import option" width="1303" height="849" data-path="images/import-and-export/import/textbundle/en/content/import-menu.png" />

    Craft will create a new document with your content, including all embedded images and attachments in their original locations within the text.
  </Tab>

  <Tab title="Web">
    <Warning title="Web Limitation">
      The web application currently supports importing individual Markdown files only. TextBundle import is not available on the web version. Use the desktop or mobile apps to import TextBundle files.
    </Warning>
  </Tab>
</Tabs>

## What Gets Imported

When you import a TextBundle file, Craft preserves:

* **Text content** – All Markdown formatting converts to Craft blocks
* **Headings and structure** – Document hierarchy maintained
* **Images** – Embedded images appear in the correct locations
* **Attachments** – Files included in the bundle are imported
* **Links** – Both internal and external links preserved

## Import Limitations

To ensure reliable performance, Craft has built-in limits for importing:

* **Maximum 1,000 files** per import operation
* **Large bundles** may take longer to process
* **Unsupported Markdown features** may not convert perfectly

<Info title="Batch Imports">
  If you need to import more than 1,000 files, split them into smaller batches and import separately.
</Info>

## After Importing

Once imported, your TextBundle content becomes native Craft documents. You can:

* Edit and format using Craft's full feature set
* Add new blocks, pages, and media
* Organize into folders and collections
* Share or publish your documents

## Related Topics

<CardGroup cols={2}>
  <Card title="Import Overview" href="/en/import-and-export/import">
    Learn about all import options in Craft
  </Card>

  <Card title="Export Options" href="/en/import-and-export/export">
    Learn how to export your Craft documents
  </Card>
</CardGroup>