Layers Batch Renamer

Layers Batch Renamer

Script for Adobe Photoshop

Description

This is a comprehensive Adobe Photoshop script that allows you to batch rename layers in your documents with advanced customization options. The script provides a user-friendly interface with multiple renaming methods, flexible formatting options, and intelligent placeholders

Key Features

  • Rename individual layers or multiple layers at once
  • Filter layers with a search function.
  • Add number sequences with customizable separators.
  • Use find and replace to modify existing names.
  • Add prefixes and suffixes to layer names.
  • Incorporate dynamic placeholders like date, time, document name.
  • Support for layer groups and nested layers.
  • Preview changes before applying them.

Installation

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

Place the script in your Photoshop Scripts folder:

⮑ Mac: /Applications/Adobe Photoshop [Version]/Presets/Scripts/

⮑ Windows: C:\Program Files\Adobe\Adobe Photoshop [Version]\Presets\Scripts\

3. Restart Photoshop if it's already running.

4. Access the script via File > Scripts > Layers Batch Renamer

5. The script will open a dialog showing all layers in your current document.

 

Using the Script

➊ Selecting Layers

The layers list is a central component of the Layers Batch Renamer script that provides a visual representation of all layers in your Photoshop document. It offers several interactive features to help you manage and select layers for renaming. Here's a detailed breakdown of its functionality:

The list shows each layer in a multi-column format:

  • Layer Index (): Shows the layer's hierarchical index (e.g., "1", "1.1", "1.2")
  • Current Name: Displays the layer name with appropriate indentation and icons.
  • New Name: Previews the new name that will be applied. The script also shows an arrow (→) indicating that renaming will occur.

Interactive Features

  • Updates dynamically when using the search filter.
  • Displays layers in a hierarchical tree-like format.
  • Shows real-time previews of how layers will be renamed.
  • Double-clicking on a layer in the list selects that layer in Photoshop.

 

 

 

1.1 Filter Layers

Use the search box at the top to filter layers by name.

1.2 Select Layers

  • Click to select individual layers.
  • Ctrl/Cmd + click to select multiple non-contiguous layers.
  • Shift + click to select a range of layers.
  • Selected layers are highlighted with the system's selection color.

1.3 Browse Layers

Scroll through the list to view all available layers.

1.4 Rename Only Selected Layers

"Rename only selected layers" checkbox limits the preview and renaming to just selected items.

1.5 View Sublayers

"Display layer groups" checkbox toggles the visibility of group folders in the list

  • The script uses the "▼" symbol to identify layer groups.
  • The script uses the "⮑" symbol to identify sublayers within groups.

The layers list provides a comprehensive overview of your document's structure while enabling precise control over which layers get renamed and how they'll appear after the operation.

 

Clicking the {…} icon opens a dialog displaying a comprehensive help guide on dynamic placeholders.

This guide provides:

  • An overview of placeholders and their purpose.
  • Descriptions of each placeholder and its corresponding value.
  • Instructions on using placeholders for renaming layers.
  • Examples demonstrating placeholder usage.


➋ Renaming Options

The Renaming Options panel is the control center of the Layers Batch Renamer script, containing multiple tools and settings for customizing how your layers will be renamed. This panel is organized into several functional sections, each providing different ways to transform layer names. Here's a detailed breakdown of its functionality:

 

 

 

2.1 Enter Name Field

  • The primary input for specifying a new base name for selected layers.
  • Accepts plain text and placeholder tokens.
  • Can replace the entire layer name or be combined with other options.
  • If left empty, the original layer name will be preserved and only modified by other enabled options.

2.2 Number Sequence Options

Add number sequence checkbox:

  • When checked, automatically adds sequential numbers to layer names.
  • Enables related controls for customizing the sequence.

Reverse order toggle (↕):

  • Changes the direction of numbering.
  • When enabled, counts from highest to lowest instead of lowest to highest.
  • Useful for maintaining proper stacking order in certain workflows.

Separator input:

  • Defines the character(s) that separate the layer name from the number.
  • Default is a hyphen ("-").
  • Can be customized to any character or string (space, underscore, period, etc.).

Base index input: 

  • Sets the starting number for the sequence (default is 1).
  • Can be adjusted using the input field or arrow keys.

2.3 Prefix and Suffix Options

Prefix field:

  • Adds specified text to the beginning of layer names.
  • Accepts plain text and placeholder tokens.
  • Applied before any other naming changes.

Suffix field: 

  • Adds specified text to the end of layer names.
  • Accepts plain text and placeholder tokens.
  • Applied after the main name transformation.

2.4 Find and Replace Options

Find field:

  • Specifies text to search for within existing layer names.
  • Supports case-sensitive matching.
  • Searches all occurrences within a name.

Replace field:

  • Specifies the text that will replace found instances.
  • Accepts plain text and placeholder tokens.
  • Can be left empty to remove the found text.


➌ Using Placeholders

The placeholders in the Layers Batch Renamer script are dynamic tokens that can be inserted into any text field to create intelligent, context-aware layer naming systems. These placeholders are automatically replaced with specific values when the renaming is applied.

Available Placeholders

{n} - Original Layer Name

  • Inserts the original name of the layer.
  • Useful for preserving parts of existing names while adding additional information.
  • Example: "Button_{n}" would turn "Close" into "Button_Close".

{d} - Current Date

  • Inserts the current date in YYYY-MM-DD format.
  • Useful for versioning or tracking when layers were created/modified.
  • Example: "Logo_{d}" might become "Logo_2025-03-04".

{t} - Current Time

  • Inserts the current time in HH:MM format.
  • Useful for more precise timestamping.
  • Example: "Draft_{t}" might become "Draft_14:30"

{fn} - Document Filename

  • Inserts the name of the current Photoshop document.
  • Useful for maintaining consistency between layer names and the file they belong to.
  • Example: "Asset_from_{fn}" might become "Asset_from_Project_Mockup.ai".

{i} - Index Number (position in sequence)

  • Inserts the position number of the layer in the sequence.
  • Different from the number sequence feature as it's embedded within text.
  • Example: "Section_{i}_Header" might become "Section_3_Header".

{ir} - Reversed Index Number

  • Inserts the position number of the layer in the sequence.
  • Different from the number sequence feature as it's embedded within text.
  • Example: Bottommost layer in the layer's stack will be 1.

{p} - Full Layer Path (hierarchy)

  • Inserts the complete hierarchical path of the layer.
  • Includes all parent layers separated by ">" symbols.
  • Example: "{p}_Element" might become "Main Content > Navigation > Element".

Placeholder Guide

  • Accessible via the "{...}" button in the interface.
  • Provides detailed explanation of each placeholder with examples.
  • Shows sample outputs for different placeholder combinations.


➍ Applying Changes

Previewing Changes

  • As you configure renaming options, the list will update to show a preview of new names.
  • The arrow (→) indicates which layers will be renamed.
  • If "Rename only selected layers" is checked, only selected layers will show preview names.

Applying Changes

  • Review the preview to ensure the changes look correct.
  • Click the "Rename" button to apply all changes.
  • A confirmation dialog will display the number of layers successfully renamed.

Additional Features

  • Instant Updating: Any change to any field immediately updates the preview in the layers list.
  • Help Tips: Hover over any control to see a tooltip explaining its function.
  • Resizable Dialog: Click and drag the window’s edges to resize it.
  • Documentation: Click the icon in the bottom right corner for the full user guide.


☻ Final Notes

The Layers Batch Renamer script transforms how you manage layers in Adobe Photoshop by providing a comprehensive solution for renaming layers with precision and efficiency. Whether you're organizing complex designs, preparing files for handoff, or simply maintaining consistent naming conventions, this tool streamlines your workflow.

With its intuitive interface, you can easily select and filter layers, preview changes in real-time, and apply sophisticated naming patterns using dynamic placeholders and sequential numbering. The script respects Photoshop's layer structure, allowing you to work with both individual layers and layer groups while maintaining their hierarchical relationships.

Start incorporating this powerful tool into your Photoshop workflow today and experience the benefits of organized, consistently named layers in all your design projects.

Leave a comment

Layers Batch Renamer

Version: 1.0.0

Updated:

    • 1.0.0 – Initial release.

    Tested on MacOS:

    • Adobe Photoshop 2025 (26.0)
  • Supported Versions:

    • Compatible with Adobe Photoshop CS6 and later, including Adobe Photoshop 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 Photoshop

Adobe Photoshop is a leading image editing and graphic design software developed by Adobe Inc. Renowned for its versatility, Photoshop is used by photographers, designers, and digital artists for tasks ranging from photo retouching and compositing to digital painting and creating web graphics. Its robust set of tools includes advanced layering, masking, and blending options, as well as powerful filters, adjustments, and AI-driven features like content-aware fill. Photoshop supports both raster and vector workflows, making it ideal for a wide range of creative projects, including print, web, and multimedia design. As part of Adobe Creative Cloud, it integrates seamlessly with other Adobe apps.

  • 🅰 Locating the Scripts Folder

    To install a Layers Batch Renamer.jsx script in Adobe Photoshop, you need to place it in the correct directory where Photoshop
can recognize it. Follow these steps to locate the Scripts folder:

    1. MacOS:
      Open Finder and navigate to:
      /Applications/Adobe Photoshop [Version]/Presets/Scripts/
    2. Windows:
      Open File Explorer and navigate to:
      C:\Program Files\Adobe\Adobe Photoshop [Version]\Presets\Scripts\
    3. Replace <Version> with your Adobe Photoshop 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 Layers Batch Renamer.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 PhotoshopTo refresh the scripts menu, close and reopen Adobe Photoshop.

    Explore our complete guide to mastering Adobe Photoshop scripts.

    1. Open Adobe Photoshop 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 Layers Batch Renamer script to run it.
    5. The Layers Batch Renamer 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: Layout Grid Generator
    Layout Grid Generator

    Layout Grid Generator

    The Layout Grid Generator is a powerful Photoshop script that allows users to create customizable grid layouts using Photoshop's guide system. It provides a user-friendly interface for setting up precise margins, columns, and rows with real-time previews.

    Read more
  2. Read more: Layers Batch Renamer
    Layers Batch Renamer

    Layers Batch Renamer

    This is a comprehensive Adobe Photoshop script that allows you to batch rename layers in your documents with advanced customization options. The script provides a user-friendly interface with multiple renaming methods, flexible formatting options, and intelligent placeholders

    Read more