Symbol Namer plugin for Sketch

A Sketch plugin to help you rename symbol instances.

Features

• 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:

• %1 for first from left, %2 for second from left, etc.
• %-1 for the last entry, %-2 for the second last entry, etc.
• %O for override text.

e.g. %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.

Installation

• Download the latest release of the plugin
• Un-zip
• Double-click on symbol-namer.sketchplugin

or...

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 ☕️ via PayPal to share the love!