Items Batch Renamer

Script for Adobe Illustrator

ㅤ

Overview

The Items Batch Renamer is a robust Adobe Illustrator script designed for efficiently renaming multiple items within a document. It offers a user-friendly interface for both individual and batch renaming, incorporating advanced features such as dynamic placeholders, sequential numbering, and intelligent item filtering. This powerful tool streamlines the renaming process, enhancing workflow efficiency and organization.

ㅤ

Key Features

• Rename multiple items simultaneously.
• Dynamic placeholders for automatic name generation.
• Sequential numbering with customizable options.
• Prefix and suffix support.
• Find and replace functionality.
• Search and filter capabilities.
• Support for nested items within groups.
• Preview changes before applying.
• Double-click to locate to items on canvas.

ㅤ

Installation

1. Download the Items Batch Renamer.jsx script file.

2. Place it in your Adobe Illustrator Scripts folder:

⮑ Mac: /Applications/Adobe Illustrator [Version]/Presets/<Language>/Scripts/

⮑ Windows: C:\Program Files\Adobe\Adobe Illustrator [Version]\Presets\<Language>\Scripts\

3. Restart Illustrator if it's already running.

ㅤ

Using the Script

• Open your Adobe Illustrator document.
• Select the items you want to rename (optional).
• Run the script by going to File > Scripts > Items Batch Renamer.
• The script window will display all items in your document or your current selection.

ㅤ

Interface Overview

The interface consists of several sections:

• Search bar at the top.
• Items list in the middle.
• Renaming options below.
• Action buttons at the bottom.

ㅤ

 

ㅤ

ㅤ

ㅤ

➊ Search Bar

The search bar in the Items Batch Renamer script has several useful features:

ㅤ

• Located at the top of the interface with the label "Search by name:"
• As you type, it instantly filters the list to show only items whose names contain the search text.
• The filtering is case-insensitive, so "logo" will match "Logo", "LOGO", etc.
• It searches within the current names of items, not their preview names.
• The search doesn't affect which items will be renamed - it only affects what's visible in the list.

ㅤ

ㅤ

---

➋ Items List

The items list is a central component of the Items Batch Renamer script that displays and manages the items to be renamed. Here are its key functions:

ㅤ

1. Display Structure:

The list shows multiple columns, including Item Number (#), Current Name, New Name, and Item Type.

Item Type uses icons to indicate the kind of object:

• 🅶 for Groups
• 🆃 for Text
• 🅼 for Mesh
• 🅲 for Compound Paths
• 🅿︎ for Paths
• 🆂 for Symbols
• 🆁 for Raster Images

ㅤ

2. Interactive Features:

• Supports multiple selections using Shift or Ctrl/Cmd + click.
• Double-clicking an item zooms to it in the document.
• Selection in the list can be used with "Rename only items selected in the list" option.

ㅤ

3. Preview Function:

• Shows current names alongside preview of new names.
• Updates in real-time as you modify naming options.

ㅤ

4. Item Organization:

• Can display nested items within groups when "Display items within groups" is checked.
• Shows items from either the entire document or just the current selection.

ㅤ

The list serves as both a preview and control interface, letting users see and manage rename operations before applying them.

ㅤ

ㅤ

---

➌ Renaming Options

The renaming section provides multiple tools for customizing how items will be renamed. Here's a breakdown of its features:

ㅤ

1. Main Name Field ("Enter new name:"):

• Primary input for the new name template.
• Supports dynamic placeholders like {n} for original name, {w} for width, {h} for height, etc.
• Updates the preview instantly as you type.

ㅤ

2. Number Sequence Option:

• Checkbox to enable sequential numbering.
• Customizable starting number (default: 1).
• Adjustable separator character.
• Option to reverse the numbering order (↕).

ㅤ

3. Prefix and Suffix Fields:

• Add text before (prefix) or after (suffix) the main name.
• Support the same placeholders as the main name field.
• Useful for adding consistent elements to all names.

ㅤ

4. Find and Replace:

• Search for specific text within names.
• Replace only the matched portions.
• Works in combination with other naming options.

ㅤ

All changes are previewed in real-time in the items list before applying, making it easy to fine-tune the naming structure before committing changes.

ㅤ

ㅤ

---

➍ Additional Features

ㅤ

Additional Checkboxes:

• Check the "Display items within groups" to show nested items.
• Check the "Rename only items selected in the list" for targeted renaming.

ㅤ

Using Dynamic Placeholders:

The script supports various placeholders that automatically insert item properties:

• {n} - Original item name
• {w} - Item width
• {h} - Item height
• {o} - Opacity percentage
  
• {b} - Blending mode
  
• {u} - Document units
  
• {fn} - File name
  
• {a} - Artboard name
  
• {l} - Layer name
  
• {d} - Current date
  
• {t} - Current time

ㅤ

Tip: Clicking the 'T' icon launches a dialog that displays a detailed help guide about dynamic placeholders.

ㅤ

Examples: 

1. Basic numbered sequence:

• Input: "Element" (+ Add number sequence)
• Result: "Element-1", "Element-2", "Element-3"

2. Size-based naming:

• Input: "Banner_{w}x{h}_{u}"
• Result: "Banner_1920x1080_px"

3. Date-stamped assets:

• Input: "{n}_approved_{d}"
• Result: "Logo_approved_2025-02-21"

4. Layer and artboard organization:

• Input: "{l}_{a}_v1"
• Result: "Header_Homepage_v1"

ㅤ

ㅤ

---

➎ Applying Changes

ㅤ

• Review the preview of new names in the list.
• Click "Rename" to apply the changes.
• A confirmation dialog will show the number of items renamed.

ㅤ

Tips and Best Practices

• Always preview changes before applying them.
• Use the search function to work with specific items.
• Utilize placeholders for consistent naming conventions.
• Group similar items before renaming for better organization.
• Double-check selections when using "Rename only items selected in the list".
• Remember that you can always access this guide by clicking the help icon ⏼ in the script dialog.

ㅤ

ㅤ

---

☻ Conclusion

The Items Batch Renamer is a versatile tool that streamlines the process of managing and organizing items in Adobe Illustrator documents. By combining dynamic placeholders, sequential numbering, and intelligent filtering, it offers a flexible solution for both simple and complex renaming tasks.

Whether you're organizing assets for a large project, standardizing file names, or updating a batch of items, this script provides the tools to do it efficiently while maintaining full control over the process. The real-time preview feature ensures accuracy, while the intuitive interface makes it accessible for users of all experience levels.

ㅤ

ㅤ