diff --git a/docs/guide/assets.md b/docs/guide/assets.md
index c0dba49a604f80..dff926f2c2da31 100644
--- a/docs/guide/assets.md
+++ b/docs/guide/assets.md
@@ -28,6 +28,8 @@ The behavior is similar to webpack's `file-loader`. The difference is that the i
 
 - Git LFS placeholders are automatically excluded from inlining because they do not contain the content of the file they represent. To get inlining, make sure to download the file contents via Git LFS before building.
 
+- TypeScript, by default, does not recognize static asset imports as valid modules. To fix this, include [`vite/client`](./features#client-types).
+
 ### Explicit URL Imports
 
 Assets that are not included in the internal list or in `assetsInclude`, can be explicitly imported as a URL using the `?url` suffix. This is useful, for example, to import [Houdini Paint Worklets](https://houdini.how/usage).