Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 43 additions & 10 deletions docs/manual/メディア管理.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ CDNを経由して配信されます。
なお、メディアのURL内に含まれる値は以下のようなルールとなっています。

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

利用可能なフィールド
----------
Expand All @@ -66,7 +66,7 @@ CDNを経由して配信されます。

ファイルフィールドに登録されたメディアは、メディアの形式に関わらず配信ドメインは `"files.microcms-assets.io"` となります。

上記に記載されているフィールド以外にも、直接メディアのURLをコピーし、その他のフィールド内で利用することは可能です。例として、ヘルプ記事の「[リッチエディタでPDFなどのファイルを利用するには?](https://help.microcms.io/ja/knowledge/use-files-in-rich-editor)」をご参照ください。
上記に記載されているフィールド以外にも、直接メディアのURLをコピーし、その他のフィールド内で利用することは可能です。

メディアの公開範囲
=========
Expand Down Expand Up @@ -135,7 +135,22 @@ CDNを経由して配信されます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/4d8b43da418748768fbae600c561a245/CleanShot%202024-02-02%20at%202%E2%80%AF.43.27%402x.png)

用途としては、[メディアの読み取り権限](/manual/roles#hb76587122e)に「このロールのメンバーが作成したメディアのみ」を設定している場合に活用することができます。
作成者の一括変更
--------

メディアを複数選択して、作成者を一括変更できます。
作成者を変更したいメディアにチェックを入れ、「◯件を選択中」をクリックします。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/dfd748c21cef447c839ad80dc7a84e71/CleanShot%202025-08-28%20at%2010.30.30.png)
「作成者を変更する」をクリックします。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/58edd102dd6b437e970bc0876a2f1f8e/CleanShot%202025-08-28%20at%2010.29.27.png)

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

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/73b20573fe574487baed7cf4a5d7b79c/CleanShot%202025-08-28%20at%2010.31.36.png)

メディア作成者変更は、[メディアの読み取り権限](/manual/roles#hb76587122e)に「このロールのメンバーが作成したメディアのみ」を設定している場合に活用できます。

作成者が読み取り範囲の設定の要素となるため、範囲の変更のために利用します。

Expand Down Expand Up @@ -168,11 +183,11 @@ CDNを経由して配信されます。

削除したいメディアにチェックを入れ、「◯件を選択中」をクリックします。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/da98c755c8f948b7b4e921c576226c6e/CleanShot%202025-05-14%20at%2015.06.07.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/dfae1dfaec59456fad11593f29064cf0/CleanShot%202025-08-28%20at%2010.30.30.png)

「メディアを削除する」をクリックすると、選択したメディアを削除できます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/11e7884e53774625ab09dc7113f94958/CleanShot%202025-05-14%20at%2015.08.09.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/e2f2397978d649feb740abe0aa83e19a/CleanShot%202025-08-28%20at%2010.29.28.png)

全件削除
----
Expand All @@ -197,18 +212,29 @@ CDNを経由して配信されます。
メディアはアップロード後、任意のメディアを再アップロードして上書きすることが可能です。
本機能のユースケースとして、**コンテンツから参照されているメディアを差し替えたい**などの場合にお使いいただけます。

### 再アップロードの手順
再アップロードの手順
----------

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

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/86bee7606f0c41228938bf5bb19d5c8a/CleanShot%202023-09-12%20at%2011.22.20%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/76431f003e67450f839e38524af20aeb/CleanShot%202025-11-04%20at%2015.23.54.png)

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

ブラウザにキャッシュが残っている場合など、再アップロード直後は元のメディアが表示されることがあります。

* 再アップロードを行うと、設定済みの代替テキストはリセットされます。再アップロードしたファイル内容に応じて、再設定してください。
* デフォルトの再アップロードでは、ファイル名を含むメディアのURLは変更されません。異なるファイル名のメディアを再アップロードした場合でも、元のファイル名が維持されます。

### 新しいURLで差し替える場合

デフォルトでは、メディアのURLは維持されたまま再アップロードされます。
URLを変更した上でメディアを差し替える従来の再アップロードを利用したい場合は、「新しいURLで差し替え」をクリックします。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/96b7ce53b1b34184ba016bd69dd01320/CleanShot%202023-09-12%20at%2011.27.53%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/08621470b17046f0bffd81f8e79b7bf7/CleanShot%202025-11-04%20at%2015.25.55.png)

* メディアを再アップロードすると、配信されるメディアのURLも変更され、再アップロード前のURLでのアクセスができなくなります。メディアのURLを直接利用している場合、リンク切れになる可能性があります。
* 「新しいURLで差し替え」を使ってメディアを再アップロードすると、配信されるメディアのURLも変更され、再アップロード前のURLでのアクセスができなくなります。メディアのURLを直接利用している場合、リンク切れになる可能性があります。
* SSG構成の場合、再ビルドを行うまでの間に、再アップロード前のURLが無効になり、リンク切れになる可能性があります。

画像APIプレビュー
Expand All @@ -226,6 +252,13 @@ CDNを経由して配信されます。

プレビューで確認できるパラメータはあくまで一部ですので、画像APIで利用可能なパラメータなどの詳細についてはドキュメントの「[画像APIとは](https://document.microcms.io/image-api/introduction)」をご参照ください。

Amazon S3連携
===========

Amazon S3連携とは、microCMSの管理画面からアップロードされた画像や動画といったメディアの保存先を、microCMSのデフォルトのストレージから、お客様が独自に用意したAmazon S3のバケットに切り替えられる機能です。

メディアの配信URLが変更されたり、画像APIの利用ができなくなるなど、ご利用にあたり仕様の変更点がございますので、詳細については[ドキュメント](/manual/amazon-s3-integration)をご確認ください。

その他の機能
======

Expand Down