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

# Image and PDF Support

> Use AI to summarize, extract text from, and ask questions about images and PDF attachments.

Craft's AI Assistant can help you understand, summarize, and describe **images and PDFs** directly inside your documents. When you hover over supported content, you'll see quick action buttons that let you interact with it instantly.

<Check title="New in v3.3.5">
  Image and PDF OCR support was added in version 3.3.5, making it easy to extract text, generate captions, and create alt text for accessibility.
</Check>

## PDF Support

The AI Assistant can read and interpret PDF files attached to your documents using the **Max** model.

**What you can do with PDFs:**

* Generate summaries of entire documents
* Ask questions about the content
* Extract key points or insights
* Pull out specific information

This is especially useful for:

* Research papers and articles
* Reports and whitepapers
* Documentation and manuals
* Meeting notes and presentations

## Image Support

The AI Assistant works especially well with images and provides fast results for visual content.

### Supported image formats

* PNG
* JPG
* JPEG
* GIF
* WEBP

<Warning title="HEIC Not Supported">
  HEIC images are currently not supported. Convert HEIC files to JPG or PNG before using with the Assistant.
</Warning>

### What you can do with images

* **Generate captions** – Create descriptive captions for your images
* **Get summaries** – Understand what the image shows
* **Create detailed descriptions** – Generate thorough interpretations
* **Improve accessibility** – Generate alt text for screen readers
* **Extract text** – Pull text from screenshots or photos of documents

**Use cases:**

* Documentation and guides
* Meeting whiteboards and diagrams
* Screenshots of UI or designs
* Charts and graphs
* Accessibility compliance (alt text generation)

## Using OCR features

<Steps>
  <Step>
    Add an image or PDF to your document.
  </Step>

  <Step>
    Hover over the image or PDF block.
  </Step>

  <Step>
    Click the Assistant quick action button that appears.
  </Step>

  <Step>
    Choose what you want to do: generate caption, summarize, extract text, or ask a custom question.
  </Step>
</Steps>

The Assistant will process the content and provide results instantly.

## Code blocks

In addition to images and PDFs, the AI Assistant can also help with **code blocks**:

* Explain what code does
* Help debug issues
* Clarify logic or structure
* Suggest improvements

This makes Craft a powerful tool for technical documentation and development notes.

## Tips for best results

**For images:**

* Use clear, high-resolution images when possible
* Ensure text in images is legible
* Crop out unnecessary content for more focused results

**For PDFs:**

* Make sure you're using the **Max** model (other models don't support file attachments)
* Smaller PDFs process faster
* Well-formatted PDFs with clear text work best
* Consider splitting very large PDFs into sections

**For code:**

* Include context about what the code should do
* Specify the programming language if not obvious
* Ask specific questions for better answers

## Related Articles

<CardGroup cols={2}>
  <Card title="Using Craft Assistant" href="/en/ai-assistant/using">
    Learn the basics of working with the Assistant
  </Card>

  <Card title="Custom Prompts" href="/en/ai-assistant/custom-prompts">
    Create reusable prompts for consistent image descriptions
  </Card>

  <Card title="Choosing AI Models" href="/en/ai-assistant/models">
    Select the right model for processing images and PDFs
  </Card>

  <Card title="Media in Documents" href="/en/write-and-edit/media">
    Learn how to add and manage images and files
  </Card>

  <Card title="Code Blocks" href="/en/write-and-edit/code">
    Get AI help with code analysis and debugging
  </Card>
</CardGroup>