---
title: Adding Images to Your Content
framework: docc
role: article
role_heading: Article
path: docc/adding-images
---

# Adding Images to Your Content

Elevate your content’s visual appeal by adding images.

## Overview

Overview DocC extends Markdown’s image support so you can provide appearance and display scale-aware versions of an image. You use specific components to create image filenames, and DocC uses the most appropriate version of the image when displaying your documentation.

|   |   |   |   |  tip: To best support your readers, provide images in standard resolution and @2x scale. For example, the following are all valid DocC image filenames: important: Include the image files in your documentation catalog. For more information, see Documenting a Swift Framework or Package. To add an image, use an exclamation mark (!), a set of brackets ([]), and a set of parentheses (()). Within the brackets, add a description of the image. This text, otherwise known as alternative text, is used by screen readers for people who have vision difficulties. Provide enough detail to describe the image so that people can understand what the image shows. Within the parentheses, include only the image name. Omit the appearance, display scale, and file extension components. Don’t include the path to the image. ![A sloth hanging off a tree.](sloth)

## See Also

### Structure and Formatting

- [Formatting Your Documentation Content](docc/formatting-your-documentation-content.md)
- [Adding Tables of Data](docc/adding-tables-of-data.md)
- [Other Formatting Options](docc/other-formatting-options.md)
- [Adding Structure to Your Documentation Pages](docc/adding-structure-to-your-documentation-pages.md)
- [Customizing the Appearance of Your Documentation Pages](docc/customizing-the-appearance-of-your-documentation-pages.md)