Symbol Namer plugin for Sketch
A Sketch plugin to help you rename symbol instances.
- Rename symbol instances to their override text values
- New in Version 2 – Set and use a default name
- New in Version 3 – Templates!
How Symbol Namer works with text overrides
- The name is based on the value of the text override that appears first in the Inspector panel
- Symbol instances without text overrides are ignored
When a symbol has more than one text override, Symbol Namer assumes that you have set your symbol up nicely, so that its primary override is listed first in Sketch's Inspector panel. You can control this order by arranging the symbol master's layers in the desired order.
How defaults work
When you create a symbol you might give it a name like
Components/Album/Card/Default to keep your symbols organised. So this is the name that Sketch uses when you insert the symbol. But in the Layers Panel
Album Card might be better. Symbol Namer lets you set this as a default, making it quick and easy to reapply the saved name whenever needed. If you don't define a default then symbols will be renamed to match their master.
Default names can be set on Library symbols:
- Set the default in the library file to use it across all documents.
- Set the default in an individual document to use it in that document only.
How templates work
The Templates feature lets you define patterns for renaming your symbols. You can refer to each part of the symbol name by its position, either left to right or right to left, and you can also access override text:
%1for first from left,
%2for second from left, etc.
%-1for the last entry,
%-2for the second last entry, etc.
%Ofor override text.
%2 %3 maps "Components/Album/Card/Default" to "Album Card"
If you insert a "Save" button using "Button/Large/Primary/Disabled" and a "Cancel" button using "Button/Large/Secondary/Default", then the template
%O %1 - %-1 State would rename the buttons to "Save Button - Disabled State" and "Cancel Button - Default State".
Define a global template using
Define Template. Apply the global template using
Rename Selection Using Template.
Templates can also be used in
Set Default Symbol Name to save a default pattern for renaming a specific symbol.
- Download the latest release of the plugin
- Double-click on
If you are using this plugin, please 'star' the project. It's a simple way to help me see how many people are using it.
If you love this plugin, why not shout me a coffee