From 7b007d171e0d47f50b0321e7f6c829bbb98f6bec Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 17 Dec 2025 21:23:54 +0000
Subject: [PATCH] Update references/joins.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
 references/joins.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/references/joins.mdx b/references/joins.mdx
index a4fcee92..df27c459 100644
--- a/references/joins.mdx
+++ b/references/joins.mdx
@@ -401,6 +401,8 @@ models:
               sql: IF(${subscriptions.plan} = 'premium', ${user_id}, NULL)
 ```
 
+If you get the following error: `Model "TABLE" has a metric reference: ${TABLE.DIMENSION} which matches no metric` - you likely have a mismatch in metric category. Read more about metric categories [here](/references/metrics#metric-categories).
+
 <Warning>
   **Every joined field that you reference in a YAML file adds a dependency that you'll have to include in all future references to that model.**