Select by Artboards

Select by Artboards

Script for Adobe Illustrator

Overview

Master your multi-artboard Illustrator documents with Select by Artboards. This powerful script provides precise object selection within designated artboards, eliminating tedious manual work and boosting productivity. Streamlining your workflow further, it automates artboard resizing, cleans up empty artboards, and provides instant object counts, ensuring effortless control over even the most intricate projects.

Key Features

1. Dynamic Artboard List:

  • Displays comprehensive details for each artboard, including name, index number, width, height, and document units.
  • Fully resizable dialog window for enhanced usability.
  • Double-clicking an artboard in the list fits it into the workspace for easy focus.

2. Precise Item Selection:

  • Select items based on their position relative to specific artboards.
  • Select items entirely inside or outside the boundaries of chosen artboards for refined control.

3. Intuitive Artboard Filtering:

  • Filter artboards by various criteria, including index, name, size, and orientation.

4. Search Functionality:

  • Quickly locate specific artboards by entering a search term based on the selected filter (e.g., name or size).

5. Advanced Actions:

  • Fit Artboards to Artwork: Automatically adjusts artboards to fit the artwork with optional margins.
  • Delete Empty Artboards: Identifies and removes unused artboards, keeping the workspace organized.
  • Count Items: Calculates the number of items on each artboard for better project management.

Install and Run the Script

  • 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.
  • Open your document and go to File > Scripts > Select by Artboards to launch the script.

Understanding the Script Interface

When the script runs, it opens a resizable dialog window featuring various tools and options. 

 

Here’s how to use them:

➊ Artboard List

The Artboard List is a core feature of the Select by Artboards script, providing a dynamic and comprehensive overview of all the artboards in your Adobe Illustrator document. 

 

Key Functions:

1. Displays Artboard Details:

Shows essential information for each artboard in a tabular format:

  • 1.1 Index: The sequential number of the artboard.
  • 1.2 Name: The custom or default name of the artboard.
  • 1.3 Width and Height: Dimensions of the artboard.
  • 1.4 Units: The unit of measurement used for the artboard dimensions (e.g., pixels, points, inches).
  • 1.5 Items: Optionally count the number of objects within each artboard.

2. Allows Selection:

Single or multiple artboards can be selected directly from the list:

  • Single Click: Select a single artboard.
  • Shift + Click: Select a range of artboards.
  • Command/Ctrl + Click: Select non-consecutive artboards.
  • Cmd/Ctrl + A: Select all artboards in the list.
  • Double-Click: Automatically fits the selected artboard to the workspace view.

3. Supports Filtering and Sorting:

  • Artboards are dynamically updated based on filters or search criteria:
  • Filter by index, name, size, or orientation.
  • Refine the list in the Search Bar to focus on specific artboards.

ㅤㅤ


➋ Scope Dropdown

The Scope Dropdown (Select:) is a critical control in the Select by Artboards script that defines the range or “scope” of items to be selected based on their relationship with the chosen artboards.

 

1. Items Inside Artboards:

  • Selects only the objects that are entirely contained within the boundaries of the selected artboard(s).

Use Case: Ideal for isolating and working on artwork that fits neatly within the artboard without selecting overlapping or external elements.

2. Items Outside Artboards:

  • Selects objects that fall outside the boundaries of the selected artboard(s).

Use Case: Useful for identifying and managing stray or misaligned artwork that is outside the intended workspace.


➌ Select Button

The Select button in the Select by Artboards script is the primary action trigger that applies your specified selection criteria to the document. Once clicked, it executes the selection process based on the artboards chosen and the scope defined in the Scope Dropdown.

What the Select Button Does:

Executes the selection based on the current scope setting in the Scope Dropdown:

  • Items Inside Artboards: Selects all objects located entirely within the boundaries of the selected artboard(s).
  • Items Outside Artboards: Selects objects outside the boundaries of the selected artboard(s).

Provides feedback on the selection: a dialog indicates the total number of items selected.

What the Cancel Button Does:

The Cancel button in the Select by Artboards script provides a simple and effective way to exit the dialog without applying any changes or actions.


➍ Additional Options

The Select by Artboards script offers a range of auxiliary tools and features designed to enhance user control, improve efficiency, and streamline document management. These options extend the script’s functionality beyond item selection, allowing for a more tailored and productive workflow.

 

🅰 Dialog Resizing

The dialog window is resizable, enabling users to adjust its size to suit their screen layout and preference.

  • Click and drag the edges of the dialog to resize it.
  • Use the maximize button (macOS) to expand the dialog to full-screen mode.

Benefit: Improves usability on different screen sizes, allowing for better visibility of artboard lists and options.

🅱 Filter Dropdown

A dropdown menu that provides criteria for filtering artboards based on specific attributes.

 

Filter Options:

  • Artboard Index: Filter by numerical order (e.g., 1, 2, 3).
  • Artboard Name: Sort alphabetically by name.
  • Size (Width/Height): Filter based on dimensions in the current units.
  • Orientation:
    Landscape: Wider than tall.
    Portrait: Taller than wide.
    Square: Equal width and height.

Benefit: Allows users to focus on specific artboards relevant to their task.

ㅤA text field for quickly finding artboards by name or size.

  • Type keywords or numerical values to search.
  • Results update in real time, showing matching artboards in the list.

Benefit: Saves time when dealing with large documents containing numerous artboards.

🅳 Delete Empty Artboards

Removes all artboards in the document that contain no artwork.

  • Click the Delete Empty Artboards icon.
  • A confirmation prompt lists the empty artboards to be deleted.
  • If confirmed, the script deletes the empty artboards (if any).

Benefit: Keeps documents tidy by eliminating unused artboards, reducing clutter.

 

🅴 Fit Artboards to Artwork

Resizes artboards to snugly fit the artwork they contain, with optional margins.

  • Click the Fit Artboards to Artwork icon.
  • Specify the desired margin size in the prompt (e.g., pixels, mm, inches).
  • The script adjusts each artboard to enclose its artwork plus the margin.

Benefit: Ensures precise artboard sizes for exporting or organizing designs.

 

🅵 Count Items

Counts the total number of items on each artboard and displays the count in the artboard list.

  • Click the Count Items icon.
  • The script processes each artboard and calculates the number of items.
  • Displays the count next to each artboard in the list.

Benefit: Provides insights into the complexity of each artboard, helping manage content more effectively.

 

🅶 Access User Guide

Provides detailed documentation and resources related to the script.

  • Click the ☰ Guide icon.
  • Scroll a detailed instructions directly within the script dialog.


☻ Conclusion

The Select by Artboards script is a robust and user-friendly tool designed to enhance your Adobe Illustrator workflow by providing precision and efficiency in managing artboards and their contents. Whether you’re handling complex documents with numerous artboards or fine-tuning your design details, this script offers all the necessary features to streamline your process.

By leveraging the comprehensive functionalities of Select by Artboards, you can maintain better control over your Illustrator projects, simplify tedious tasks, and focus more on creativity. Whether you’re a designer, illustrator, or creative professional, this script empowers you to work smarter and achieve more.

Leave a comment

Select by Artboards

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 Select by Artboards.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 Select by Artboards.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 Select by Artboards script to run it.
    5. The Select by Artboards 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