Skip to content
Browse documentation

Custom User Agent

Updated 2026-02-10

CheckView allows you to set a custom user agent string for each test flow. This can help bypass bot detection mechanisms that block requests based on the default browser user agent.

When to Use a Custom User Agent

  • Bot detection bypass: Some security plugins or CDN services block automated browser traffic based on the user agent string. Setting a custom user agent that mimics a standard browser can help avoid these blocks.

  • Testing specific user agents: Verify how your site behaves when accessed by specific browsers or devices.

How to Configure

  • Open the Test Flow you want to configure.

  • Click the Settings gear icon.

  • Navigate to Advanced Settings.

  • In the Custom User Agent field, enter the user agent string you want to use.

  • Click Save changes.

Important Notes

  • The custom user agent replaces the default Chrome user agent for all requests in the test.

  • If left blank, CheckView uses the default Chrome user agent.

  • The custom user agent is specific to each test flow and does not affect other test flows.