WordPressは長年にわたって多くのサイトを支えてきたCMSですが、最近はより軽量で高速なサイトを求めて、別のCMSへの乗り換えを検討する方も増えています。そうした選択肢のひとつが、Astroをベースにした新しいCMS「EmDash」です。EmDashにはWordPressからの移行機能が標準で備わっているため、記事や固定ページ、カテゴリー、画像などを、管理画面からまとめて取り込むことができます。

この記事では、EmDashの公式ドキュメントをもとに、WordPressからEmDashへ移行する手順を、準備から公開の切り替えまで順を追って解説します。

移行を始める前に準備すること

移行作業に入る前に、まずは万一に備えた準備を整えておきましょう。具体的には、次のものを用意します。

WordPressのバックアップ：データベースと wp-content/uploads フォルダの両方をバックアップしておきます。
EmDashのサイト：画像も移行する場合は、メディアを保存するストレージをあらかじめ設定しておく必要があります。
EmDashの管理者アカウント：インポートには import:execute という権限が必要です。
WordPressのデータ：WXRファイル（WordPressのエクスポートファイル）か、WordPressにインストールした「EmDash Exporter」プラグインのどちらかを用意します。

あわせて、現在のパーマリンク構造やリダイレクトの設定、メニュー、使用している投稿タイプやタクソノミー、プラグインが管理している独自のフィールドなどを記録しておくと安心です。というのも、これらは移行後に「以前と同じように動いているか」を確認する際のチェックリストになるからです。

2つの移行方法から選ぶ

EmDashへの移行方法は、大きく分けて2つあります。どちらを選ぶかによって移行できるデータの範囲が変わるので、それぞれの特徴を押さえておきましょう。

方法1：WXRファイルをアップロードする

ひとつ目は、WordPressの標準機能で書き出したWXRファイルをアップロードする方法です。WordPressの管理画面で ツール → エクスポート を開き、「すべてのコンテンツ」を選んでXMLファイルをダウンロードするだけなので、プラグインを追加できない環境でも利用できます。

この方法では、投稿、固定ページ、カスタム投稿タイプ、カテゴリーやタグ、再利用ブロック、投稿者、添付ファイルのURLなどを移行できます。ただし、WXRファイルに含まれているのは画像のURLだけで、画像そのものは含まれていません。そのため、画像の取り込みが終わるまでは、WordPressのサイトを公開したままにしておく必要があります。

方法2：EmDash Exporterプラグインで接続する

ふたつ目は、WordPressに「EmDash Exporter」プラグインをインストールし、EmDashから直接接続する方法です。自分でWordPressを管理していてプラグインを追加できる場合は、こちらの方法がおすすめです。

なぜなら、Exporterを使うと、下書きのように一般には公開されていないコンテンツに加えて、サイトのタイトルやキャッチフレーズ、SEOの設定値なども移行できるからです。さらに、バージョン1.2.0以降のExporterであれば、コメント、メニュー、ロゴ、ファビコンもまとめて移行できます。一方で、それより古いバージョンでは、これらのデータは移行されず、しかも「移行されなかった」という警告も表示されません。そのため、作業を始める前にWordPressの プラグイン 画面でバージョンを確認しておきましょう。

なお、EmDashの画面でWordPressのURLを入力するだけでも、サイトの検出や公開記事数の確認はできます。ただし、この方法ではコンテンツそのものは取り込めないため、実際の移行にはWXRファイルかExporterのどちらかが必要です。

EmDashの管理画面で移行する手順

準備ができたら、いよいよEmDashの管理画面で移行作業を進めます。手順は次のとおりです。

ステップ1：インポート画面を開く

EmDashの管理画面のサイドバーから インポート を選び、「Import from WordPress」の画面を開きます。URLで直接 /_emdash/admin/import/wordpress にアクセスしても開くことができます。

ステップ2：WordPressのデータを読み込む

次に、WXRファイルをアップロードするか、Exporterの移行キーを貼り付けるか、WordPressのURLを入力します。Exporter 1.2.0以降を使っている場合は、WordPressの ツール → EmDash Migration で移行キーを発行できるので、それをEmDashの画面に貼り付けます。また、URLを入力した場合は、WordPressのアプリケーションパスワードの画面でEmDashからの接続を許可します。

ステップ3：分析結果を確認する

データを読み込むと、EmDashがWordPressの内容を分析し、投稿タイプごとに移行先のコレクションを提案してくれます。それぞれの投稿タイプには、次の4つのいずれかの状態が表示されます。

Ready：移行先のコレクションとフィールドがすでに揃っていて、そのまま移行できる状態です。
New collection：移行の準備段階で、新しいコレクションが作成されます。
Add fields：コレクションは存在するものの、足りないフィールドが追加されます。
Incompatible：同じ名前のフィールドが別の型で存在しているため、このままでは移行できません。

「Incompatible」と表示された場合は、移行先のコレクションを変更するか、Content Types の画面でフィールドを調整してから進めます。というのも、EmDashの移行機能は足りないフィールドを追加することはあっても、既存のフィールドの型を書き換えることはないからです。

ステップ4：投稿者を割り当てる

続いて、WordPressの投稿者をEmDashのユーザーに割り当てます。割り当てなかった投稿者は「ゲスト署名（byline）」として登録されるので、ログインアカウントを発行しなくても、記事の執筆者名はきちんと表示されます。

ステップ5：移行する追加データを選ぶ

Exporterで接続している場合は、メニュー、サイトのタイトルとキャッチフレーズ、ロゴとファビコン、SEOの設定値を移行するかどうかを選べます。なお、これらの選択肢はWXRファイルで移行する場合には表示されません。

ステップ6：インポートを実行する

設定が終わったら、インポートを実行します。EmDashは、まず必要なコレクションやフィールドを作成し、そのあとで記事などのコンテンツを登録していきます。このとき、WordPressのブロックエディタ（Gutenberg）で書かれた本文は、EmDashの「Portable Text」という形式に自動で変換されます。

ステップ7：画像などのメディアを取り込む

最後に、添付ファイルが見つかった場合はメディアの取り込みを実行します。EmDashはWordPressから画像を1点ずつダウンロードして自身のストレージに保存し、さらに本文中の画像URLも新しいURLに自動で書き換えてくれます。

また、同じ内容の画像はファイルの中身で判定されるため、途中で失敗して再実行しても、同じ画像が重複して登録されることはありません。

公開ステータスの扱いに注意する

移行の際に見落としやすいのが、記事の公開ステータスです。WordPressで「公開済み」だった記事は、EmDashでもそのまま公開済みになります。その一方で、下書き、レビュー待ち、非公開、予約投稿、ゴミ箱の記事は、すべて「下書き」として取り込まれます。

つまり、予約投稿や非公開といった細かな状態までは引き継がれないということです。したがって、こうした記事は移行後に内容を確認し、必要に応じて公開の設定をし直してください。

公開を切り替える前に確認すること

移行が完了しても、すぐにドメインを切り替えたり、WordPressを削除したりするのは避けましょう。まずは新しいサイトが正しく動いているかを、次のポイントで確認します。

投稿タイプごと、ステータスごとの記事数がWordPressと一致しているか
ブロックエディタ、クラシックエディタ、ショートコード、ページビルダーで作った記事が正しく表示されるか
アイキャッチ画像や本文中の画像が、EmDashのURLから読み込まれているか
投稿者、カテゴリー、タグ、カスタムタクソノミー、翻訳が正しく引き継がれているか
メニュー、コメント、サイト情報、SEOの設定が反映されているか（Exporterで移行した場合）
以前のURLにアクセスしたとき、変更になったページへ正しくリダイレクトされるか
下書きの記事が、ログインしていない人から見えていないか

なかでも、URLのリダイレクトはSEOに大きく関わるポイントです。EmDashには Redirects という管理画面があり、古いURLから新しいURLへの301リダイレクトを設定できます。さらに、404エラーになったURLの記録も確認できるので、公開後もしばらくはこの画面をチェックし、取りこぼしたURLにリダイレクトを追加していくとよいでしょう。

そして、新しいサイトが本番環境で問題なく動くことを確認できるまでは、WordPressのサイトとバックアップを残しておいてください。そうしておけば、万が一トラブルが起きたときにも、元の状態にすぐ戻すことができます。

うまくいかないときの対処法

最後に、移行の際によくあるトラブルと、その対処法を紹介します。

XMLファイルが読み込めない

WXRファイルが読み込めない場合は、WordPressの ツール → エクスポート からファイルを書き出し直し、ダウンロードが最後まで完了しているかを確認してください。また、文字コードが変わってしまうおそれがあるため、XMLファイルをテキストエディタなどで編集するのは避けましょう。

Cloudflareのボット対策で接続できない

WordPressのサイトでCloudflareのボット対策を使っていると、EmDashからの接続がブロックされることがあります。その場合は、移行作業のあいだだけ、Exporterの通信と画像フォルダへのアクセスを許可するルールを追加します。

(http.request.uri.path contains "/wp-json/emdash/v1/")
or (http.request.uri.query contains "rest_route=%2Femdash%2Fv1%2F")
or (http.request.uri.path contains "/wp-content/uploads/")

なお、Cloudflareの無料プランの「Bot Fight Mode」はルールで除外できないため、移行中は一時的にオフにし、作業が終わったら元に戻してください。

一部の画像が取り込めない

画像の取り込みに失敗した場合は、その画像のURLにログインせずにアクセスできるか、ファイルが削除されていないかを確認してください。原因を解消したうえでメディアの取り込みを再実行すれば、すでに取り込み済みの画像はそのまま再利用されるので、失敗した分だけを取り込み直すことができます。

まとめ

WordPressからEmDashへの移行は、管理画面の案内に沿って進めれば、記事や画像、カテゴリーなどをまとめて取り込むことができます。ただし、安全に移行するためには、事前のバックアップ、移行方法の選択、そして公開前の確認という3つのポイントを押さえておくことが大切です。

また、移行後はテーマ（デザイン）をAstroのテンプレートとして作り直す必要があります。そのため、WordPressのテーマやプラグインに独自の機能が多いサイトほど、事前に移行の計画をしっかり立てておくことをおすすめします。

株式会社WOWでは、CMSの移行を含むホームページ制作やSEO対策のご相談を承っています。WordPressからの乗り換えを検討されている方は、どうぞお気軽にお問い合わせください。

※この記事は、EmDash公式ドキュメント「Migrate from WordPress」「Content import」の内容（2026年11月時点）をもとに作成しています。