HubSpot CMS のキャッシュをバイパスする hsCacheBuster の使い方と注意点
HubSpot CMS で「変更したのにページに反映されない」「自分の環境だけ古いまま見える」といった経験はないだろうか。HubSpot は CDN とサーバーサイドキャッシュが多層構造で動作しているため、保存直後にブラウザでアクセスしても古いキャッシュを掴んでしまうことがある。 そんなときに役立つのが、URL の末尾に付けるだけでキャッシュをバイパスできる ?hsCacheBuster クエリパラメータだ。ただし「キャッシュをクリアする」のではなく「自分のリクエストだけキャッシュを経由させない」挙動なので、その違いを押さえて使うのがポイントになる。 ?hsCacheBuster の基本的な使い方 確認したいページの URL の末尾に ?hsCacheBuster を付与してアクセスする。 1 2 https://www.example.com/landing-page?hsCacheBuster https://www.example.com/landing-page?hsCacheBuster=001 任意の値(数字や文字列)を渡すこともできる。値を変えながらアクセスすれば、確実に毎回キャッシュを通さずに最新コンテンツを取得できる。これは、同一 URL が CDN にキャッシュされる仕組みのため、値が変わると別 URL として扱われ、毎回オリジンから取得されるためだ。 1 2 https://www.example.com/landing-page?hsCacheBuster=20260423-1 https://www.example.com/landing-page?hsCacheBuster=20260423-2 重要 — あくまで「自分の環境」のキャッシュバイパス ?hsCacheBuster で起きるのは 自分のリクエストに対してのみ、キャッシュを経由せず最新コンテンツが返る という挙動である。 ✅ 自分の画面では最新の HTML が確認できる ❌ 他のユーザー(クライアントや訪問者)にもすぐに反映されるわけではない ❌ HubSpot 側のキャッシュ自体が無効化されるわけでもない つまり「変更が自分には見えるが、他の人にはまだ反映されていない」というケースは珍しくない。「キャッシュを消す」ボタンではなく「キャッシュをバイパスして取得する」ボタン と理解しておくのが正確だ。 公開ユーザーにも即時反映させたいとき 公開ユーザー全員にすぐ反映させたい場合は、ページエディター側で軽微な変更をかけて保存し直すのが手軽な方法だ。 ヘッダー HTML や設定欄に半角スペースを 1 つ追加して保存 そのまま再度保存(スペースを消す) これで HubSpot 側がページを再生成し、CDN キャッシュも切り替わる。実コンテンツに変更を加えなくても、保存をトリガーすれば再ビルドが走るのがポイントである(2026 年 4 月時点での挙動)。 ...