About actions
An action is a series of tasks that you play back on a single file or a batch of files—menu commands, panel options, tool actions, and so on. For example, you can create an action that changes the size of an image, applies an effect to the image, and then saves the file in the desired format.
Actions can include steps that let you perform tasks that cannot be recorded (for example, using a painting tool). Actions can also include modal controls that let you enter values in a dialog box while playing an action.
In Photoshop, actions are the basis for droplets, which are small applications that automatically process all files that are dragged onto their icon.
Photoshop and Illustrator come with predefined actions installed that help you perform common tasks. You can use these actions as is, customize them to meet your needs, or create new actions. Actions are stored in sets to help you organize them.
You can record, edit, customize, and batch-process actions, and you can manage groups of actions by working with action sets.
Actions panel overview
You use the Actions panel (Window > Actions) to record, play, edit, and delete individual actions. This panel also lets you save and load action files.

- A.
- Action set
- B.
- Action
- C.
- Recorded commands
- D.
- Included command
- E.
- Modal control (toggles on or off)
Expand and collapse sets, actions, and commands
Click the triangle to the left of the
set, action, or command in the Actions panel. Alt-click (Windows)
or Option-click (Mac OS) the triangle to expand or collapse
all actions in a set or all commands in an action.Play an action on a file
Playing an action executes the action’s recorded commands in the active document. (Some actions require that you make a selection before playing; some can be executed on an entire file.) You can exclude specific commands from an action or play only a single command. If the action includes a modal control, you can specify values or use tools in a dialog box when the action pauses.
- If necessary, select objects on which to play the action, or open a file.
- Do one of the following:
(Illustrator) To play a set of actions, select the set name, and click the Play button
in
the Actions panel, or choose Play from the panel menu.To play an entire single action, select the action name, and click the Play button in the Actions panel, or choose Play from the panel menu.
If you assigned a key combination to the action, press that combination to play the action automatically.
To play only a part of an action, select the command from which you want to start playing, and click the Play button in the Actions panel, or choose Play from the panel menu.
To play a single command, select the command, and then Ctrl-click (Windows) or Command-click (Mac OS) the Play button in the Actions panel. You can also press Ctrl (Windows) or Command (Mac OS), and double-click the command.
In Photoshop, to undo an action, take a snapshot
in the History panel before you play an action, and then select
the snapshot to undo the action.Record an action
To
guard against mistakes, work in a copy: at the beginning of the
action before applying other commands, record the File >
Save A Copy command (Illustrator) or record the File >
Save As command and select As A Copy (Photoshop). Alternatively, in
Photoshop you can click the New Snapshot button on the History panel
to make a snapshot of the image before recording the action.
To resume recording in the same action,
choose Start Recording from the Actions panel menu. Insert nonrecordable tasks into actions
Not all tasks in actions can be recorded directly. For example, you can’t record commands in the Effects and View menus, commands that display or hide panels, and use of the Selection, Pen, Paintbrush, Pencil, Gradient, Mesh, Eyedropper, Live Paint Bucket, and Scissors tools.
To tell which tasks cannot be recorded, watch the Actions panel. If the name of the command or tool doesn’t appear after you perform the task, you may still be able to add the task using commands in the Actions panel menu.
To insert a nonrecordable task after you create
an action, select an item within the action after which you want
to insert the task. Then choose the appropriate command from the
Actions panel menu.Insert a nonrecordable menu command
Choose Insert Menu Item from the Actions panel menu.
Select the command from its menu, or begin typing the command name in the text box, and click Find. Then click OK.
Insert selection of an object
Enter a name for the object in the Note box of the Attributes panel before you start recording. (Select Show Note from the Attributes panel menu to display the Note box.)
When you record the action, choose Select Object from the Actions panel menu.
Enter the name of the object, and click OK.
Record optimization options for multiple slices in the Save For Web dialog box
Set the slice optimization options before you start
recording the action. Then press Alt (Windows) or Option (Mac OS)
and click Remember in the Save For Web dialog
box.
When you record the action, Illustrator will remember the settings.
Insert a stop
You can include stops in an action that let you perform a task that cannot be recorded (for example, using a painting tool). After you complete the task, click the Play button in the Actions panel to complete the action.
You can also display a short message when the action reaches the stop as a reminder of what needs to be done before continuing with the action. You can include a Continue button in the message box in case no other task needs to be done.
- Choose where to insert the stop by doing one of
the following:
Select an action’s name to insert a stop at the end of the action.
Select a command to insert a stop after the command.
- Choose Insert Stop from the Actions panel menu.
- Type the message you want to appear.
- If you want the option to continue the action without stopping, select Allow Continue.
- Click OK.
You can insert a stop when recording
an action or after it has been recorded.Change settings when playing an action
By default, actions are completed using the values specified when they were originally recorded. If you want to change the settings for a command within an action, you can insert a modal control. A modal control pauses an action so that you can specify values in a dialog box or use a modal tool. (A modal tool requires pressing Enter or Return to apply its effect—once you press Enter or Return, the action resumes its tasks.)
A modal control is indicated
by a dialog box icon
to
the left of a command, action, or set in the Actions panel. A red
dialog box icon
indicates
an action or set in which some, but not all, commands are modal.
You can’t set a modal control in Button mode.
Do one of the following:To enable a modal control for a command within an action, click the box to the left of the command name. Click again to disable the modal control.
To enable or disable modal controls for all commands in an action, click the box to the left of the action name.
To enable or disable modal controls for all actions in a set, click the box to the left of the set name.
Exclude commands from an action
You can exclude commands that you don’t want to play as part of a recorded action. You can’t exclude commands in Button mode.
- If necessary, expand the listing of commands in the action by clicking the triangle to the left of the action name in the Actions panel.
- Do
one of the following:
To exclude a single command, click to clear the check mark to the left of the command name. Click again to include the command.
To exclude or include all commands or actions in an action or set, click the check mark to the left of the action or set name.
To exclude or include all commands except the selected command, Alt-click (Windows) or Option-click (Mac OS) its check mark.
To indicate that some of the commands within the action are excluded, in Photoshop the check mark of the parent action turns red; in Illustrator the check mark of the parent action becomes dimmed.
Specify playback speed
You can adjust an action’s playback speed or pause it to help you debug an action.
Edit and rerecord actions
It is easy to edit and customize actions. You can tweak the settings of any specific command within an action, add commands to an existing action, or step through an entire action and change any or all settings.
Add commands to an action
- Do one of the following:
Select the action name to insert a new command at the end of the action.
Select a command in the action to insert a command after it.
- Click the Begin Recording button, or choose Start Recording from the Actions panel menu.
- Record the additional commands.
- When finished, click the Stop Playing/Recording button in the Actions panel or choose Stop Recording from the panel menu.
Rearrange commands within an action
In the Actions panel, drag a command
to its new location within the same or another action. When the
highlighted line appears in the desired position, release the mouse
button.Record an action again
- Select an action, and choose Record Again from the Actions panel menu.
- If a modal tool appears, use the tool to create a different result, and press Enter or Return, or just press Enter or Return to retain the same settings.
- If a dialog box appears, change the settings, and click OK to record them, or click Cancel to retain the same values.
Record a single task again
Select an object of the same type for which you want to rerecord the action. For example, if a task is only available for vector objects, you must have a vector object selected when you rerecord.
In the Actions panel, double-click the command.
Enter the new values and click OK.
Manage action sets
You can create and organize sets of task-related actions that can be saved to disk and transferred to other computers.
Load a set of actions
By default, the Actions panel displays predefined actions (shipped with the application) and any actions you create. You can also load additional actions into the Actions panel.
Do one of the following:Choose Load Actions from the Actions panel menu. Locate and select the action set file, and then click Load (Photoshop) or Open (Illustrator).
(Photoshop only) Select an action set from the bottom of the Actions panel menu.
Photoshop action set files have the extension .atn; Illustrator action set files have the extension .aia.
Restore actions to the default set
- Choose Reset Actions from the Actions panel menu.
- Click OK to replace the current actions in the Actions panel with the default set, or click Append to add the set of default actions to the current actions in the Actions panel.
Organize action sets
To help you organize your actions, you can create sets of actions and save the sets to disk. You can organize sets of actions for different types of work—such as print publishing and online publishing—and transfer sets to other computers.
To create a new set of actions, click the Create New Set button
in
the Actions panel or choose New Set from the panel menu. Then enter
the name of the set, and click OK. Note: If you plan to create a new action and group it in a new set, make sure you create the set first. Then, the new set will appear in the set popup menu when you create your new action.To move an action to a different set, drag the action to that set. When the highlighted line appears in the desired position, release the mouse button.
To rename a set of actions, double-click the name of the set in the Actions panel or choose Set Options from the Actions panel menu. Then enter the new name of the set, and click OK.
To replace all actions in the Actions panel with a new set, choose Replace Actions from the Actions panel menu. Select an actions file, and click Load (Photoshop) or Open (Illustrator).
Important: The Replace Actions command replaces all sets of actions in the current document. Before using the command, make sure that you have already saved a copy of your current set of actions using the Save Actions command.
Play an action on a batch of files
The Batch command lets you play an action on a folder of files and subfolders. You can also use the Batch command to populate a template for data-driven graphics with different sets of data.
Choose Batch from the Actions panel menu.
For Play, select the action you want to play.
For Source, choose the folder on which to play the action. Or select Data Sets to play the action on each data set in the current file.
If you select a folder, you can set additional options for playing the action.
For Destination, specify what you want to do with the processed files. You can leave the files open without saving the changes (None), save and close the file in their current location (Save And Close), or save the files to a different location (Folder).
Depending on the Destination option you select, you can set additional options for saving the files.
Specify how you want Illustrator to handle errors during the batch process. If you select Log Errors To File, click Save As, and name the error file.
Click OK.
Saving files using
the Batch command options always saves the files in the same format
as the original files. To create a batch process that saves files
in a new format, record the Save As or Save
A Copy command, followed by the Close command, as part of your original
action. Then choose None for the Destination when setting up the
batch process.
To batch-process using multiple
actions, create a new action, and record the Batch command for each
action you want to use. This technique also lets you process multiple
folders in a single batch. To batch-process multiple folders, create aliases
within a folder to the other folders you want to process.
Batch options
If you select Folder for Source, you can set the following options:
- Override Action “Open” Commands
- Opens the files from the specified folder and ignores any Open commands recorded as part of the original action.
- Include All Subdirectories
- Processes all files and folders within the specified folder.
If the action contains any save or export commands, you can set the following options:
- Override Action “Save” Commands
- Saves the processed files in the specified destination folder and not to a location recorded in the action. Click Choose to specify the destination folder.
- Override Action “Export” Commands
- Exports the processed files to the specified destination
folder and not to a location recorded in the action. Click Choose
to specify the destination folder.
If you select Data Sets for Source, you can set an option for generating filenames when overriding Save and Export commands:
- File + Number
- Generates the filename by taking the original document’s filename, removing any extension, and then appending a three‑digit number corresponding to the data set.
- File + Data Set Name
- Generates the filename by taking the original document’s filename, removing any extension, and then appending an underscore and the name of the data set.
- Data Set Name
- Generates the filename by taking the name of the data set.
, or
choose New Action from the Actions panel menu.
.