Skip to content

Basic Usage

This guide walks you through the fundamental operations of Text Localizer.

Plugin Interface

When you open Text Localizer, you'll see a simple interface with three main functionalities:

  • Frame scanning
  • CSV export
  • Variable generation

main-screen-no-frame

Step-by-Step Usage

1. Selecting a Frame

  • Choose a single frame that contains text you want to localize
  • The plugin only processes one frame at a time
  • Nested frames are supported

main-screen-with-frame-selected

2. Scanning Text Layers

When you launch the plugin with a frame selected:

  1. The plugin automatically scans for text layers
  2. All detected text layers will be displayed in a list
  3. You can see the text content and layer name for each item

If no frame is selected, you'll see a prompt to select one.

3. Working with Results

After scanning, you have three options:

Export to CSV

  1. Click "Export CSV"
  2. Choose save location
  3. Your CSV file will contain:
    • Layer names
    • Text content
    • Additional metadata

Generate Variables

  1. Select the text layers you want to convert
  2. Click "Generate Variable"
  3. Variables will be created in your Figma file

Rescan Frame

  • Use this if you've made changes to your frame
  • Click "Rescan Frame" to update the text layer list

Common Scenarios

Single Text Update

  1. Select a frame
  2. Export to CSV
  3. Update text in CSV
  4. Use variables for dynamic updates

Bulk Text Management

  1. Organize text in frames
  2. Export all text to CSV
  3. Manage translations in the CSV
  4. Generate variables for automated updates

Best Practice

Name your text layers descriptively before scanning. This makes it easier to identify them in the CSV export.

Common Mistake

Don't select multiple frames at once - the plugin only processes one frame at a time.

Next Steps