photoshop_place_image
Place an external image file as a new layer in the active document at absolute canvas coordinates (x/y), enabling precise compositing of assets into an open Photoshop document.
Instructions
Place an external image file as a new layer in the active document.
x/y are absolute canvas coordinates for the placed layer's top-left bound in pixels (0,0 = document top-left). They are NOT an offset from Photoshop's default centered Place.
Use when: compositing assets into an open document at a known position. Do NOT use when: opening a file as a new document — use photoshop_open_image.
Returns: placed layer name, bounds, and position.semantics = absolute_top_left. Preconditions: active document; file must exist. Side effects: adds a new layer.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"filePath": "<filePath>"
},
"name": "photoshop_place_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Absolute canvas X of the placed layer top-left, in pixels (default: 0) | |
| y | No | Absolute canvas Y of the placed layer top-left, in pixels (default: 0) | |
| filePath | Yes | Full path to the image file (JPEG, PNG, PSD, etc.) | |
| document_id | No | Optional Photoshop document id from photoshop_get_state / photoshop_list_documents. When set, the tool activates that document before running so a UI tab switch cannot retarget the edit. |