> For the complete documentation index, see [llms.txt](https://wpcloudplugins.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wpcloudplugins.gitbook.io/docs/features/media-library.md).

# Media Library

Add images, videos and audio from your cloud storage directly to your posts and pages, without a plugin module. The files stay in your cloud account, so they take up no storage on your server.

**Where to find it**

Your cloud service appears as a tab in the WordPress media dialog:

* **Block editor:** click **Media Library** in an Image, Video, Audio, File, Cover, Gallery or Playlist block.
* **Classic editor:** click **Add Media**.
* **Media → Library:** use the button at the top of the page to browse your cloud and import files.

<figure><img src="https://2349993602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeoKE343SM9nA0iXUOWZ1%2Fuploads%2FUgEBzdlatcfmFmBydduv%2Fwpcloudplugins-media-library.webp?alt=media&amp;token=b29f9403-0597-4a34-a2e6-1c783525ee89" alt=""><figcaption></figcaption></figure>

**Two ways to add a file**

Select one or more files, then choose what to do:

|                       | Create cloud reference               | Import to Media Library                |
| --------------------- | ------------------------------------ | -------------------------------------- |
| **Where is the file** | Stays in your cloud account          | Copied to your server                  |
| **Server storage**    | None                                 | Same as a normal upload                |
| **The link**          | A permanent link on your own website | A normal Media Library url             |
| **Works for**         | Content of posts and pages           | Everything that uses the Media Library |
| **Manage it**         | On the Public Assets page            | In the Media Library                   |

**Create cloud reference** adds the file to your content. An image becomes an Image block, a video a Video block, audio an Audio block, and any other file a File block with a download link. If you select several files, the first one fills the selected block when it fits, and the others are added as new blocks.

**Featured images and product images**

Featured images, WooCommerce product images and fields such as those of Advanced Custom Fields need a real file in the Media Library. In those places only **Import to Media Library** is available.

**Choose the delivery**

For a cloud reference you choose how the file reaches your visitors:

* **Via your cloud service:** visitors get the file directly from the cloud.
* **Your website:** your server passes the file on, and the cloud link stays hidden.

Move your mouse over the **?** next to the choice to read what it means for your cloud service. See Public Assets for the differences. Set the default under plugin settings → **Advanced** → **Public Assets** → **Default Delivery**.

**Who can use it**

Go to plugin settings → **Permissions**:

* **Use … in the Media Library:** who can browse the cloud in the media dialog. Administrators by default. These users also need the WordPress capability to upload files. They can browse all linked accounts, unless Private Folders are enabled for the back-end.
* [**Manage Public Assets**](https://wpcloudplugins.gitbook.io/docs/features/public-assets.md)**:** who can choose the delivery. Other users get the default delivery.

**Good to know**

* Folders can't be selected; open the folder and select its files.
* SVG files can't be added as a cloud reference. Import them instead.
* HEIC and TIFF images can't be shown by browsers when they are delivered via your website. Choose delivery via your cloud service, or import the file.
* Adding the same file to the same post twice uses the same link. In another post it gets its own link.
