This guide covers the full workflow: scan, review, swap, and verify.

1. Start a Scan

1. Open your Figma file.
2. Launch LayerSweep.
3. In scan setup, choose one or more pages.
4. Choose scan scope:
   1. Instance
   2. Component
   3. Frame/Page
5. Click Scan Pages.

Notes

• You can select all pages.
• Your last page/scope selection is reused while the plugin session stays open.

2. Review Scan Results

Results are grouped as:

• Library: Local, Remote library: {name}, Detached Styles
• Type: Text, Paint, Effect, Color Variable
• Style → Page → Layers

You can:

• Expand rows to inspect exact usage
• Jump to a single layer
• Select all target layers inside a page group

Detached and Mixed Formatting

• Detached paints/effects/text are grouped under Detached Styles.
• Mixed text appears as [Mixed Text Style] under Local.

3. Filter and Search

Use the results controls to narrow scope before swapping:

• Search by style name
• Filter by library/type
• Filter by location/layer type

<aside> <img src="/icons/info-alternate_gray.svg" alt="/icons/info-alternate_gray.svg" width="40px" />

Tip: Filters affect what you see and what you can target in Swap.

</aside>

4. Configure Swaps

1. Select source styles in the Scan tab.
2. Open the Swap tab.
3. Choose a target for each selected source style.
4. Optionally narrow target layers by expanding style/page/layer rows.
5. Use Swap styles in instances to include or exclude instance layers.
6. Click Swap Selected

LayerSweep opens a confirmation view before execution.

5. Confirm and Run

In confirmation, review:

• Number of affected layers
• Selected styles and target mappings
• Page-level impact

Then confirm to execute swaps.

6. Undo (If Needed)

After a swap, use Undo in the plugin to revert the most recent swap operation.

If plugin undo is unavailable, use Figma undo:

• Cmd+Z on macOS
• Ctrl+Z on Windows

7. Export Scan Data

To export current results:

1. Open Settings
2. Click Export current scan

This exports scan data as JSON for reporting or troubleshooting.

Supported Swap Combinations

• Text style → Text style
• Paint style → Paint style
• Effect style → Effect style
• Color variable → color variable
• Color variable → paint style

Not supported:

• Non-color variable types
• Cross-type swaps outside the combinations above

Limitations and Notes

• Variable support is currently color variables only.
• Search matches style names, not layer names.
• There is no separate swap scope selector; effective scope comes from your selections, filters, and instance toggle.
• After large edits, rescan to refresh results.

<aside> <img src="/icons/dialogue_gray.svg" alt="/icons/dialogue_gray.svg" width="40px" />

Need help?

See Feedback & Support

</aside>

About LayerSweep

How to Use

Privacy Policy

Changelog

Feedback