# Media
Tip
- In
Modyo 9, this space is called File Manager. If you migrate from Modyo 9 to Modyo 10, all assets are preserved, and are moved to the default media space.
This space allows you to upload, organize, and manage your files in a simple and efficient way.
In Media, you can assign editing and deleting permissions to images through groups. This way, a group can have permissions to view and use assets, but it cannot modify or delete them. Different types of media can be uploaded to this space, considering the following size restrictions per file:
- Images: 6 MB
- Videos: 10 MB
- Audios: 10 MB
- Files: 10 MB
Allowed file types are:
- Images: apng, avif, bmp, gif, ico, jpeg, jpg, png, svg, tif, tiff, webp
- Videos: av, avi, f4v, flv, mkv, mov, mp4, mpeg, webm, wmv
- Audios: 3gp, aac, alac, dsd, flac, mp3, pcm, wav, m4a, ogg, wma
- Files: 7z, ai, apk, css, csv, doc, docx, fon, ico, iso, jar, js, msi, ods, odt, otf, pdf, ppt, pptx, rar, rss, rtf, scss, tar, tex, ttf, txt, vcf, wdp, xhtml, xls, xlsm, xlsx, xml, zip, one, ecf, pub, xps, json, svg, woff, woff2, ics
Attention
The svg format depends on an account setting. The Allow use of SVG box, under Settings > Security, is disabled by default, and while it stays that way any attempt to upload or update an SVG file is rejected with the message Can't upload or update SVG files due to configured security policies. Before enabling it, review SVG images, because it has security implications.
Modyo also checks the file name: it cannot contain more than one dot, so a name like styles.min.css is rejected with the message shouldn't include dots. In addition, when saving, every character that is not an unaccented letter, a number, or a hyphen is replaced with an underscore, so Presentación final.pdf is stored as Presentaci_n_final.pdf.
Attention
Since Modyo 10.2, in addition to the extension and the size, Modyo checks that the file's actual content type matches its extension. If they do not match, the upload fails and the panel shows the file name next to the message content type does not match the file's extension. The check applies to the four media types, both in the panel and through the admin API, so a PNG renamed to .jpg or a CSV renamed to .xlsx can no longer be uploaded. If you run into this error, rename the file with its real extension or export it again in the format you need.
# File libraries
Files aren't stored in a single library. Each space, site, and realm has its own library, and the account has one more. A space's Media section only manages that space's library, although the percentage of used space it shows takes into account the files of the whole account.
When you insert or attach a file from an editor, the file selector opens the library of the place where you're working: in an entry, the space's library; in a site's templates, pages, and widgets, the site's library; and in a realm's forms, originations, and email templates, the realm's library. Whatever you upload from the selector stays in that library: a file you upload from a site or a realm doesn't show up in the Media section of any space.
To use a file from another library, choose the type of library (space, site, realm, or account) in the selector's Context filter and, except for the account, choose the library in the filter that appears next to it. The filter only offers the library types of the modules you have access to, plus the account, which is always available.
# About the Interface
The interface shows you a list of the files in the library of the space you are in.
In the upper right part of the screen, you can see the percentage of used space corresponding to the total allocated for the account and the button to upload new files.
Modyo displays 30 files per page. At the bottom, you can navigate between the file pages and, when there are more than 30, show 60 or 100 per page.
You can filter the content by:
- Asset Type: Filter by Images, Video, Documents, or Audio.
- Author: Filter by the name of the user who uploaded the content.
- Tags: Shows all files associated with a tag.
- Search bar: Type a word to display the files whose name, or the name of the user who uploaded them, contains that word. It doesn't search the title, description, alt text, or tags; for tags, use the Tags filter.
Tags allow you to organize and group your files. To modify the tags of more than one file, select the files you want and click on the Add or remove tags button that appears at the bottom of the list.
In this view, the columns are:
- Preview: If the platform identifies that the file is an image, you can view a thumbnail image of the file. If it is not, the space appears blank.
- File name: Name of the file and its extension. The sorting is alphabetical.
- Type: File type and extension. The sorting is alphabetical, first by type and then by the name of the extension.
- Size: Size of the file, in the appropriate unit (Bytes, KB, MB, etc.).
- Created at: Date of upload or creation within the platform, regardless of whether the file was created on a different date on another service.
- Author: Name of the user who uploaded the file, only when the user has a name assigned.
# Upload a file
To upload a file to Modyo, choose one of the following options:
# From the section where you're working, templates, pages, realms, or sites:
- Open the text editor,
- In the top bar, select insert image to open a modal where you can drag or upload a file.
The file stays in that section's library. See File libraries.
# In the dedicated section for managing files.
- In the side menu, click on the Content icon.
- Select a space.
- In the side menu, click Media.
- Click on the New Asset button.
- Drag the file or click the upload box to open a search window.
- Add tags to the file if you want.
- Click Upload to confirm.
Tip
Modyo allows you to upload 10 files at a time. If you need to upload more items, repeat the process.
# Edit a File
In the file interface, click on the name of a file to open the file properties editing interface and see:
- Asset URL: Shows the public URL of the file. Click on the icon next to the URL to copy it. It is not modifiable.
- Liquid tag: Shows the liquid tag of the file. Click on the icon to copy and use it in the platform's content. It is not modifiable.
- Title: Shows the title of the image, up to 255 characters. It is different from the file name, which cannot be changed. Only for images.
- Alt text: Shows the alt text of the image, up to 255 characters. Only for images.
- Description: Description of the element. We recommend writing a short text referring to the image.
- Tags: Shows the tags associated with the file. You can search for and add more tags, as well as delete existing tags.
Click Update information to confirm the changes or Close to cancel them.
# Re-upload an Image
To upload a new file while keeping the original name and link, follow these steps:
- Click on the name of a file to open the property editing interface.
- Click on the upload button above the image.
- Select a new file.
- Confirm that you want to replace the old file.
The replacement is applied as soon as you confirm: the window closes and the page reloads, without going through Update information. If you had changed other fields in the window without saving them, those changes are lost.
Attention
The new file keeps the original's name and extension, so it must have the same format. If it doesn't, for example a PNG replacing a .jpg, the replacement is rejected with an error stating that the content type does not match the file's extension, and the previous file is kept.
You can't replace an image you edited with the image editor: the upload button doesn't appear until you restore the original.
# Edit an Image
The Modyo image editor allows you to make small changes to images to facilitate their management on the platform. To adjust the dimensions of an image, follow these steps:
- Click on the name of a file to open the property editing interface.
- Click on the edit icon above the image.
- Choose the option you want to edit the size:
- 16:9
- Square
- Free: Edit the image to a custom size in pixels, adjustable at the bottom of the screen.
- Click Apply.
The editor isn't available for SVG or ICO images. You also can't edit an image that was already edited: the edit icon stays disabled until you restore the original.
Tip
You can change the view and crop of the image in two ways:
- Zoom: Use the mouse scroll to zoom in on the image.
- Move background: Double-click outside the cropping area and drag the background.
To restore the file, open the property editing window again and click on Restore Original, which only appears on edited images. This permanently removes the modifications made.
# Resize an image
In Modyo, you can dynamically resize an image, which allows you to modify the image size without losing quality and ensure it fits the screen of your users' devices. This resizing is done with Liquid code, in the work area where you inserted the image.
Important
We recommend always using the Liquid tag of an image to include it in your content and not the asset URL. This way, any changes you make to the image will be reflected wherever the image is used.
To resize an image, you must first copy the Liquid code to render the image. To do this:
- Click on content.
- Select the space where the image you want to modify is located.
- Click on Media.
- Click on the image.
- Click on the copy icon, next to the Liquid tag of the image.
Once you have the Liquid code of the image, access the work area where you want to insert the image, whether in templates, pages, or widgets, and follow these steps:
- Paste the Liquid code. It should look something like this:
{{ 'ec0a3e4-ccdb-48c5-87be-5e1eca560dee' | asset_image }} - Add to the filter the parameters you need. The ones available by default are
width,height,quality,blur,fitandformat, pluswidths,sizesandstylefor responsive images. You can follow any of these formats:
asset_image: width: XXXwhere XXX is the desired pixel size.asset_image: quality: XXwhere XX is the desired percentage of quality.asset_image: width: 800, quality: 80, widths: '300, 600, 900', sizes: '(min-width: 400px) 298px, 78.75vw'adapting the values according to your needs to ensure that the image fits the different screens and resolutions of your user's devices, using the srcset (opens new window) attribute for responsive support.
- Click save.
- Click on publish.
Tip
When resizing images, the original aspect ratio is preserved, so the image is adjusted proportionally, without distortion.
If you only include the height or width of the image, the missing value is automatically calculated to maintain the correct aspect ratio of the image.
Attention
The asset_image options depend on CDN image processing being enabled on the platform; it isn't a setting of your account. If it isn't enabled, the filter publishes the original image and silently ignores all of them: there is no error or notice, just an image at its original size. If the size doesn't change no matter how you adjust the values, ask through the Modyo Support Center (opens new window).
sizes and style are only emitted when you also pass widths, and only width, quality, blur and height are propagated to each srcset variant. The full filter reference is in Asset image.
# Delete a File
To delete a file, follow these steps:
- Click on the name of a file to open the property editing interface.
- Click Delete, below the image.
Attention
This action is irreversible. If the file is linked to content, you will not be able to recover it, and it will appear as a broken link.
← Categories API →