In microCMS, you can upload and manage media (files) separately from your content.
There are two ways to upload media in the management screen.
In either method, it is possible to upload multiple files as well as a single file.
For information on the types of media that can be uploaded, please refer to the help article "What types of media can be uploaded?".
Click the "Upload" button in the upper right corner of the media management screen, and a file selection dialog will open, allowing you to upload files from there.
You can upload media by dragging and dropping it into the central area of the media management screen.
You can also upload media via the API (some conditions apply).
For more details, please check POST /api/v1/media.
When uploading multiple files, there is no specific limit on the quantity. However, when uploading a large number of files, there is a possibility that errors may occur. In that case, please try uploading in smaller batches.
It is delivered via CDN.
The media is determined to be either Image or File (non-image media) based on the MIME type at the time of upload.
The domain from which the media is delivered varies depending on the media format, as shown in the examples below.
https://images.microcms-assets.io/assets/xxxx/yyyy/{fileName}.pnghttps://files.microcms-assets.io/assets/xxxx/yyyy/{fileName}.pdfAdditionally, the values contained in the media URL follow the rules below.
The available fields vary depending on the media type.
The media registered in the file field will have the delivery domain of "files.microcms-assets.io", regardless of the media format.
In addition to the fields mentioned above, it is also possible to directly copy the media URL and use it in other fields.
Media becomes "public" at the moment of upload.
In other words, if you know the media URL, it can be accessed even by those who are not members of the microCMS service.
When referencing media from published websites or web applications, there is a possibility that the media information included on the page may also be indexed by search engines.
By selecting the uploaded media, you can view the media information on the right side of the screen.
If there is content that references the media, it will be indicated as "◯ references" as shown below.
Clicking the "◯ references" link will display a list of content that references the media. Note that the displayed content is limited to media for which you have read permissions.
Clicking the link for each content will take you to the edit page for that content.
As a known issue, there may be cases where reference information for content is displayed even though there is no content referencing the media. If this occurs, please contact the support team via the chat section located at the bottom right of the management screen.
After uploading, you can change the media file name to any desired name.
First, click the pencil icon located to the right of the media file name.
A file name editing modal will appear, so please enter the new file name. Click "Change" to complete the modification.
The creator of the media can be changed to another member within the service.
First, click on the display area of the media creator.
A modal will appear, so please select the member to change to. Click "Change" to complete the change.
You can select multiple media items and change the creator in bulk.
Check the media items for which you want to change the creator and click on "◯ items selected".
Click on "Change Creator".
A modal will appear, so please select the member to change to. Click "Change" to complete the change.
The change of media creator can be utilized when the media read permission is set to "Only media created by members of this role."
Since the creator is a factor in the read range settings, it is used to change the range.
After uploading media, you can set any alternative text.
The string you set will be output as the alt attribute of the img tag in the API response and Webhook payload (this can only be set for images).
First, click the pencil icon next to the alternative text.
After setting your desired string, press [Complete Settings] to finish the changes.
Select the media you want to delete and click the "Delete" button at the bottom of the right-side menu to delete it.
Check the media you want to delete and click on "◯ items selected".
Click "Delete Media" to delete the selected media.
From "Media Settings" → "Delete All Media", you can delete all media by clicking the "Delete all media for ◯◯ service" button.
To prevent accidental deletion, you must ensure that there are no references from any content before deleting media.
When deleting media, please remove all references from the content, and perform the deletion only when the reference count is zero.
For handling cases where reference information exists and cannot be deleted despite not being referenced in the content, please refer to the help article "There are "X references" linked to unreferenced media, and I cannot delete it. What should I do?".
After uploading, you can re-upload any media to overwrite it.
This feature can be used in cases such as when you want to replace media referenced in the content.
First, select the media you want to re-upload and click the "Re-upload" button at the bottom of the right-side menu.
Then, a file selection dialog will open, allowing you to choose any media.
A confirmation dialog will appear stating, "You are about to overwrite the media with the same URL. Do you want to continue uploading?" Click "OK" to start the media upload, which will overwrite the existing media.
If there is a cache remaining in the browser, the original media may be displayed immediately after re-uploading.
By default, the media URL will remain unchanged when re-uploaded.
If you want to use the traditional re-upload method to replace the media with a changed URL, click on "Replace with a New URL".
For media of the image type, you can check the preview when applying the Image API.
First, click the "Image API Preview" button located at the top right of the selected media.
Then, a preview will be displayed showing the results of applying various image APIs (such as ?w=300, ?fit=crop&w=200&h=200, etc.).
The parameters that can be checked in the preview are only a part of the available options. For details on parameters that can be used with the image API, please refer to the document titled "What is the Image API".
Amazon S3 Integration is a feature that allows you to switch the storage destination of media such as images and videos uploaded from the microCMS management screen from the default microCMS storage to an Amazon S3 bucket that you have prepared.
There are changes in specifications that may affect your usage, such as changes to the media distribution URL or the inability to use the image API, so please check the documentation for details.
In the media management screen, there are additional features as listed below. For details on each feature, please refer to the respective documentation pages.
