# How files work

> What Assets › Files stores, which image and document formats you can upload, what a file's links are, where the channels pick files from, and what deleting a file does.

**Assets › Files** is the place where Releva keeps the images and documents your messages and ads use. You upload a file once, Releva hosts it and gives it a public link, and every channel that needs a picture can pick it from the same list. This page explains what a file is, how uploading works and where files are used. To upload, find, edit or delete one, follow [Upload a file and use it in your messages](https://releva.ai/documentation/guides/assets/upload-a-file-and-use-it-in-your-messages/).

## What a file is

Every file belongs to one shop (domain) and has:

| Field           | What it is                                                                                                                                     |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | Required. Unique within the shop: saving a second file with the same name fails with “Name must be unique!”. Shown on the card and searchable. |
| **Description** | Required. Shown on the card and searchable. Use it for the words you will search for later, such as the campaign or the product line.          |
| File            | The uploaded image or document. It cannot be replaced after upload.                                                                            |
| URL             | The public link to the file. **Copy URL** on the card copies it.                                                                               |
| Thumbnail URL   | Images only: a PNG copy scaled to 200 pixels wide, made at upload. **Copy Thumbnail** copies it. Documents show a file-type icon instead.      |

Files are listed newest first on two tabs. **Images** lists JPG, PNG and GIF files; **Documents** lists PDF, Word, Excel and plain-text files. The search box above the tabs matches the start of a word in the name or the description, ignoring case, and refreshes the list as you type. Switching tabs keeps the search.

The links are public: anyone with a link can open the file, which is what lets email clients, browsers and messaging apps load it. Do not upload anything you would not put on your website.

## Upload a file

Select **New image** on the **Images** tab or **New document** on the **Documents** tab. The form has **Name** (preset to “New file”), **Description** (preset to “New description”) and a file field, **Upload File to import**. **Save** stays disabled until both text fields have a value. On success you are back on the list and the new file is first.

What you can upload:

| Tab           | Accepted                                                                                       | Not accepted                                                                                                                                                                                                                                                                                                             |
| ------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Images**    | JPG, JPEG, PNG, GIF, up to 5 MB. The hint under the field says “png” and “jpg”; GIF works too. | SVG and BMP are rejected: an SVG upload fails with “File type .svg is not allowed. Allowed: .jpg, .jpeg, .png, .gif, .webp, .ico”. Despite that list, WebP and ICO do not work either: a WebP upload fails with a validation error because only JPG, PNG and GIF are stored, and an ICO file is ignored. Use JPG or PNG. |
| **Documents** | PDF, DOC, DOCX, XLS, XLSX, TXT.                                                                | CSV, PPT, PPTX, ZIP and everything else.                                                                                                                                                                                                                                                                                 |

For images Releva stores the original and makes the 200 px thumbnail. For documents there is no thumbnail; the card shows a PDF, Word, spreadsheet or text icon. An image over 5 MB is stopped before upload with “Image size is too big. Maximum allowed size is 5MB.”

If you select **Save** on an image without choosing a file, or with a file that is not an image, nothing happens and no message is shown. On a document the form says “No file selected.” or “File is not a supported document format.” Choose a file of an accepted type and save again.

## Where files are used

Files are picked, not re-uploaded, in these places:

* **Push notifications**: **Browse** next to **Icon URL** and **Image URL** opens the **Pick Image** dialog. See [Create a web push notification](https://releva.ai/documentation/guides/push-notifications/create-a-web-push-notification/).
* **Viber** and **WhatsApp** messages: **Browse** next to the image field, and for each WhatsApp carousel card. See [How Viber messages work](https://releva.ai/documentation/learn/viber/how-viber-messages-work/) and [How WhatsApp messages work](https://releva.ai/documentation/learn/whatsapp/how-whatsapp-messages-work/).
* **Facebook ads**: the ad image can be picked from Files or uploaded on the spot; an upload from there also lands in Files. See [How Facebook Ads work](https://releva.ai/documentation/learn/facebook-ads/how-facebook-ads-work/).
* **Banners in the Releva builder**: every image field has **Choose from the library**, which picks a file from Files, and **Upload an image**, which uploads a new file and adds it to Files. See [How banners work](https://releva.ai/documentation/learn/banner-blocks/how-banners-work/).
* **Emails**, and **banners** in the HTML editor: **Show Images** in the email form and **View Images** in the banner form open a side list; selecting a card copies the image URL to paste into the editor. See [How emails work](https://releva.ai/documentation/learn/emails/how-emails-work/) and [How banners work](https://releva.ai/documentation/learn/banner-blocks/how-banners-work/).

The **Pick Image** dialog has its own search box and shows **Title**, **Description**, **Date Created** and **Date Updated** for each file. It lists documents as well as images, so name your files so you can tell them apart. Some pickers also offer **Link URL (Optional)**, the page the image should link to.

SMS messages carry no images, so Files are not used there.

Images made in AI Hub are stored here as well and show up on the **Images** tab.

## Delete a file

**Delete** on a file’s edit page asks **Are you sure?** with “This action cannot be undone!”. **Confirm** removes the record and the stored file and thumbnail. A link that was already pasted into a sent email, a live push notification or an ad stops working, because the file behind it is gone. Before you delete, replace the link in every place that uses it, or keep the file.

Changing a file’s name or description does not change its link.

## Next steps

* [Upload a file and use it in your messages](https://releva.ai/documentation/guides/assets/upload-a-file-and-use-it-in-your-messages/): Upload an image and copy its link for an email or push notification.
* [How push notifications work](https://releva.ai/documentation/learn/push-notifications/how-push-notifications-work/): Learn how icons and images appear in a push notification.