Symbol Selector

Symbol Selector

Script for Adobe Illustrator

Description

Symbol Selector is a powerful and intuitive Adobe Illustrator script designed to help users quickly find, select, and manage symbol instances in their documents. Whether you’re working with complex designs that contain multiple symbols or need to efficiently select and modify specific symbol instances, this tool streamlines the process with a user-friendly interface, real-time search functionality, and batch selection features.

Key Features

  • Instantly view all symbols used in your document.
  • Filter symbols dynamically using a search bar.
  • Select individual or multiple symbol instances with ease.
  • Remove unused symbols to optimize your document.
  • Improve workflow efficiency when working with large projects.

Installation

  • Place the script in your Illustrator Scripts folder:

    MacOS:
     /Applications/Adobe Illustrator <Version>/Presets/<Language>/Scripts
    Windows: C:\Program Files\Adobe\Adobe Illustrator <Version>\Presets\<Language>\Scripts

  • Restart Adobe Illustrator to load the script into the File > Scripts menu.
  • Open your document and go to File > Scripts > Symbol Selector to launch the script.
  • When the script runs, a dialog window appears with the following elements:

 

How to Use Symbol Selector

➊ Search Bar

The Search Bar in the Symbol Selector script is a powerful filtering tool that helps users quickly find specific symbols within an Adobe Illustrator document. Instead of manually scrolling through a long list of symbols, users can type part of a symbol’s name to dynamically refine the list.

  • As you type, the list of symbols updates instantly to match your input.
  • The filtering is case-insensitive, meaning it doesn’t matter if you type uppercase or lowercase letters.
  • Partial name matches are supported—typing "star" will display Star, Star Outline, Rounded Star, etc.
  • If the user leaves the search field empty, all symbols are displayed again.
  • After filtering, users can click on any result to select the corresponding symbol instances.


➋ Symbol List

The Symbol List in the Symbol Selector script is the central interface where users can view, filter, and select symbol instances used in an Adobe Illustrator document. It provides a structured way to navigate through symbols, displaying their names and the number of times each appears in the document.

Key Features of the Symbol List:

  • Shows every symbol definition currently available in the document.
  • 'All Symbols' is always listed at the top, allowing users to select all symbol instances at once.
  • The second column in the list shows how many times each symbol appears in the document.
  • When a user types in the Search Bar, the Symbol List updates to show only matching results.
  • Supports single selection (Double-click on one symbol to select its instances).
  • Supports multi-selection: Hold Shift to select a range of symbols or Hold Ctrl/Cmd to select multiple non-adjacent symbols.
  • Users can select one or multiple symbols before clicking 'Select' to highlight their instances.

How to Use the Symbol List

  1. Browse the Symbol List: Scroll to view all available symbols in the document.
  2. Search for a Symbol: Use the Search Bar to filter the list dynamically.
  3. To select one Symbol: Click a symbol name to select it.
  4. To select multiple Symbols: Hold Shift for range selection or Ctrl/Cmd for multiple selections.
  5. Click 'Select' button: Highlights all instances of the selected symbol(s) in the document.



➌ Select Button

The Select Button in the Symbol Selector script is the primary action button that allows users to highlight and select all instances of the chosen symbol(s) within the Adobe Illustrator document. It provides a quick and efficient way to locate and modify symbol instances without manually searching for them.

Key Features of the Select Button:

1. Selects Symbol Instances in the Document

  • When the user chooses a symbol name from the Symbol List and clicks Select, the script will find and select all instances of that symbol in the document.
  • If multiple symbols are selected, all instances of the selected symbols will be highlighted.

2. Multi-Selection Support

  • Users can select one or multiple symbols before clicking the Select Button.
  • Single selection – Clicking one symbol in the list and selecting all its instances.
  • Multiple selection – Holding Shift or Ctrl (Cmd on Mac) to select multiple symbols at once.

3. Select All Symbols

  • If the user selects 'All Symbols' from the list and clicks Select, every symbol instance in the document will be selected.
  • Useful for global modifications, such as resizing or repositioning all symbols at once.

4. Intelligent Selection Handling

  • Click “Select” to highlight all instances of the chosen symbol(s) in your document.
  • Once the selection is made, Illustrator will zoom in on the selected symbols so users can edit them immediately.
  • If some symbols are hidden or locked, the script will inform the user that certain instances could not be selected.
  • When working with a large document, the script displays a progress bar while selecting symbols.

 


➍ Additional Features

The Symbol Selector script includes several enhanced features that improve usability, flexibility, and workflow efficiency. These additional features ensure smooth interaction with the script while allowing users to manage symbols effectively.

🅰 Resizable Dialog Window

  • The dialog window is resizable, allowing users to expand or shrink the interface based on their needs.
  • Useful for working with large symbol lists, as users can increase the window size for better visibility.
  • Click and drag the window’s edges to resize it. The list box and search bar will automatically adjust.


 

🅱 Delete All Unused Symbols Option

  • This feature removes all symbols that are not used in the document.
  • It helps reduce file size and clean up unnecessary symbols, making the document more efficient.
  • Symbols that have zero instances in the document will be permanently removed.

🅲 Cancel Button

  • The Cancel button allows users to exit the dialog without making any changes.
  • No selection is applied when the Cancel button is clicked.

🅳 Open Guide Icon

  • This icon ⏼ links to the user guide or help documentation, providing quick access to instructions.
  • Useful for new users or anyone who needs a refresher on how the script works or check for updates.


☻ Conclusion

The Symbol Selector script is a powerful and intuitive tool designed to streamline the process of finding, selecting, and managing symbols in Adobe Illustrator. With features like real-time search, multi-selection support, batch symbol selection, and the ability to delete unused symbols, this script enhances workflow efficiency and organization.

We hope this guide has provided a clear understanding of how to use Symbol Selector effectively. If you have any questions or suggestions for enhancements, feel free to reach out. Now, enjoy a smoother and more efficient symbol management experience in Adobe Illustrator! 

Leave a comment

Symbol Selector

Version: 1.0.0

Updated:

  • 1.0.0 – Initial release.

    Tested on MacOS:

    • Adobe Illustrator 2023 (27.0)
    • Adobe Illustrator 2024 (28.1)
    • Adobe Illustrator 2025 (29.0.1)
  • Supported Versions:

    • Compatible with Adobe Illustrator CS6 and later, including Adobe Illustrator CC versions.

    Operating Systems:

    • Works on both macOS and Windows platforms.
  • End User License Agreement (EULA)

    Last Updated: 21.12.2024

    This End User License Agreement (“Agreement”) is a legal agreement between you (“User” or “Licensee”) and Samolevsky.com (“Licensor”) regarding the use of the Adobe Illustrator scripts (“Software”). By downloading, installing, or using the Software, you agree to be bound by the terms of this Agreement.

    1. Grant of License

    Licensor grants the User a non-exclusive, non-transferable, and revocable license to use the Software in accordance with this Agreement.

    • Free Software: If the Software is provided for free, you may use it for personal or commercial purposes without payment, subject to the restrictions outlined in this Agreement.
    • Paid Software: If the Software is provided for a fee, you may use it only after payment has been made in full.

    2. Usage Rights

    You are permitted to:

    • Install and use the Software on devices you own or control.
    • Use the Software in your personal or commercial projects, subject to compliance with this Agreement.

    3. Restrictions

    You may NOT:

    • Reverse engineer, decompile, or otherwise attempt to discover the source code, underlying ideas, or algorithms of the Software.
    • Reuse, incorporate, or integrate any portion of the Software into any other software, product, or project, except as expressly permitted by the Licensor in writing.
    • Resell, redistribute, or share the Software, whether in its original or modified form, without prior written consent from the Licensor.
    • Claim ownership of the Software or its underlying code.
    • Use the Software in any way that violates applicable laws or regulations.

    4. Ownership

    The Software and all intellectual property rights therein remain the exclusive property of the Licensor. This Agreement does not transfer ownership of the Software or any intellectual property rights to the User.

    5. Disclaimer of Warranties

    THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    6. Limitation of Liability

    To the maximum extent permitted by law, Licensor shall not be liable for any damages, including but not limited to direct, indirect, incidental, special, or consequential damages, arising out of or related to the use or inability to use the Software.

    7. Termination

    This Agreement is effective until terminated. Licensor may terminate this Agreement immediately if you breach any term of this Agreement. Upon termination, you must cease all use of the Software and destroy any copies in your possession.

    8. Updates and Support

    Licensor is not obligated to provide updates, support, or maintenance for the Software. However, updates may be provided at the sole discretion of the Licensor.

    9. Governing Law

    This Agreement shall be governed by and construed in accordance with the laws of the State of New York, without regard to its conflict of law principles.

    10. Entire Agreement

    This Agreement constitutes the entire agreement between you and the Licensor concerning the Software and supersedes all prior or contemporaneous understandings regarding such subject matter.

    By using the Software, you acknowledge that you have read this Agreement, understand it, and agree to be bound by its terms.

    For any questions or concerns regarding this Agreement, please contact us at hello@samolevsky.com

Required Software

Adobe Illustrator

Use this text to share information about your brand with your customers. Describe a product, share announcements, or welcome customers to your store.

Adobe Illustrator is a professional vector graphics software developed by Adobe Inc. It is widely used by designers, illustrators, and artists for creating a variety of digital artwork, including logos, icons, illustrations, typography, and complex design layouts. Illustrator is known for its precision and scalability, allowing users to create high-quality graphics that can be resized without losing clarity. Its features include powerful drawing tools, customizable brushes, advanced typography options, and seamless integration with other Adobe Creative Cloud applications. Illustrator is a go-to tool for creative professionals working on projects for print, web, and multimedia platforms.

  • 🅰 Locating the Scripts Folder

    To install a Symbol Selector.jsx script in Adobe Illustrator, you need to place it in the correct directory where Illustrator
can recognize it. Follow these steps to locate the Scripts folder:

    1. MacOS:
      Open Finder and navigate to:
      Applications/Adobe Illustrator <Version>/Presets/<Language>/Scripts.
    2. Windows:
      Open File Explorer and navigate to:
      C:\Program Files\Adobe\Adobe Illustrator <Version>\Presets\<Language>\Scripts
    3. Replace <Version> with your Adobe Illustrator version (e.g., 2025).
    4. Replace <Language> with your language folder (e.g., "de_DE" for German, "en_US" for English).

    🅱 Installing the Script

    1. Copy the Script File: Copy the Symbol Selector.jsx file to the Scripts folder located in the path above.
    2. On some systems, you may need administrator permissions to modify the Scripts folder.
    3. Restart Adobe IllustratorTo refresh the scripts menu, close and reopen Adobe Illustrator.

    Explore our complete guide to mastering Adobe Illustrator scripts.

    1. Open Adobe Illustrator and ensure a document is active.
    2. Go to the top menu bar and select File > Scripts.
    3. If the script is installed in the Scripts folder, it will appear in the dropdown list.
    4. Click the Symbol Selector script to run it.
    5. The Symbol Selector script will execute, and any dialog boxes or results will appear based on the script’s functionality.

    ☻ Before running any scripts, it’s strongly advised to save your work — especially when working with complex or large documents.

Got questions?

Need help or have an idea to share? We’d love to hear from you! Whether you have questions, found a bug, have a feature request, or just want to share your feedback, reach out to us—we’re here for you! 

Browse More Scripts

  1. Read more: Adjust Stroke Weight by Percentage
    Adjust Stroke Weight by Percentage

    Adjust Stroke Weight by Percentage

    The Adjust Stroke Weight by Percentage script for Adobe Illustrator allows users to proportionally scale the stroke weight of multiple selected objects. It provides a user-friendly dialog where you can input a percentage or use a slider to increase or decrease stroke widths. Additionally, the script offers an option to apply an average stroke width across all selected objects.
    Read more
  2. Read more: Hue Saturation Lightness
    Hue Saturation Lightness

    Hue Saturation Lightness

    Hue Saturation Lightness is a powerful Adobe Illustrator script designed to give you complete control over the color properties of your selected paths and text objects. With this intuitive dialog window, you can effortlessly adjust the Hue, Saturation, and Lightness of your design elements, offering precise and customizable color transformations.
    Read more
  3. Read more: Select by Size
    Select by Size

    Select by Size

    Select by Size is a powerful script for Adobe Illustrator that allows users to select objects based on their width and height ranges. Whether working with small icons or large design elements, this tool ensures precise control over selections, saving time and effort.
    Read more