リンクの問題を解決する
PDFをリソースにリンクする際の、よくある問題と対処法をまとめました。
リンク時にリソースが見つからない
検索がうまくいかない:
- 名前は一部だけでOKです（全文は不要）
- 大文字/小文字は区別しません
- リソース名の別のキーワードでも試してください
リソースが存在しない:
- Shopify側で商品/ページ/コレクションが存在するか確認してください
- 下書き（draft）ではなく公開（published）されているか確認してください
- アーカイブされたリソースは表示されません
リソースタイプの選択が間違っている:
- 正しいタイプ（Products / Pages など）を選んでいるか確認してください
- ドロップダウンでタイプを切り替えてください
リンクできたはずなのにPDFが表示されない
表示に必要な3点の確認:
- ✅ PDFがリンクされている（ここはOK）
- ⚠️ PDFステータスが Active（要確認）
- ⚠️ Theme App Extension がテーマに追加されている（要確認）
PDFをリンク解除できない
リンクが残って見える:
- ページを再読み込みしてください
- 実際に解除できているか確認してください
- もう一度解除を試してください
一括解除（bulk unlink）が失敗する:
- 1件ずつ解除してみてください
- 権限（permissions）を確認してください
- 解決しない場合はサポートに連絡してください
間違ったPDFがリソースにリンクされている
リンクを修正する:
- 間違ったPDFをリンク解除します
- 正しいPDFをリンクします
- ステータスが Active か確認します
- ストアフロントで表示を確認します
複数PDFがリンクされている:
- 複数PDFがリン クされていないか確認します
- 不要なPDFをリンク解除します
- 必要なPDFだけを残します
一括リンクがうまくいかない
リソース数が多すぎる:
- 小さな単位（25〜50件程度）に分けて試してください
- 大規模な処理は時間がかかります
- バックグラウンド処理の完了を待ってください
リソースが選択されていない:
- チェックボックスがオンになっているか確認してください
- 最低1つはリソースを選択してください
- 確定前に選択内容を見直してください
処理がタイムアウトする:
- 非常に大きい一括処理はタイムアウトすることがあります
- 小さな単位に分けてください
- 混雑しにくい時間帯に再試行してください
リンク数の表示が正しくない
キャッシュ反映の遅延:
- リンク数の更新は数分おきの場合があります
- ページを再読み込みして少し待ってください
- 自動的に更新されます
すべてのリソースタイプを含む:
- 表示される数は、全リソース合計のリンク数です
- 1つのPDFが Products と Pages の両方にリンクされることもあります
- これは正常です
ホームページ/検索ページにリンクできない
リンク手順が少し違う:
- Homepage / Search は検索が不要です
- リソースタイプを選んで Link を押すだけです
- ストアあたりそれぞれ1つだけ存在します
すでにリンクされている:
- すでにリンク済みではないか確認してください
- 付け直したい場合はいったん解除してください
- 1つのPDFは、同一リソースには1回リンクされます
テンプレートフィルタで表示されない
フィルタが厳しすぎる可能性:
- テンプレート名が正しいか確認してください
- ページがそのテ ンプレートを使っているか確認してください
- いったんフィルタを外して表示されるかテストしてください
テンプレートが存在しない:
- テーマコード側でテンプレート名を確認してください
- テンプレート名は大文字/小文字を区別します
- まずフィルタなしで試してください
更新後にリンクが消えた
PDFを削除した:
- PDFを削除すると、すべてのリンクが解除されます
- 削除は取り消せません
- 再アップロードした場合は再リンクが必要です
誤ってリンク解除した:
- PDFライブラリでリンク状態を確認してください
- 必要に応じて再度 Link PDF を行ってください
- 複数リソースなら一括リンクが便利です
特定の商品にリンクできない
商品が次の状態の可能性:
- Archived（先に再有効化してください）
- Draft（先に公開してください）
- Deleted（削除済み商品にはリンクできません）
商品が存在するか確認:
- Shopify 管理画面で検索してください
- 分かる場合は商品IDも確認してください
- 公開状態になっているか確認してください
一括リンクの対象を間違えた
一括操作を取り消す:
- 同じPDFを選択します
- 一括解除（bulk unlink）を使います
- 同じリソースを選択します
- すべて解除します
ミスを防ぐ:
- 確定前に選択内容を見直す
- まず2〜3件でテストする
- フィルタで候補を絞る
- 最終確定前にプレビューを確認する
「リンク上限に達した」と出る
リンク数の上限はありません:
- 1つのPDFを無制限にリンクできます
- 1つのリソースに無制限にPDFをリンクできます
- このエラーは通常発生しません
プランのPDF数上限の可能性:
- PDF数がプラン 上限に達していないか確認してください
- プラン変更、またはPDF削除が必要な場合があります
- リンク数自体は無制限です
リンクをうまく進めるコツ
検索を工夫する:
- 部分一致で検索する
- 別のキーワードで試す
- （利用可能なら）タイプでフィルタする
保存/確定前に確認する:
- リソース名を確認する
- リソースタイプを確認する
- （使っている場合）テンプレートフィルタも確認する
まず1件でテストする:
- まず1つのリソースにリンクする
- ストアフロントで動作確認する
- 問題なければ一括操作に進む
整理して運用する:
- PDF名を分かりやすくする
- 命名ルールを揃える
- どのPDFをどこに置くかメモしておく