Custom request headers

You can set up your project so that a custom request header is sent with every request that's made while loading the page.

Here are some example use cases:

  • to prevent the DebugBear agent from being blocked by your server
  • to exclude DebugBear requests from analytics

How to set up a custom request header

  1. Go to your project dashboard
  2. Click the "Edit" button in the top right corner of the page
  3. Click "Show advanced"
  4. Fill in the custom header details

Form for adding custom request headers to DebugBear requests

Using the API

You can customize the headers that are passed with each API analysis:

debugbear.pages.analyze(pageId, {
  customHeaders: {
    "X-Origin": "DebugBear"

Using the CLI

Use the --customHeader flag:

debugbear --pageId 1234 --customHeader "X-Origin:DebugBear" --customHeader "Another:Header"

Still need help? Contact for support.
DebugBear is a website monitoring tool built for front-end developers. Track performance metrics and Lighthouse scores in CI and production. Learn more.
© 2020 DebugBear Ltd