js_challenge_title

Sets the title for the JavaScript challenge interstitial page in NGINX.

Syntaxjs_challenge_title "string";
Default"Verifying your browser..."
Contextserver, location
Arguments1

Description

The js_challenge_title directive is used within the NGINX JavaScript challenge module to define the HTML title that appears in the browser's title bar or tab when users are presented with a JavaScript challenge. This interstitial page is displayed to users before granting them access to the protected resource. By customizing the title, you can provide users with a better understanding of the challenge they're attempting to solve, enhancing the user experience.

This directive can be placed in both the server and location contexts, allowing for flexibility based on different URLs or server configurations. The argument for this directive should be a string that represents the desired title. If not specified, it defaults to a generic message indicating verification, which might not be as informative as a custom title. This is particularly useful for improving usability, especially in scenarios where web applications involve a large number of automated users or bots. Additionally, by adjusting the title, you can align it with your website’s branding and messaging.

When combined with other directives like js_challenge and js_challenge_secret, it helps to create a coherent workflow for validating users through JavaScript-based challenges. This builds a layer of security while ensuring that users are aware of the purpose behind the verification process. It serves to communicate effectively with end-users, potentially reducing confusion or frustration when they encounter the JavaScript challenge.

Config Example

server {
    js_challenge on;
    js_challenge_secret "change me!";
    js_challenge_title "Confirming Access...";
}

Ensure that the title is properly quoted as it is a string.

Using an overly complex title may confuse users; keep it simple and relevant.

If defined in multiple contexts, the most specific directive will take precedence.

← Back to all directives