Selection Inspector

Selection Inspector

Script for Adobe Illustrator

Functionality

Selection Inspector is a powerful tool for Adobe Illustrator that provides a comprehensive analysis of your current selection. By categorizing and counting various elements, it offers detailed insights into the composition of your artwork. Additionally, it allows you to filter, re-select, and locate objects based on specific attributes such as color, transparency, blending mode, path type, and text properties, streamlining the management and organization of complex designs with precision and efficiency.

Key Features:

  • Detailed Analysis: Breaks down the current selection into categories, including paths, text, compound paths, groups, color modes, and count the occurrences of each category.
  • Re-Selection and Location: Quickly locate and highlight items that match your chosen criteria within your artwork.
  • Search Functionality: Use the integrated search bar to find categories effortlessly.
  • Selection Saving: Save and reuse custom selections for future adjustments.
  • Efficient Workflow: Save valuable time by quickly identifying and selecting specific objects within complex artwork.

Installation

  • Place the script file in your Adobe 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.

Using the Script

1. Make a Selection

  • Use Illustrator’s selection tools (e.g., Selection Tool, Group Selection Tool) to select the objects you want to analyze.

2. Run the Script

  • Go to File > Scripts > Selection Inspector to launch the script.

3. Analyze the Selection

  • A dialog box will appear, providing a detailed breakdown of your selection:

 

➊ Detailed Selection Breakdown

Selection Inspector serves as an interactive interface for displaying and managing the categorized breakdown of your current selection. Here’s what it does:

1. Displays Categories and Counts:

  • The list shows the categorized breakdown of selected items, such as Open Paths, Text Objects, Linked Documents, Symbol Instances, Gradient Meshes, etc.
  • Each category is accompanied by a count, indicating the number of items in that category.

2. Allows Selection of Categories:

  • Users can select one or more categories to filter the selection.
  • Multi-selection is supported:

    • Hold Ctrl (Cmd) to select multiple non-contiguous categories.
    • Hold Shift to select a range of categories.

3. Search Integration:

  • Works with the search bar above it, dynamically filtering the list to display only categories matching the search query.

4. Filter and Highlight:

  • Once categories are selected, pressing the Select button filters the current selection in the Illustrator document, highlighting only the items that belong to the chosen categories.
  • Tip: Double-clicking an item in the listbox acts as a shortcut to apply the selection filter without needing to click the Select button.


➋ Functionality of the Select Button

The Select button in the Selection Inspector dialog filters and updates the selection in your Adobe Illustrator document based on the categories chosen in the listbox. Here’s a detailed explanation:

  • When clicked, the button isolates and highlights only the objects in your document that match the selected categories in the listbox.
  • If multiple categories are selected in the listbox, the button combines them, allowing you to locate and highlight all items across the chosen categories.
  • For example, if you select “Paths with Fill” and “Text Objects,” clicking “Select” will deselect all other objects and retain only those that belong to these categories.

Comprehensive List of Selectable Categories

The Selection Inspector script categorizes and tracks selected objects in your Adobe Illustrator document based on their type, attributes, properties, and other characteristics. Below is a comprehensive breakdown of all categories:

General Categories

  • Total Items Selected: The total number of items currently selected in the document.
  • Anchor Points: Counts the total number of anchor points across all selected paths.
  • Partially Transparent Objects: Objects with an opacity value between 0% and 100%.
  • Fully Transparent Objects: Objects with an opacity value of 0%.
  • Groups: Grouped objects in the selection.
  • Items in Groups: Individual objects that are part of a group.
  • Guides: Selected guide elements in the document.

Paths

  • Any Paths: All paths in the selection.
  • Open Paths: Paths that are not closed.
  • Closed Paths: Fully enclosed paths.
  • Paths With Fill: Paths containing a fill color.
  • Paths Without Fill: Paths without a fill color.
  • Paths With Stroke: Paths with a stroke applied.
  • Paths Without Stroke: Paths without a stroke applied.
  • Paths Without Fill & Stroke: Paths with neither a fill nor a stroke.
  • Paths With Dashed Stroke: Paths with a dashed stroke applied.
  • Paths With Undashed Stroke: Paths with a continuous stroke.
  • Stray Points: Isolated points without connecting paths.
  • Compound Paths: Compound paths within the selection.
  • Clipping Paths: Paths used as clipping masks.

Text

  • Any Text Frames: All text objects in the selection.
  • Empty Text Frames: Text objects with no content.
  • Area Type Objects: Text confined within a bounding area.
  • Point Type Objects: Text anchored at a specific point.
  • Type on Path Objects: Text that follows a path.
  • Total Characters: The total number of characters in all text objects.
  • Total Words: The total number of words in all text objects.
  • Total Text Lines: The total number of text lines across all text objects.
  • Fonts Used: A number of fonts applied in the selected text objects.

Images and Graphics

  • Embedded Images: Embedded raster images.
  • Linked Images: Linked raster images.
  • Gradient Meshes: Objects using gradient mesh attributes.
  • Graphs: Graph objects in the selection.
  • Symbol Instances: Instances of symbols used in the selection.

Blending Modes

  • Normal: Objects using the "Normal" blending mode.
  • Darken: Objects using the “Darken” blending mode.
  • Multiply: Objects using the “Multiply” blending mode.
  • Color Burn: Objects using the “Color Burn” blending mode.
  • Lighten: Objects using the “Lighten” blending mode.
  • Screen: Objects using the “Screen” blending mode.
  • Color Dodge: Objects using the “Color Dodge” blending mode.
  • Overlay: Objects using the “Overlay” blending mode.
  • Soft Light: Objects using the “Soft Light” blending mode.
  • Hard Light: Objects using the “Hard Light” blending mode.
  • Difference: Objects using the “Difference” blending mode.
  • Exclusion: Objects using the “Exclusion” blending mode.
  • Hue: Objects using the “Hue” blending mode.
  • Saturation: Objects using the “Saturation” blending mode.
  • Color: Objects using the “Color” blending mode.
  • Luminosity: Objects using the “Luminosity” blending mode.

Color Attributes

  • RGB Paths: Paths using RGB colors for fills or strokes.
  • CMYK Paths: Paths using CMYK colors for fills or strokes.
  • Grayscale Paths: Paths using grayscale colors for fills or strokes.
  • Pattern Paths: Paths filled or stroked with patterns.
  • Gradient Paths: Paths filled with gradient colors.
  • Global/Spot Color Paths: Paths using global or spot colors.


➌ Additional Features

🅰 Resizable Dialog Window

The dialog window can be resized to fit your workspace preferences.

  • You can manually resize the dialog by dragging its edges.
  • The layout automatically adjusts to maintain visibility of all categories.

Quickly filters the categories displayed in the listbox based on a typed query.

  • As you type into the search bar, the script dynamically updates the list to display only the categories that match your query.
  • It performs a case-insensitive search, making it easy to locate categories by partial names or keywords.

🅲 Save Selection Shortcut

Saves the current selection for quick access later.

  • Clicking the Save Selection icon stores the active selection in a reusable slot.
  • This saved selection can be re-accessed directly from Illustrator’s native Select menu.

🅳 Close Button

The Close button simply closes the dialog window without applying any changes to your selection or the Illustrator document.


☻ Wrap-Up

Selection Inspector empowers you to take full control of your selections in Adobe Illustrator, saving you time and effort when working with complex artwork.

From identifying specific object types to filtering by detailed attributes, this script provides the insights and tools you need to enhance your design process. We hope you find it a valuable addition to your workflow.

Leave a comment

Selection Inspector

Version: 1.7.6

Updated:

    • 1.7.5 – Public release.
    • 1.7.6 – User guide added. Access it via the ⏼ button to find helpful instructions and tips for using the script effectively.

    Tested on MacOS:

    • Adobe Illustrator 2023 (27.0)
    • Adobe Illustrator 2024 (28.1)
    • Adobe Illustrator 2025 (29.0)
  • 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 Selection Inspector.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 Selection Inspector.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 Selection Inspector script to run it.
    5. The Selection Inspector 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