microCMSではコンテンツとは別にメディア（ファイル）をアップロードし、管理することができます。

メディアのアップロード方法

管理画面でのメディアのアップロードには、2通りの方法がございます。
いずれの方法も、単一のファイルだけでなく、複数のファイルをアップロードすることも可能です。
なお、アップロードできるメディアの種類につきましては、ヘルプ記事「アップロードできるメディアの種類を教えて」をご覧ください。

「アップロード」ボタンからアップロードする方法

メディア管理画面右上の「アップロード」ボタンをクリックすると、ファイル選択ダイアログが開くので、そちらからファイルをアップロードできます。

ドラッグアンドドロップでアップロードする方法

メディア管理画面中央の領域にメディアをドラッグアンドドロップしてアップロードができます。

配信方式

CDNを経由して配信されます。

メディアの形式

メディアはアップロード時にMIMEタイプにて「画像」 or 「ファイル（画像以外のメディア）」のいずれの形式か判定が行われます。

配信URL

メディアの形式によって配信されるドメインが下記の例のように異なります。

• 画像：https://images.microcms-assets.io/assets/xxxx/yyyy/{fileName}.png
• ファイル：https://files.microcms-assets.io/assets/xxxx/yyyy/{fileName}.pdf

なお、メディアのURL内に含まれる値は以下のようなルールとなっています。

• 「xxxx」の部分：サービスごとに固有のランダムな値
• 「yyyy」の部分：メディアごとにランダムな値（都度生成されるので、同じファイルをアップロードした場合も異なる値となります）

利用可能なフィールド

メディアの形式によって利用可能なフィールドが異なります。

• 画像：画像フィールド、複数画像フィールド、リッチエディタ、旧リッチエディタ、ファイルフィールド
• ファイル：ファイルフィールド

メディアの公開範囲

メディアはアップロードされた時点で「公開状態」となります。
すなわち、メディアのURLを知っていれば、microCMSのサービスのメンバーでなくともメディアにはアクセス可能となります。

メディアの情報

アップロードされたメディアを選択すると、画面右側でメディアの情報を確認することができます。

• ファイル名：メディアのファイル名です。表示されるURLに関係します。リンクをクリックすると、別タブでオリジナルデータを確認できます。
• 作成日時：メディアがアップロードされた日付が入ります。
• 形式：メディアの種別と拡張子が入ります。
• 容量：メディアのファイルサイズが入ります。
• 画像サイズ（画像のみ）：画像の縦 × 横の大きさが入ります。
• 作成者：メディアをアップロードしたメンバー名が入ります（後から任意のメンバーに変更可能）。
• コンテンツ参照：メディアを参照しているコンテンツ情報が入ります。
• 代替テキスト：imgタグのalt属性に含める代替テキストが設定できます。
• タグ：メディアに紐づけられたタグ情報が設定できます。

コンテンツ参照の確認

メディアを参照しているコンテンツがある場合、以下のように「◯件の参照」と表記されます。



「◯件の参照」のリンクをクリックすると、メディアを参照しているコンテンツ一覧が表示されます。なお、表示されるコンテンツは、自身に読み取り権限のあるメディアに限ります。

各コンテンツのリンクをクリックすると、該当コンテンツの編集ページへと移動します。

ファイル名のリネーム

メディアはアップロード後、任意のファイル名に変更することが可能です。
まず、メディアのファイル名の右側にある鉛筆マークをクリックします。



ファイル名の編集モーダルが表示するので、変更先のファイル名を入力してください。「変更する」をクリックすると、変更が完了します。

作成者の変更

メディアの作成者は、サービス内の他のメンバーに変更することができます。
まずメディアの作成者の表示箇所をクリックします。



モーダルが表示されるので、変更先のメンバーを選択してください。「変更する」をクリックすると、変更が完了します。

代替テキストの設定

メディアはアップロード後、任意の代替テキストを設定することが可能です。
設定した文字列は、APIのレスポンスやWebhookのペイロードにおいて、imgタグのalt属性として、出力されます（画像にのみ設定可能です）。

まず代替テキストの横の鉛筆マークをクリックします。



任意の文字列を設定後、［設定を完了する］を押下すると、変更が完了します。

メディアの削除

個別削除

削除したいメディアを選択し、右側のメニュー下部にある「削除」ボタンをクリックすると削除できます。

全件削除

「メディア設定」→「全メディアの削除」から、「◯◯サービスの全メディアを削除」ボタンをクリックすることで、全メディアを削除することができます。

削除条件

誤削除防止のため、メディアを削除するためには、コンテンツからの参照が1件も無い状態とする必要があります。
メディアを削除する場合は、コンテンツからの参照をすべて外し、参照が0件になった状態で、削除を実施してください。

メディアの再アップロード

メディアはアップロード後、任意のメディアを再アップロードして上書きすることが可能です。
本機能のユースケースとして、コンテンツから参照されているメディアを差し替えたいなどの場合にお使いいただけます。

再アップロードの手順

まず、再アップロードしたいメディアを選択し、右側のメニュー下部にある「再アップロード」ボタンをクリックします。



すると、ファイル選択ダイアログが開くので、任意のメディアを選択します。
「更新前のメディアファイルは削除されます。更新しますか？」という確認ダイアログが開くので、「OK」をクリックすると、メディアのアップロードが開始し、上書きされます。

画像APIプレビュー

画像タイプのメディアについては、画像APIを適用した場合のプレビューを確認することができます。

まず、選択したメディアの右上にある「画像APIプレビュー」のボタンをクリックします。



すると、各種画像APIを適用した場合のプレビューが表示されます（?w=300, ?fit=crop&w=200&h=200 など）。

その他の機能

メディア管理画面ではそのほかに下記のような機能がございます。機能の詳細は各ドキュメントページをご参照ください。