diff --git a/src/content/docs/crowdin/integrations/figma.mdx b/src/content/docs/crowdin/integrations/figma.mdx
index 6d676976..e4d6d736 100644
--- a/src/content/docs/crowdin/integrations/figma.mdx
+++ b/src/content/docs/crowdin/integrations/figma.mdx
@@ -454,3 +454,14 @@ To avoid this:
 * Check for missing font indicators (**A?**) before linking strings.
 * Make sure the fonts used in the original design are installed and available in your Figma.
 * If necessary, coordinate with the designer to confirm the correct font setup.
+
+### Mixed Fonts Within Text Nodes
+
+The Crowdin for Figma plugin does not support mixed fonts within a single text node due to technical limitations. This includes different font configurations, such as different font weights (e.g., 400 vs 700), even when using the same font family.
+
+When you download translations to such text nodes, the plugin will apply the first font configuration used in the string to the entire text.
+
+To avoid this issue:
+
+* Ensure each text node uses a single font with a shared configuration for the entire text.
+* Use regular formatting styles (bold, italic, etc.) instead of different font configurations to achieve visual emphasis.
diff --git a/src/content/docs/enterprise/integrations/figma.mdx b/src/content/docs/enterprise/integrations/figma.mdx
index f9ced8d5..f4f31645 100644
--- a/src/content/docs/enterprise/integrations/figma.mdx
+++ b/src/content/docs/enterprise/integrations/figma.mdx
@@ -454,3 +454,14 @@ To avoid this:
 * Check for missing font indicators (**A?**) before linking strings.
 * Make sure the fonts used in the original design are installed and available in your Figma.
 * If necessary, coordinate with the designer to confirm the correct font setup.
+
+### Mixed Fonts Within Text Nodes
+
+The Crowdin for Figma plugin does not support mixed fonts within a single text node due to technical limitations. This includes different font configurations, such as different font weights (e.g., 400 vs 700), even when using the same font family.
+
+When you download translations to such text nodes, the plugin will apply the first font configuration used in the string to the entire text.
+
+To avoid this issue:
+
+* Ensure each text node uses a single font with a shared configuration for the entire text.
+* Use regular formatting styles (bold, italic, etc.) instead of different font configurations to achieve visual emphasis.