diff --git a/docs/recipes/code-coverage.md b/docs/recipes/code-coverage.md
index a4162276d..1c125b1bd 100644
--- a/docs/recipes/code-coverage.md
+++ b/docs/recipes/code-coverage.md
@@ -1,5 +1,7 @@
 # Code coverage
 
+**TYPESCRIPT WARNING: If you are not building then running ava (i.e. you are using a [custom node loader](https://github.com/avajs/ava/blob/main/docs/recipes/typescript.md), this will not work.**
+
 Translations: [Español](https://github.com/avajs/ava-docs/blob/main/es_ES/docs/recipes/code-coverage.md), [Français](https://github.com/avajs/ava-docs/blob/main/fr_FR/docs/recipes/code-coverage.md), [Italiano](https://github.com/avajs/ava-docs/blob/main/it_IT/docs/recipes/code-coverage.md), [日本語](https://github.com/avajs/ava-docs/blob/main/ja_JP/docs/recipes/code-coverage.md), [Português](https://github.com/avajs/ava-docs/blob/main/pt_BR/docs/recipes/code-coverage.md), [Русский](https://github.com/avajs/ava-docs/blob/main/ru_RU/docs/recipes/code-coverage.md), [简体中文](https://github.com/avajs/ava-docs/blob/main/zh_CN/docs/recipes/code-coverage.md)
 
 Use [`c8`] to compute the code coverage of your tests.