メインコンテンツまでスキップ

表示トラブルを解決する

PDFがストアフロントに表示されないときの、よくある原因と対処法をまとめました。

PDFがまったく表示されない​

次の3点を確認してください:

✅ PDFがリンクされている（商品/ページなどのリソースに）
✅ PDFステータスが Active（Inactive ではない）
✅ Theme App Extension がテーマに追加されている

3つすべてが満たされている必要があります。順番に確認しましょう:

  1. PDFライブラリを開きます
  2. 表示されるはずのPDFをクリックします
  3. 正しいリソースにリンクされているか確認します
  4. ステータスが Active になっているか確認します
  5. テーマエディタで拡張が追加されているか確認します

手動ブロック（PDF Embedded Manual / PDF Button Manual）を使っている場合、リンク済みPDFのチェックは当てはまりません。次の「手動URLブロック」の項目を確認してください。

手動URLブロックが何も表示しない​

  1. 有効な https://...pdf のURLが最低1つ入力されているか確認します
  2. ブロックが、使用中の商品テンプレートに追加されているか確認します
  3. テーマエディタで保存し、ストアフロントを強制リロードします
  4. 切り分けのため、ビューア種類を一時的に Native Browser に切り替えます（Custom Viewer のパラメータ問題を疑う場合）
  5. 手動ボタンラベルを使っている場合、ラベルの行数がURLの行数と一致するか確認します

PDFが違うページに表示される​

よくある原因:

リンク先リソースが間違っている

  • PDFがどのリソースにリンクされているか確認します
  • 間違ったリソースからリンク解除します
  • 正しいリソースにリンクします

テンプレートフィルタの不一致

  • テンプレートフィルタ設定を確認します
  • ページが想定どおりのテンプレートを使っているか確認します
  • テンプレートフィルタを削除または調整します

テンプレートフィルタについて →

表示されるPDFと表示されないPDFがある​

PDFごとのステータスを確認:

  • 表示されないPDFは Inactive になっている可能性があります
  • 表示したいPDFは Active に切り替えてください

テンプレートフィルタを確認:

  • 一部のPDFにテンプレートフィルタが設定されている場合があります
  • 表示されないPDFのフィルタ設定を見直してください

テーマエディタの Apps に拡張が出てこない​

テーマ互換性の問題:

テーマがアプリ拡張（app extensions）に未対応の可能性があります:

  1. テーマのドキュメントでアプリ拡張に対応しているか確認します
  2. テーマを最新バージョンに更新します
  3. テーマ開発者にサポートを依頼します
  4. 拡張対応テーマへの切り替えも検討します

多くの最新 Shopify テーマ（2.0+）は app extensions に対応しています。

PDFの読み込みが遅い​

ファイルサイズを最適化する:

  • アップロード前にPDFを圧縮してください
  • 可能なら 5MB 未満にしてください
  • 不要なページ/画像を削除してください

通信環境を確認する:

  • 回線が遅いと読み込みも遅くなります
  • 別のネットワークでも試してください
  • Wi‑Fi とモバイル回線でも比較してください

ボタン表示を使う:

  • 埋め込みよりボタンの方が速いことが多いです
  • お客様が開いたPDFだけが読み込まれます
  • モバイル向けです

埋め込みビューアが真っ白になる​

PDFが破損している可能性:

  • PDFを再アップロードしてみてください
  • まずPCでPDFを開いて正常に読めるか確認してください
  • 別のソフトでPDFを保存し直してみてください

ブラウザ互換性:

  • 別のブラウザで試してください
  • ブラウザを最新版に更新してください
  • ブラウザキャッシュを削除してください

違うPDFが表示される​

リンク接続を確認する:

  • そのPDFのリンク先リソースを確認します
  • 表示してはいけないページからリンク解除します
  • 各リソースに正しいPDFがリンクされているか確認します

複数PDFがリンクされている:

  • 複数PDFがリンクされていると、基本的にすべて表示されます
  • 不要なPDFはリンク解除してください
  • 必要なら並び順を調整してください

手動ブロックの場合は、リンク先ではなくブロック設定内のURL行を直接確認してください。

PDFボタンを押しても開かない​

JavaScript の問題:

  • ブラウザのコンソールでエラーが出ていないか確認してください
  • 別のブラウザで試してください
  • 競合しそうなアプリ/拡張を一時的に無効化して試してください

テーマの競合:

  • テーマによってはポップアップがブロックされる場合があります
  • テーマ設定を確認してください
  • テーマ開発者に相談してください

テンプレートフィルタが効かない​

よくあるミス:

テンプレート名が違う:

  • テンプレート名は大文字/小文字を区別します
  • スペルを注意深く確認してください
  • テーマ内にそのテンプレートが存在するか確認してください

テンプレートが適用されていない:

  • 別のテンプレートが適用されている可能性があります
  • テーマエディタで実際のテンプレートを確認してください
  • 正しいテンプレートをページに割り当ててください

テンプレートの問題を確認 →

変更が反映されない​

キャッシュの反映遅延:

  • 変更後、30〜60秒待ってください
  • ページを再読み込みしてください（強制リロード: Cmd/Ctrl + Shift + R）
  • 必要に応じてブラウザキャッシュを削除してください

テーマが保存されていない:

  • テーマエディタで Save をクリックしたか確認してください
  • 未保存の変更がある表示が出ていないか確認してください

それでも解決しない場合​

次の手順も試してください:

  1. 一度すべて更新する:

    • ブラウザを強制リロードする
    • テーマエディタで再度保存する
    • 数分待つ

  2. シークレット/プライベートモードで試す:

    • 新しいブラウザセッションで確認できます
    • キャッシュの影響を避けられます
    • ブラウザ拡張の影響を切り分けできます

  3. 別のページで確認する:

    • 別のリソース（別の商品/ページ）でも確認する
    • ホームページと商品ページなどで比較する
    • どこで問題が起きているか切り分ける

  4. サポートに連絡する:

    • 期待している表示と、実際に見えている表示を説明する
    • 可能であればスクリーンショットを共有する
    • テーマ名を伝える
    • プラン名（またはプラン種別）を添える

次のステップ​