diff --git a/docs/src/test-annotations-js.md b/docs/src/test-annotations-js.md
index 68bdd79848..5fc2f78955 100644
--- a/docs/src/test-annotations-js.md
+++ b/docs/src/test-annotations-js.md
@@ -159,7 +159,7 @@ You can also filter tests in the configuration file via [`property: TestConfig.g
## Annotate tests
-If you would like to annotate your tests with something more substantial than a tag, you can do that when declaring a test. Annotations have a `type` and a `description` for more context, and will be visible in the test report.
+If you would like to annotate your tests with something more substantial than a tag, you can do that when declaring a test. Annotations have a `type` and a `description` for more context and available in reporter API. Playwright's built-in HTML reporter shows all annotations, except those where `type` starts with `_` symbol.
For example, to annotate a test with an issue url:
diff --git a/packages/html-reporter/src/testCaseView.spec.tsx b/packages/html-reporter/src/testCaseView.spec.tsx
index c306843107..3bde6e8a83 100644
--- a/packages/html-reporter/src/testCaseView.spec.tsx
+++ b/packages/html-reporter/src/testCaseView.spec.tsx
@@ -54,6 +54,7 @@ const testCase: TestCase = {
annotations: [
{ type: 'annotation', description: 'Annotation text' },
{ type: 'annotation', description: 'Another annotation text' },
+ { type: '_annotation', description: 'Hidden annotation' },
],
tags: [],
outcome: 'expected',
@@ -65,6 +66,7 @@ const testCase: TestCase = {
test('should render test case', async ({ mount }) => {
const component = await mount(