> 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/public-assets.md).

# Public Assets

Public assets are permanent links to files in your cloud account, on your own website. On the Public Assets page you see these links, choose how each file is delivered, and revoke links at any time.

A public asset is created when you:

* insert a cloud reference via the [Media Library integration](https://wpcloudplugins.gitbook.io/docs/features/media-library.md), or
* click **Create cloud reference** on the Public Assets page.

{% hint style="info" %}
Shared links that are created by plugin modules are not listed on this page.
{% endhint %}

**The Public Assets page**

Open it in the plugin menu via **Public Assets**. The table shows:

| Column        | What it shows                                                                                         |
| ------------- | ----------------------------------------------------------------------------------------------------- |
| Account icon  | The linked cloud account. Hover over it for the name and email address                                |
| **File**      | The name and location of the file                                                                     |
| **Added in**  | The post or page in which the link was created. This does not change when you edit that content later |
| **Delivery**  | How the file reaches visitors. Click the icon to change it                                            |
| **Status**    | Active or Revoked                                                                                     |
| **Views**     | How many times the link was used                                                                      |
| **Last used** | When the link was last used                                                                           |
| **Created**   | The date, and who created the link                                                                    |

Use the **⋮** menu of a row to:

* **Copy link to open or play**, for example to place it in a page or email.
* **Copy download link**, which downloads the file instead of opening it.
* **Open in …**, which opens the file at your cloud service. You need to be signed in there with access to the file.
* **Revoke** or **Reactivate** the link.
* **Delete** the link. The file in your cloud account is not deleted.

Select several rows with the checkboxes to revoke or delete them together.

<figure><img src="https://2349993602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeoKE343SM9nA0iXUOWZ1%2Fuploads%2FBZidUBQsdaAvasZyGMI6%2Fpads.png?alt=media&amp;token=85a03c3a-0271-4eb9-953e-ecba1c1012f3" alt=""><figcaption></figcaption></figure>

**Delivery**

Every link is delivered in one of two ways. You can change this at any time: the link itself stays the same.

|                                 | Via your cloud service | Via your website |
| ------------------------------- | ---------------------- | ---------------- |
| **Who sends the file**          | The cloud service      | Your server      |
| **Bandwidth of your server**    | Almost none            | All of it        |
| **Visitors see the cloud link** | Yes                    | No               |
| **Other websites can show it**  | Yes                    | No               |

What happens via the cloud differs per service:

| Service                     | How it works                                                                                                                                                                                                               |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Google Drive**            | The file is shared with anyone who has the link. Images use the Google Drive thumbnail service, in the **Image Width** you set. Video, audio and other files of 50 MB and larger always play or download via your website. |
| **Dropbox**                 | The file gets a Dropbox shared link. Images up to 10 MB can be kept on your server after the first view for performance.                                                                                                   |
| **OneDrive and SharePoint** | Visitors get a temporary link. The file is not shared.                                                                                                                                                                     |
| **Box**                     | Visitors get a temporary link and the file is not shared. Every view uses a Box API call. Images up to 10 MB can be kept on your server after the first view for performance.                                              |

{% hint style="warning" %}
**Sharing stays active.** When you change a file to **Via your website**, or revoke its link, a sharing link at Google Drive or Dropbox keeps working until you remove it there. Use **Open in …** to go to the file.
{% endhint %}

**Revoking and deleting**

* **Revoke** stops the link right away. You can reactivate it later.
* **Delete** removes the link for good.
* When you permanently delete a post, its links are revoked, unless the link is still used in another post. Moving a post to the trash changes nothing.
* The links run through this plugin. They stop working when you deactivate it.

**Settings**

Go to plugin settings → **Advanced** → **Public Assets**:

* **Default Delivery:** the delivery that is preselected for new cloud references, and that is used for users who can't choose.
* **Image Width** (Google Drive): the width of images delivered via the thumbnail service.
* **Keep a copy of public images on your server** (Dropbox and Box): after the first view your server delivers images up to 10 MB itself, so they load faster. A new version of a file can take up to two hours to appear everywhere.

Who can manage the page is set under plugin settings → **Permissions** → **Manage Public Assets**. Administrators by default.

**The address of the links**

Links look like `https://example.com/cloud/g/...`, with `cloud/g` for Google Drive, `cloud/d` for Dropbox, `cloud/o` for OneDrive and `cloud/b` for Box. You can change this under **Settings → Permalinks**.

{% hint style="danger" %}
Changing the address stops the links that are already used in your content from working.
{% endhint %}

**A link doesn't work?**

* **Via your website and shown on another site:** that's intended. Other websites can't show these files. Opening the link directly does work.
* **Status is Revoked:** reactivate the link on the Public Assets page.
* **The file was deleted or moved to the trash** in your cloud account, or **the cloud account is no longer linked:** the link can't deliver the file anymore.
* **Google Drive files go via your website although you chose Google Drive:** the file can't be shared. Check **Manage Sharing Permission** and **Preferred Download Method** in the plugin settings, and whether your Google Workspace blocks sharing outside your organization.
