Skip to main content
Question

Plugin API question: access file

  • February 16, 2026
  • 1 reply
  • 64 views

Liviu

I’m building a public Community plugin that integrates with POEditor. I need a reliable way to identify the current Figma file (file key/ID) so I can associate exported/imported translations with the correct file. This is important because text node IDs are not globally unique across files, so the same node ID can exist in different files.

From the docs, it looks like figma.fileKey is only available to private plugins via enablePrivatePluginApi. Is there any supported way for a public plugin to access the current file key/ID (or another stable file identifier)?

If this isn’t possible today, what’s the recommended best practice for public plugins that need to associate data with a specific file?

Details:

  • Plugin type: public (intended for Community)

  • Use case: linking file -> POEditor project

  • What I’ve tried: figma.fileKey (undefined in a public plugin)

Ideal outcome:

  • Send POEditor the text node id (or name) plus a stable file identifier as context.

Thanks!

1 reply

GiroXIII
  • New Participant
  • April 21, 2026

Hey, I hit the same limitation and just filed a feature request proposing an alternative file identifier (not the file key itself, to sidestep the security concerns Figma has raised before). Sounds like it would help your scenario as well. 

Feel free to add your voice:
https://forum.figma.com/suggest-a-feature-11/plugin-api-request-expose-a-stable-non-duplicable-file-identifier-to-plugins-53205