How files work
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.
What a file is
Section titled “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
Section titled “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
Section titled “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.
- Viber and WhatsApp messages: Browse next to the image field, and for each WhatsApp carousel card. See How Viber messages work and 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.
- 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.
- 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 and 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
Section titled “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.