> ## 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.

# Files and Links

> Attach files, create links, and embed rich link previews in your documents.

Craft lets you attach files and create rich link previews that make your documents more informative and visually appealing.

## File Attachments

You can upload any type of document to a Craft document – Word files, PDFs, Excel spreadsheets, and more.

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/files-and-links/en/content/file-attachment.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=00ef6cda178a485f3931f083ba86defd" alt="File attachment block" width="1494" height="890" data-path="images/write-and-edit/files-and-links/en/content/file-attachment.png" />

### Opening Files

<Tabs>
  <Tab title="macOS/iOS">
    Editable documents such as Word, PDF, or Excel files can be opened directly from the Craft app. Files open in their respective applications.
  </Tab>

  <Tab title="Web">
    Files open in a separate tab in your browser.
  </Tab>

  <Tab title="Windows">
    It is currently not possible to open document files from the Craft Windows app.
  </Tab>
</Tabs>

<Warning title="Important">
  Craft will not save any changes made to a document you open from the app. To preserve edits, save the edited document on your device after making changes.
</Warning>

## Links

Craft provides powerful link handling with automatic rich previews and customization options.

### Automatic Rich Links

When you paste a link into an empty block, Craft automatically creates a rich link with a thumbnail, title, and description.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/files-and-links/en/content/link-auto-rich.gif?s=0d3b85e702fb153dbfce8f402add53c8" alt="Automatic rich link creation" width="800" height="338" data-path="images/write-and-edit/files-and-links/en/content/link-auto-rich.gif" />

### Link Layouts

Change the visual appearance of rich links using the **...** menu. Choose from three layouts:

* **Small** – Compact preview
* **Regular** – Standard size with thumbnail
* **Card** – Full-width card layout

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/files-and-links/en/content/link-layout.gif?s=a1c100a80ac3f9c9391a23ca4e93488e" alt="Changing link layout" width="800" height="356" data-path="images/write-and-edit/files-and-links/en/content/link-layout.gif" />

### Customizing Links

Edit the title and description of rich links to make them more relevant to your content. Use the **...** menu to customize these fields.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/files-and-links/en/content/link-customize.gif?s=2f8d5540abaad97c0e3a42889e9b48ef" alt="Customizing link text" width="800" height="294" data-path="images/write-and-edit/files-and-links/en/content/link-customize.gif" />

To reset a rich link to its original title and description, select **Reload Link Info** from the **...** menu.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/files-and-links/en/content/link-reload.gif?s=3d523f24d4d1e1b93d7bb3ccf230de44" alt="Reloading link information" width="800" height="324" data-path="images/write-and-edit/files-and-links/en/content/link-reload.gif" />

### Preventing Rich Links

If you prefer plain text links, you can prevent Craft from automatically creating rich links:

* Insert the link in the middle of a sentence
* Hit space before pasting the link in an empty block
* Convert a rich link to text using the **...** menu

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/files-and-links/en/content/link-prevent-rich.gif?s=d56bb4d0b366376e6dba2ca95cc10866" alt="Preventing automatic rich links" width="800" height="274" data-path="images/write-and-edit/files-and-links/en/content/link-prevent-rich.gif" />

### Creating Text Links

Paste a link into highlighted text using `Cmd+V` (macOS) or `Ctrl+V` (Windows) to instantly turn it into an inline link.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/files-and-links/en/content/link-text.gif?s=759868b0fa9bc62d9785e8bac1553462" alt="Creating text links" width="800" height="196" data-path="images/write-and-edit/files-and-links/en/content/link-text.gif" />

### Link Color Customization

Change the color of text links by navigating to **Account → Preferences → Appearance → Interface Color Accent**.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/files-and-links/en/content/link-color.gif?s=c9285b350574060ec3b04131746f2f1e" alt="Customizing link colors" width="642" height="800" data-path="images/write-and-edit/files-and-links/en/content/link-color.gif" />

<Info title="Platform Note">
  Craft for Windows does not currently create rich links automatically. Links appear as standard text links.
</Info>

## Converting Between Link Types

You can easily convert between rich links and text links:

* **Rich to text**: Use the **...** menu and select **Change to Text Link**
* **Text to rich**: Right-click on a plain link and select **Change to Preview Link**

<Warning title="Requirement">
  To convert a text link to a rich preview, the link must be placed without any other text in a paragraph. This feature is currently only available on macOS.
</Warning>