# Media library (/docs/core/editing/media)



# Media library [#media-library]

The media library is where your images live. You can drag files in, convert them to WebP automatically, and drop them into the right folder, all without leaving Atlas.

<ThemeImage name="media" alt="The media library" />

## Uploading an image [#uploading-an-image]

You can upload from two places:

* From the **media library**, drag a file in or click to browse.
* From the **editor**, upload an image and Atlas inserts the Markdown at your cursor.

Either way, the file is saved into your `mediaDir` and is ready to use right away.

<ThemeImage name="upload-modal" alt="The upload image dialog" />

## Automatic WebP conversion [#automatic-webp-conversion]

When you upload a PNG or JPEG, Atlas can convert it to **WebP** for you, which keeps your docs light. You choose the quality, and 90% is a good default that is hard to tell apart from the original.

The conversion happens in your browser before the file is saved, so you do not need any extra tools installed.

## Folders [#folders]

Images can be organized into folders, and the upload dialog lets you pick one. Start typing to filter your existing folders, or type a brand-new path like `services/logos` to create it on the spot.

<Callout type="info">
  Leave the folder empty to save into the root of your `mediaDir`. Atlas creates nested folders as needed, so you never have to make them by hand first.
</Callout>

## Finding and reusing images [#finding-and-reusing-images]

The library shows every image with its folder, and you can search by name to narrow it down.

Click an image to open a **full preview** with its details beside it. From there, hit **Copy as component** to copy the image as a ready-to-paste component, then drop it into any page. You can also delete the image from the same preview.

## Next steps [#next-steps]

<Cards>
  <Card title="Scaffold pages from templates" href="/docs/core/content/templates" />

  <Card title="Audit your SEO" href="/docs/core/maintenance/seo" />
</Cards>
