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
  • to load pages behind HTTP Basic Auth

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 teams. Track performance metrics and Lighthouse scores in CI and production. Learn more.