Japanese text not displayed when capturing designs via Claude Code to Figma

Hi ​@konaji san,

Welcome to the Figma Forum! Thanks for flagging this and for sharing the detailed reproduction steps, that’s really helpful.

I understand that when using Claude Code with the Figma MCP server, Japanese characters are not rendering correctly (shown as tofu □ or completely missing) in the generated frame.

I’ll go ahead and share this internally with our team for review. I’ll follow up once I have more information.

In the meantime, could you please share a bit more detail, for example:

• Which font is selected in the text layer?
• Are you seeing this across all Japanese fonts, or only specific ones?
• Does the issue persist if you manually change the font in the text layer?
• If possible, could you please share a screenshot of what you’re seeing?

Thanks,

Hi ​@Junko3 san,

Thank you for your response! I've attached a screenshot showing the issue. As you can see, the left side shows the actual product screen, and the right side shows the Figma output generated via Claude Code with Figma MCP. The difference is quite significant.

Here are my answers to your questions:

Which font is selected in the text layer?
Helvetica Neue is selected in the generated text layers. This is likely being applied as a fallback, since Helvetica Neue does not support Japanese characters.
The fonts we are actually using for Japanese text in our product are:
- Hiragino Kaku Gothic ProN
- Hiragino Sans

Are you seeing this across all Japanese fonts, or only specific ones?
From what I've tested, this occurs across all Japanese fonts — it appears that Japanese fonts are not being assigned correctly during the generation process.

Does the issue persist if you manually change the font in the text layer?
Yes — when I manually assign a Japanese-compatible font (e.g. Hiragino Kaku Gothic ProN, Hiragino Sans), the text renders correctly. So the issue seems to be that the MCP tool is not applying an appropriate Japanese font during generation.

In addition to the font issue, I'm also seeing the following problems in the generated output:

1. Image assets are not rendered at the correct size
Images appear at incorrect dimensions compared to the original design.

2. Some layers overflow outside their parent frames
Certain layers extend beyond their expected frame boundaries.

Please let me know if you need any additional information!

Best regards,
Kenta Konaka

Hi ​@Junko3 san

I wanted to share an update — I've been able to identify the root cause of the issue!

It appears that the MCP tool forcibly applies the first font listed in the CSS `font-family` property. When that font does not support Japanese characters (e.g. Helvetica Neue), it does not fall back to the next font in the list — the Japanese text simply fails to render.

To verify this, I removed Helvetica Neue from the `font-family` and ran the generation again. The Japanese text rendered correctly this time.

So the core issue seems to be that **font fallback is not working as expected** during the Figma generation process.

Hope this helps narrow things down for your team. Please let me know if you need any further details!

Best regards,
Kenta Konaka

Hi ​@konaji san, thank you so much for this excellent additional information! I’ll share this with our team right away!

I can see that some community members have already liked your post, so I’m sure your insight will help others as well.

We really appreciate you working with us to get to the bottom of this.
We’ll keep you updated.