Text Localizer

Appearance

Text Layer Detection ​

Text Localizer automatically detects text layers within your selected frame. Here's how the detection works and what you need to know.

How Detection Works ​

Detection Process ​

  1. Plugin scans the selected frame
  2. Identifies all text layers, including nested ones
  3. Collects layer information:
    • Layer name
    • Text content
    • Layer path (if nested)

What Gets Detected ​

  • Regular text layers
  • Text within nested frames
  • Hidden text layers
  • Text in groups
  • Auto-layout text

TIP

All text layers will be detected regardless of their visibility or nesting level within the frame.

Layer Information ​

Layer Names ​

  • Original layer names are preserved
  • Used for identification in CSV export
  • Important for variable generation

Duplicate Layer Names ​

When the plugin encounters multiple text layers with the same name (common with components), it automatically adds a numeric suffix:

  • Original layer: Label
  • Duplicates become: Label 2, Label 3, etc.

This ensures each variable has a unique name while maintaining the connection to the original layer name.

Text Content ​

  • Current text content is captured
  • Formatting information is preserved
  • Special characters are supported

Common Detection Issues ​

Text Not Being Detected ​

Check if:

  • Text is actually in a text layer (not an image)
  • The frame is properly selected
  • Text layers aren't locked

Missing Text Layers ​

Common reasons for missing text:

  • Text in images
  • Text in components outside the frame
  • Text in linked files
  • Corrupt text layers

Best Practices ​

Layer Organization ​

[remains the same...]

Layer Naming ​

Good naming helps with localization:

  • Use descriptive names (e.g., "header_title" instead of "Text 1")
  • Follow a consistent naming convention
  • Include context in names when needed

Naming Restrictions ​

When naming your layers, avoid these characters as they'll cause issues with variable generation:

  • No parentheses ( )
  • No periods .
  • No dollar signs $

✅ Good layer names:

  • header_title
  • navigation_menu_home
  • footer_copyright_text
  • button_submit_label

❌ Avoid these layer names:

  • header(title)
  • navigation.menu
  • $button_text
  • (footer)_text

WARNING

Figma variables have naming restrictions. Using parentheses, periods, or dollar signs in your layer names will cause issues when generating variables.

Next Steps ​