Help Centre
Getting started, frequently asked questions, known limitations, and how to reach us.
Getting started
Headergrade is a security header diagnostics tool. It fetches a URL you provide, reads the HTTP response headers that the server actually sends, and tells you what each one means in plain language — plus the one-line change to fix it.
-
Go to the Check page Open the Check a URL page. You will see a single input field.
-
Type a public URL Enter any public
httporhttpsaddress. If you omit the protocol,https://is added automatically. The URL must be accessible from the public internet — the tool cannot check private or local addresses. -
Click Check The tool fetches the URL and analyses every response header. It follows a couple of redirects but does not crawl the site or follow links.
-
Read the report Each of the six security headers gets its own section: the raw value the server sent (or "Not sent" if absent), a plain-language explanation of what that value means, and a one-line action if it should change. The full list of all headers received is also shown.
Frequently asked questions
Headergrade runs on the Cloudflare Workers runtime. The Workers platform cannot open a connection to hosts that are themselves behind Cloudflare's edge. If your site is fronted by Cloudflare, the checker will see a refused connection and report the URL as unreachable.
This does not mean your server is down or your firewall is blocking the check. It is a limitation of the checker's own platform. If you receive a "cannot connect" result for a site you know is responding, this is the most likely cause.
Workaround: If you can test from a non-Cloudflare network, or from a raw IP address that bypasses the Cloudflare proxy, the check may succeed. Otherwise, the tool will note this limitation in the report.Six headers are analysed individually:
Content-Security-Policy— controls which sources the browser may load scripts, styles, and media from. The main defence against XSS.Strict-Transport-Security— forces browsers to connect over HTTPS and never fall back to plain HTTP.X-Content-Type-Options— stops the browser from MIME-sniffing a response into something it is not.X-Frame-Options— prevents your page from being embedded in another site's iframe. The defence against clickjacking.Referrer-Policy— controls how much of the URL is leaked to other sites when a visitor clicks a link.Permissions-Policy— restricts which browser features (camera, microphone, geolocation) the page may use.
All other headers received from the server are displayed in the full raw header list, but only these six get the individual analysis.
No. Headergrade does not create accounts, set cookies, log IP addresses, or store the URLs you check. Every scan is independent. The tool fetches the URL you provide, returns the analysis to your browser, and retains nothing afterwards. There is no history, no saved reports, and no way to retrieve a previous result.
See the Privacy Policy for full details.
Each header report includes a recommendation section with a specific, actionable change. For example, if X-Frame-Options is missing, the recommendation will say something like:
"Add the header X-Frame-Options: DENY to your server configuration to prevent clickjacking."
How you apply the change depends on your server platform:
- Web server config: Add the header line to your nginx, Apache, Caddy, or IIS configuration.
- CDN or edge proxy: Set the header in your Cloudflare, Fastly, or Akamai dashboard.
- Application framework: Use a middleware or security library (e.g., Helmet for Express, security headers for Django, or the built-in middleware in ASP.NET Core).
- Static hosting: Some static hosts (like Netlify, Vercel) let you set custom headers via a configuration file.
Headergrade tells you what to change, not how to change it in your specific setup. The exact configuration syntax depends on your server software. Consult your server or host documentation for the correct way to add response headers.
No. The checker runs on the public internet and can only reach publicly accessible URLs. It cannot check:
- Local or private addresses (e.g.,
localhost,192.168.x.x,10.x.x.x) - Internal-only servers or services behind a VPN
- Password-protected or login-gated pages (the scanner does not have credentials)
If you need to check a non-public server, you would need to run a header checker from within your own network. This tool is not designed for that use case.
No. Headergrade is a diagnostics tool that reports what it receives from the target server. It is not a security audit, penetration test, or vulnerability assessment.
Headergrade does not claim compliance with any security standard, certification, or regulation — including PCI DSS, SOC 2, ISO 27001, HIPAA, or GDPR. A report from Headergrade is not a compliance audit and should not be used as one.
The tool is provided as a diagnostics aid to help you understand what headers your server is sending and what they mean. It does not replace a professional security review.
Not currently. Headergrade checks one URL at a time, and there is no scheduled or automated scanning. A Pro plan with batch checks and CSV export is under development but not yet available.
There is also no email notification system — the tool cannot send alerts, reminders, or scheduled reports. It answers when you ask it, and that is all.
Known limitations
Headergrade is a young tool. These are the things it does not do yet, or cannot do because of its platform:
- Cloudflare-hosted sites appear unreachable The checker runs on Cloudflare Workers and cannot open a connection back into Cloudflare's own network. Sites behind Cloudflare may report as "cannot connect". This is a platform limitation, not a firewall issue.
- No accounts, saved history, or email Every scan is ephemeral. The tool does not store results, send notifications, or support user accounts. There is no way to retrieve or share a previous scan.
- Only six security headers get individual analysis The tool analyses Content-Security-Policy, Strict-Transport-Security, X-Content-Type-Options, X-Frame-Options, Referrer-Policy, and Permissions-Policy. Other headers are shown in the raw list but are not individually explained.
- No batch scanning You can only check one URL at a time. There is no CSV upload, list import, or bulk check feature. A Pro plan with batch scanning is planned but not yet built.
- No crawling or link following The checker follows a couple of redirects at most. It does not crawl the site, follow links, or scan subpages.
- No compliance certification Headergrade does not certify compliance with any standard or regulation. The tool is a diagnostics aid, not a compliance audit.
- Pro plan and payment processing are not yet live The Pro plan is under development. No payment processor is connected. Any checkout forms on the site are visual demonstrations only and do not process real transactions.
- No contact email or support channel yet The operator has not yet registered a contact method. See the "Contact us" section below for the current status.
Contact us
Headergrade does not currently have a contact email address, support form, or live chat channel. The operator has not yet registered a contact method for this tool.
For routine questions: This Help Centre page covers the most common questions. If you cannot find what you are looking for, check the Pricing, Privacy Policy, and Terms of Service pages.
For the operator: The owner of this service needs to register a contact method before support can be provided. Once a contact channel is established, this page will be updated with the details.
No email address is listed here because no mailbox on this domain is currently reachable. Listing an unreachable address would be worse than listing none — it would tell you help exists when it does not.