Images Report

Script for Adobe Photoshop
Latest update 8/4/2022, version 2.0

The script scans a folder of images and produces a report of details for each image found. Adobe Bridge provides some of the same details, but the script offers many more, output in formats that open in popular spreadsheet applications.

  • Option to include images in subfolders
  • Pixels per inch, pixels wide, pixels high
  • Color space and profile
  • Number of layers, groups, and masks
  • Number of alpha channels and paths
  • Background layer, spot channels, and keywords
  • Generate comma-separated values or tab-delimited text
  • Options to output JSON or XML
  • Open CSV in popular spreadsheet applications
Images Report

FREE to download
Please make a contribution

Many scripts are free to download thanks to the support of users. Help me keep developing new scripts by supporting my work. Click the button to make a contribution of any amount. Thank you.

This script came about for a couple of reasons. First, clients often ask if their images are enough resolution before the images are even placed in a document. To which I can only respond, “It depends.” If placed at the size of a postage stamp, most images probably have enough resolution. But that’s rarely the case. I wanted a means to get pixels dimensions of images into a spreadsheet so I can add a formula that shows the size in inches at 300 pixels per inch. I send that to the client and say, “Placed no larger than the sizes listed, yes, your images have enough resolution. Placed larger, no.” The second reason for the script is for when I get a batch of images to retouch and have no idea of their current state. If all JPEG, I know they’re flattened anyway. But sometimes I get TIFFs that could be flattened, or maybe not. And TIFFs can have adjustment layers, masks, and more. The script lets me get a feel for what I have to deal with. I imagine other users will find similar and other unforeseen uses for the script.

How-to Video

How to use the script

The interface has three sections: Images folder, Include, and Output. Set options as desired and click the OK button to begin. If a report file of the same name already exists, the user may choose to replace it. When processing is complete, the user is notified and presented with a button to open the report.

Section 1: Images folder

Folder — click the button to select a folder of images. All image files found in the folder are opened and examined.

Include subfolders — if enabled, images in all folders below the selected folder are also processed.

Section 2: Include

Each choice represents a column to include in the report. The order of columns in the report match the order shown on screen (order is across first, then down). Any choice unchecked is not included, and a column for it is omitted from the report.

File name — the image file name as it appears in the file system.

Base name — the file name without extension.

Extension — the file extension. This is useful to sort images by file type.

Pixels per inch — the number of pixels one inch represents.

Pixels wide — the width dimension of the image in pixels.

Pixels high — the height dimension of the image in pixels.

Color space — common examples include RGB, CMYK, Grayscale, and others.

Color profile — the ICC profile assigned to the image.

Layers — the number of layers the image contains. This does not include layer groups, counted by the next option.

Layer groups — the number of layer groups the image contains.

Masks raster — the number of raster masks the image contains.

Masks vector — the number of vector masks the image contains.

Alpha channels — the number of alpha channels the image contains.

Paths — the number of paths the image contains.

Clipping path — if a path is set to clipping path, the name of the path.

Background layer — if the bottom layer of the image is set to background, the column lists “yes”.

Spot channels — for each channel set to spot color, the channel names.

Keywords — the keywords from the image metadata.

Section 3: Output

CSV — report is output as comma separated values. To view as a spreadsheet, associate the CSV format with your preferred spreadsheet application, or use “Open with...” and select the application.

TXT — report is output as tab-delimited text.

JSON — report is output as JavaScript Object Notation.

XML — report is output as eXtensible Markup Language.

File — click the button to change the location and/or name of the report file. When the images folder is selected, the location defaults to the parent folder, and the name defaults to folder name plus “_Images Report” and the extension for the chosen output format.

Many scripts are free to download thanks to the support of users. Help me keep developing new scripts by supporting my work. Click the button to make a contribution of any amount. Thank you.
Images Report

For help installing scripts, see How to Install and Use Scripts in Adobe Creative Cloud Applications.

Also available for hire to program custom solutions. Contact William for more information.

IMPORTANT: by downloading any of the scripts on this page you agree that the software is provided without any warranty, express or implied. USE AT YOUR OWN RISK. Always make backups of important data.