WordPress関連

メディアライブラリへの大量画像登録が遅い…プラグインよりWP-CLIが速かった

2026-08-01

WordPressサイトの移行やFTPで大量の画像をアップロードした際、「サーバーには画像があるのに、メディアライブラリに表示されない」という経験はありませんか？

このような場合は、Media Sync などのプラグインを使えば、uploads フォルダ内の画像をメディアライブラリへ登録できます。しかし、画像が数百枚〜数千枚規模になると、登録が完了するまでに時間がかかることがあります。

私も実際の案件で、FTPで大量の画像をアップロードしたあと、プラグインを使ってメディアライブラリへ登録していました。しかし、画像数が多かったこともあり、登録が完了するまでかなりの時間がかかりました。

もっと効率的な方法はないか調べた結果、たどり着いたのが WP-CLI です。

WP-CLIはブラウザを介さずコマンドラインからWordPressを操作できるため、大量の画像でも短時間でメディアライブラリへ登録できます。現在では、同様の案件では必ずWP-CLIを利用しています。

前提条件

本記事は、WP-CLIが利用できる環境を前提としています。

例えば、以下のような環境であれば、そのまま手順を進められます。

Local の Open Site Shell
SSHで接続できるレンタルサーバー

なお、WP-CLIの導入方法や初期設定については、本記事では扱いません。
Localを利用している方は、ボタン1つで利用できてオススメです。

WP-CLIでメディアライブラリへ登録する手順

対象

wp-content/uploads に画像をコピー済み
メディアライブラリへ登録したい

1. WP-CLIが利用できるターミナルを開く

まずはWP-CLIのコマンドを実行できるターミナルを開きます。

例

Local：Open Site Shell
SSH接続したサーバー

2. フォルダ内の画像を確認

2026年6月の場合

dir wp-content\uploads\2026\06

画像が存在することを確認します。

3. まずは1枚だけ登録する

いきなり一括登録するのではなく、まずは1枚だけテストします。

wp media import "wp-content/uploads/2026/06/1-01.jpg" --skip-copy

成功すると次のように表示されます。

Imported file '...' as attachment ID xxx.
Success: Imported 1 of 1 items.

WordPress管理画面の

メディア → ライブラリ

を開き、画像が登録されていることを確認してください。

4. 問題なければ一括登録

for %f in ("wp-content\uploads\2026\06\*.*") do @echo %~nxf | findstr /R /V "\-[0-9][0-9]*x[0-9][0-9]*\." >nul && wp media import "wp-content/uploads/2026/06/%~nxf" --skip-copy

※ 2026\06 2026/06 の部分は対象の年月へ変更してください。

このコマンドのポイント

このコマンドでは、

-300x300
-768x512

など、WordPressが自動生成したサムネイル画像を除外しています。

もし除外しなければ、

元画像
サムネイル
中サイズ
大サイズ

などがすべてメディアライブラリへ登録されてしまいます。

そのため、このコマンドではオリジナル画像のみを登録できるようにしています。

登録後の確認

WordPress管理画面の

メディア → ライブラリ

を開き、画像が登録されていることを確認してください。

月が変わる場合

例えば2025年12月なら

for %f in ("wp-content\uploads\2025\12\*.*") do @echo %~nxf | findstr /R /V "\-[0-9][0-9]*x[0-9][0-9]*\." >nul && wp media import "wp-content/uploads/2025/12/%~nxf" --skip-copy<br>

2026年6月なら

for %f in ("wp-content\uploads\2026\06\*.*") do @echo %~nxf | findstr /R /V "\-[0-9][0-9]*x[0-9][0-9]*\." >nul && wp media import "wp-content/uploads/2026/06/%~nxf" --skip-copy

対象フォルダを変更するだけで利用できます。

まとめ

大量の画像をメディアライブラリへ登録する方法はいくつかありますが、画像数が多い場合はプラグインよりもWP-CLIの方が効率的です。

特に、サイト移行やFTPで大量の画像をアップロードしたあとなど、一括登録が必要になる場面では大きな時間短縮につながります。

私も現在は、大量画像を扱う案件ではこの方法を利用しています。

もしプラグインで登録処理が遅くて困っているのであれば、一度WP-CLIを試してみてはいかがでしょうか。