Grid Arranger

Grid Arranger

Script for Adobe Illustrator

Description

The Grid Arranger script is a powerful tool for Adobe Illustrator that helps users arrange selected objects in a customizable grid layout. It provides precise control over columns, rows, spacing, and alignment, with live preview functionality. The script is particularly useful for creating organized layouts, pattern designs, icon sets, and any work requiring precise object arrangement.

Key Features

  • Customizable grid dimensions (rows and columns)
  • Adjustable horizontal and vertical spacing (gutters)
  • Multiple sorting options for object arrangement
  • Alignment controls for both horizontal and vertical positioning
  • Interactive UI with sliders and numeric inputs
  • Live preview of changes
  • Random ordering option

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.

Using the Script

  • Select at least two objects in your Adobe Illustrator document
  • Run the Grid Arranger script from the File > Scripts menu.
  • The dialog window will appear with multiple options:

 

 

➊ Grid Configuration

The Grid section controls how your selected objects are arranged in rows and columns.
Here's a detailed breakdown of its functionality:

 

 

1.1 Columns

Enter the desired number of columns directly in the input field.

Use the slider to adjust the value.

Click the ▥ column icon to increment by 1.

The script automatically calculates the appropriate number of rows.

1.2. Rows

Enter the desired number of rows directly in the input field.

Use the slider to adjust the value.

Click the ▤ row icon to increment by 1.

The script automatically calculates the appropriate number of columns

Tip: You can use arrow keys for fine control: Up/Down: Change by 1; Shift + Up/Down: Change by 10.

The grid values update in real-time, and you can see the preview of your arrangement as you adjust these settings. This makes it easy to find the ideal grid configuration for your layout.


➋ Spacing Controls

The Gutter section controls the spacing and alignment between objects in your grid.
It has two main components:

 

 

2.1 Horizontal Spacing (↔︎)

Controls the space between columns.

Enter the desired horizontal spacing in pixels.

Use the slider for visual adjustment.

Click the horizontal spacing icon ↔︎ to increment by 1.

Negative values are supported for overlapping.

Select horizontal alignment: Left, Center, or Right.

Horizontal Alignment Options:

Left: Aligns objects to the left of their grid cells.

Center: Centers objects horizontally in their grid cells.

Right: Aligns objects to the right of their grid cells.

2.2 Vertical Spacing (↕︎)

Controls the space between rows.

Enter the desired vertical spacing in pixels.

Use the slider for visual adjustment.

Click the vertical spacing icon ↕︎ to increment by 1.

Negative values create overlapping.

Select vertical alignment: Top, Center, or Bottom.

Vertical Alignment Options:

Top: Aligns objects to the top of their grid cells

Center: Centers objects vertically in their grid cells

Bottom: Aligns objects to the bottom of their grid cells

The Gutter section provides precise control over object spacing and alignment, with immediate visual feedback as you adjust the settings. 


➌ Sorting Options

The Sorting Options section determines how objects are arranged within the grid.

Sort Items By Dropdown: Contains five sorting methods:

 

1. Position Y (Top to Bottom)

Arranges objects based on their vertical position.

Objects higher on the artboard go first.

Fills grid from top to bottom, left to right.

2. Position X (Left to Right)

Arranges objects based on their horizontal position.

Objects further left go first.

Fills grid from left to right, top to bottom.

3. Total Size (Largest Area First)

Arranges objects based on their total area (width × height).

Largest objects go first.

Useful for creating hierarchical layouts.

4. Width (Widest First)

Arranges objects based on their width only.

Widest objects go first.

Useful when width is the primary concern.

5. Height (Tallest First)

Arranges objects based on their height only.

Tallest objects go first.

Useful when height is the primary concern.


➍ Additional Options

Group: Create a group containing all arranged items.

Reversed Order: Reverse the sorting direction.

Random Order: Randomize item positions before arranging.

Additional Notes

All changes are previewed in real-time.

Preview updates automatically as you adjust settings.

Original positions are restored if you cancel.

Click the  icon at the bottom right side of the panel to open the script’s user guide online.


➎ Applying Changes

Click OK to apply the arrangement.

Click Cancel to revert to original positions.

Keyboard Shortcuts

Up/Down Arrow Keys: Fine-tune values in input fields.

Enter: Apply changes

Esc: Cancel and close dialog


☻ Final Notes

The Grid Arranger script streamlines the often tedious process of creating precise grid layouts in Adobe Illustrator.

Whether you're designing icon sets, creating pattern designs, or organizing complex layouts, this tool offers the flexibility and precision needed for professional results.

Leave a comment

Grid Arranger

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)

    Tested on Windows:

    • Adobe Illustrator 2025 (29.3)
  • 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

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 Grid Arranger.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 Grid Arranger.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 Grid Arranger script to run it.
    5. The Grid Arranger 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: Select Off-Artboard Objects
    Select Off-Artboard Objects

    Select Off-Artboard Objects

    This script for Adobe Illustrator helps you easily select objects that are either inside or outside the boundaries of your artboards. It's particularly useful for cleaning up designs by finding and managing stray objects outside your active work area.

    Read more
  2. Read more: Create Artboards from Selection
    Create Artboards from Selection

    Create Artboards from Selection

    This advanced Adobe Illustrator script automates the creation of artboards from selected objects. It's designed to streamline your workflow when you need to create multiple artboards based on existing design elements.

    Read more
  3. Read more: Paste to Replace
    Paste to Replace

    Paste to Replace

    The Paste to Replace script for Adobe Illustrator enables users to replace selected objects with clipboard content efficiently. It provides a user-friendly interface with options to maintain the original size, fit proportionally, or stretch to fit.

    Read more