# LayoutBridge for Adobe InDesign® (npm · layoutbridge-spm) layoutbridge-spm – MCP server for Adobe® InDesign®: pages, frames, text, styles, tables, export - Trust score: 60/100 (medium) - Registry status: active - Liveness: live - Owner verified: no - Last scored: 2026-09-27 ## Components - npm · `layoutbridge-spm`: 60/100 (this document), [markdown](https://verifymcp.io/servers/com-mcp-interfaces-layoutbridge-spm/layoutbridge-spm.md), [page](https://verifymcp.io/servers/com-mcp-interfaces-layoutbridge-spm/layoutbridge-spm) ## Channel facts - Registry: `npm` - Package: `layoutbridge-spm` - Version: `1.0.1` - Transport: `stdio` ## Trust breakdown How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog) Scored 2026-09-27. - **Supply Chain Security**: 98/100 - No malware found by supply-chain analysis. - No known CVEs affecting this package version or its production dependencies. - No install/post-install scripts declared. - 31 of 95 dependencies flagged as unhealthy. - **Provenance & Transparency**: 6/100 - Repository check failed: no source repository is declared. - Provenance check failed: no build-provenance attestation is published. - License check failed: the license (SEE LICENSE IN LICENSE) isn't a recognized OSI-approved license. - Actively maintained (last published 3 days ago). - Security-disclosure policy not yet verified: we couldn't inspect the source repository. - **Schema Quality & AI Usability**: 64/100 - AI-judged instruction clarity (excellent). - Context-footprint check failed: tool/resource definitions use about 37080 tokens (~337/item across 110 items; 110 tools + 0 resources), over budget; trim descriptions and params. - Usage-examples check failed: none of the tools include examples. - **Stability & Change Management**: 0/100 - Stability not yet verified: not enough scan history yet (needs a 30-day window). - **Tool Coverage**: 100/100 - 100% of tools have a non-trivial description (not blank, and not just the tool's name). - 100% of tool parameters carry a description. - **Tool Safety**: 100/100 - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured. - All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation. - An AI judge read all 110 captured unit(s) of tool text and found none that tries to manipulate the model reading it. - **Capabilities**: 100/100 - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28. **Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm. ## Install ### How do I install the LayoutBridge for Adobe InDesign® MCP server? LayoutBridge for Adobe InDesign® runs locally as an npm package, launched with npx -y layoutbridge-spm. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation. ### Claude ```bash claude mcp add com-mcp-interfaces-layoutbridge-spm -- npx -y layoutbridge-spm ``` ### Cursor ```json { "mcpServers": { "com-mcp-interfaces-layoutbridge-spm": { "command": "npx", "args": [ "-y", "layoutbridge-spm" ] } } } ``` ### VS Code ```json { "servers": { "com-mcp-interfaces-layoutbridge-spm": { "command": "npx", "args": [ "-y", "layoutbridge-spm" ] } } } ``` ### Codex ```bash codex mcp add com-mcp-interfaces-layoutbridge-spm -- npx -y layoutbridge-spm ``` ### opencode ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "com-mcp-interfaces-layoutbridge-spm": { "type": "local", "command": [ "npx", "-y", "layoutbridge-spm" ], "enabled": true } } } ``` ### OpenClaw ```bash openclaw mcp add com-mcp-interfaces-layoutbridge-spm --command npx --arg -y --arg layoutbridge-spm ``` ### Hermes ```yaml mcp_servers: com-mcp-interfaces-layoutbridge-spm: command: "npx" args: ["-y", "layoutbridge-spm"] ``` ### Netclaw ```json { "McpServers": { "com-mcp-interfaces-layoutbridge-spm": { "Transport": "stdio", "Command": "npx", "Arguments": [ "-y", "layoutbridge-spm" ] } } } ``` ### Vellum ```bash assistant mcp add com-mcp-interfaces-layoutbridge-spm -t stdio -c npx -a -y layoutbridge-spm ``` ### Other ```json { "mcpServers": { "com-mcp-interfaces-layoutbridge-spm": { "command": "npx", "args": [ "-y", "layoutbridge-spm" ] } } } ``` ## Changelog Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims. ### 2026-09-25 (score 60, 0) - [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server ### 2026-09-24 (score 60, +10) - [security improvement] Known CVEs: unverified → pass - [functional improvement] Dependency health: unverified → 0.85 ### 2026-09-23 (score 50) First indexed and scored. ## MCP tools (110) ### `get_app_version` (~51 tokens) InDesign version Return the version string of the running InDesign application. Use it as a sign of life before anything else. Fails with app_not_available when InDesign is not running or not ready yet. Read-only. ### `list_documents` (~64 tokens) List open documents List every open document, not just the frontmost one. Returns document_id (stable for this session), name, saved, path (empty when never saved), page_count and is_active. Read-only. Note: saved true is no reliable sign that there is nothing to save. ### `open_document` (~170 tokens) Open a document Open an existing .indd, .indt or .idml file. Returns document_id, name, page_count, facing_pages (Doppelseiten) and already_open, which is true when the file was open already – it is never opened twice. Because InDesign dialogs are suppressed, missing links (fehlende Verknuepfungen), out of date links and missing fonts (fehlende Schriften) come back as warnings; that is the only signal you get. Input parameters: - `open_copy` (boolean): Open an untitled copy and leave the file untouched. Default for .indt templates. - `path` (string, required): Real file path on the machine running InDesign. - `show_window` (boolean): Show the document window. Default true. Without a window the document is never the active one. ### `close_document` (~184 tokens) Close a document Close a document. save_changes is required and has no default, because InDesign save dialogs are suppressed. Pass path to save under a new name; it is required for a document that has never been saved when save_changes is "yes". Returns saved_to, had_unsaved_changes and the remaining document ids. Note: merely opening a document can already set had_unsaved_changes true. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `path` (string): Save-as target path. Required when save_changes is "yes" and the document was never saved. - `save_changes` (string, required): Required. "yes" saves before closing, "no" discards unsaved changes. ### `list_pages` (~123 tokens) List pages List the document pages. Per page: page_id, index (0-based), side (LEFT_HAND, RIGHT_HAND or SINGLE_SIDED), parent (the applied master page, "[None]" when there is none) and name, which is the printed page number. Read-only. Master pages themselves are listed by list_parent_pages. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… ### `get_page_state` (~307 tokens) Snapshot of one page Snapshot of one page: page_bounds_mm and every object on it with id, type (text, image, rectangle, ellipse, polygon, line, group, other), bounds_mm, paragraph_style when the whole frame uses one, a text_snippet of up to 200 characters, child_count, parent_group_id and layer_name (Ebene; see list_layers for locked or hidden layers). Nothing is skipped silently; unknown kinds come back as "other". Works for master pages too – take the page_id from list_parent_pages, the answer then carries is_parent_page true. All coordinates are millimetres from the top left corner of that page. Read-only. Careful: an object bleeding over the edge to the neighbouring page can show up with x = 210 instead of 0 – do not judge by coordinates alone, measure in the exported PDF. Returns coordinate_space "page": every bounds_mm is relative to the top left corner of this page and can be passed back to set_frame_bounds together with page_id. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_group_children` (boolean): Also list the objects inside groups, each with parent_group_id. Default true. - `page_id` (integer, required): Page to look at, from list_pages or list_parent_pages. ### `show_page` (~421 tokens) Show a page in the layout window Turn the layout window of the document to a page and fit it – for demonstrations, screen recordings and for checking a page by eye. Address the page by page_id (from list_pages, or a master page from list_parent_pages) or by page_name (the printed page number as list_pages shows it; with sections restarting the numbering the first match is shown with a warning). fit: page (default, centres the page), spread (the whole Druckbogen – InDesign then reports the left page of the spread as active_page, so compare active_spread_id), pasteboard, actual_size (100 %) or none (keep the current zoom); zoom (5–4000 percent) is applied after fit and overrides it. activate true brings the window to the front (default false – other documents stay where they are). Changes only the view, never the document. Fails with invalid_state when the document has no layout window (opened with show_window false). Returns page_id, page_name, is_parent_page, fit, zoom_percentage, view {active_page_id, active_page_name, active_spread_id, is_parent_page, zoom_percentage} read back, and previous_view. Tools that add pages (add_page, create_parent_page, place_text_file with autoflow) keep the view by default (keep_view). Input parameters: - `activate` (boolean): Bring the window to the front. Default false. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fit` (string): How to fit the view. Default page. - `page_id` (integer): Page to show, from list_pages or list_parent_pages. Either page_id or page_name. - `page_name` (string): Printed page number as list_pages shows it. Either page_id or page_name. - `zoom` (number): Zoom in percent (5–4000), applied after fit. ### `set_story_options` (~272 tokens) Story options (optical margin alignment) Read or set story-wide options of the story a text frame belongs to (frame_id names any frame of the story): optical_margin_alignment (optischer Randausgleich / hängende Interpunktion – punctuation and letter edges hang slightly outside the column edge, which makes justified edges look straight) and optical_margin_size_pt (the point size the alignment is calculated for; usually the body text size, 0.1–1296). Without parameters it is read-only. Returns story_id, frame_ids[] of the story in threading order, the two values after the change, previous {…}, changed[] and overset of the story. Optical margin alignment recomposes every line of the story – check get_frame_lines afterwards. get_frame_options shows the two values under text as well. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `optical_margin_alignment` (boolean): Switch optical margin alignment on or off for the whole story. - `optical_margin_size_pt` (number): Reference point size for the alignment, usually the body text size. ### `get_frame_lines` (~507 tokens) Lines of a text frame (composition) Read the composed lines of a text frame directly from InDesign, per text column – the basis for widow/orphan checks (Hurenkind, Schusterjunge), hyphen ladders, empty lines and the comparison of column starts, without a PDF export. Returns frame_id, story_id, frame_index (position of the frame in the story), page_id, column_count, line_count, columns[] {column_index, bounds_mm (from frame, inset, column count and gutter), line_count, first_baseline_mm, last_baseline_mm (mm from the top of the page), starts_with_last_line_of_paragraph (widow suspicion), ends_with_first_line_of_paragraph (orphan suspicion), starts_with_empty_line, consecutive_hyphens_max, ends_with_single_word, single_word_last_lines[], lines[] {index (in the column), start_index, end_index (story indices, end exclusive – usable in the *_to_range tools), baseline_mm, ascent_pt, descent_pt, left_mm, right_mm, paragraph_index (0-based in the story), is_first_line_of_paragraph, is_last_line_of_paragraph, paragraph_line_count (story-wide, so a paragraph continuing in the next frame is still counted whole), ends_with_hyphen, is_empty, word_count, last_char, text (only with include_text)}}, overset and truncated. Pitfalls: only composed text has lines – overset text has none; an automatic hyphen is not part of the text, so ends_with_hyphen is inferred when a line ends and the next line of the same paragraph begins with a letter; the last line of a paragraph that continues in the next frame is the last visible line here, not the last line of the paragraph (compare paragraph_line_count); lines inside tables are not Line objects and are not listed. Read-only. Returns coordinate_space ("page" or "spread") for the coordinates reported. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `include_text` (boolean): Also return the text of every line. Default false (figures only). - `max_lines` (integer): Cap for the lines returned over all columns. Default 500. ### `check_typography` (~713 tokens) Check typography rules (read-only) Find violations of general typesetting rules and report them – never change anything. The rule catalogue is a data table in the package (rules/typography-rules.json): character rules run as InDesign GREP searches (double_space, space_before_punct, straight_quotes, apostrophe, hyphen_as_dash, dash_spacing, three_dots, number_unit_space, number_unit_missing_space, abbreviation_space, thousands_grouping, empty_paragraph, double_paragraph_break, tab_as_indent, trailing_space); line rules run on the composed lines of every text frame like get_frame_lines (widow – Hurenkind, error; orphan – Schusterjunge, warning; heading_at_column_end; single_word_last_line; hyphen_ladder with max_consecutive_hyphens, default 3; empty_line_at_column_start; column_first_baselines_differ, more than 0.1 mm). locale de (default), de-CH (guillemets) or en (curly quotes, closed em dash, no space before %). scope document (default), frame or story (both need frame_id). rules[] limits to those ids, exclude_rules[] drops some; unknown ids are invalid_argument. Returns findings[] {rule_id, severity, category, message, story_id, frame_id, page_id, page_name, start_index, end_index (story indices for the *_to_range tools), snippet, suggestion (often a find_replace GREP pattern)}, counts per rule_id, rules_checked[], rules_failed[] (a GREP pattern InDesign rejected – warning, the rest runs), frames_checked, findings_dropped and truncated (max_findings caps only findings[]; every rule still runs and counts stays complete). Sources: Forssman/de Jong (Detailtypografie), Duden (Satz und Korrektur), DIN 5008, Bier (typokurz), Bringhurst (locale en). Not checked: spelling, grammar, content, text inside placed graphics; table cells are skipped in this version (warning tables_skipped). Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `exclude_rules` (array): Rule ids to skip. - `frame_id` (integer): Object id of a text frame for scope frame or story. - `include_locked_layers` (boolean): Also check frames on locked layers. Default false. - `include_master_pages` (boolean): Also check master pages. Default false. - `locale` (string): Rule language: de (default), de-CH or en. - `max_consecutive_hyphens` (integer): hyphen_ladder: allowed consecutive hyphenated lines. Default 3 (Forssman/de Jong). - `max_findings` (integer): Cap for findings[]. Default 500. - `min_last_line_chars` (integer): single_word_last_line: also report last lines shorter than this many characters. Default 0 = single words only. - `rules` (array): Rule ids to check. Default: every rule of the locale. - `scope` (string): document (default), frame (only the frame) or story (all frames of its story); frame and story need frame_id. - `severity_min` (string): Report only findings of this severity or above. Default info. ### `create_ellipse` (~768 tokens) Create an ellipse or circle Create an ellipse (Ellipse) as a frame without content on page_id at bounds_mm – the bounding rectangle without the stroke; width equal to height gives a circle. Colour, stroke, tint, gradient angle, text_wrap, layer_name and name as in create_rectangle: fill_hex / fill_swatch_name (colour, tint or gradient swatch), stroke_hex / stroke_swatch_name, stroke_weight_pt (a stroke colour without weight gets 1 pt with a warning), fill_tint_percent, stroke_tint_percent, gradient_fill_angle_deg (only with a gradient swatch), text_wrap none | bounding_box | object_shape (without it the document default – pass "none" when text lies underneath). Without colours the fill and stroke are [None] with 0 pt, so nothing prints. Returns frame_id, type "ellipse", bounds_mm, page_id, landed_on_page_id, landed_on_page_name, fill_color, fill_kind (none, color, tint, gradient), stroke_color, stroke_kind, stroke_weight_pt, fill_tint_percent, gradient_fill_angle_deg, text_wrap_mode, layer_name, swatch_ids (empty when only swatch names were used). Use place_image to put a picture into it. A timed-out call may still have created the object – check get_page_state before repeating. Input parameters: - `bounds_mm` (object, required): Position and size in mm from the top left corner of the page (or spread with coordinate_space "spread"). - `coordinate_space` (string): Reference for x/y: "page" (default) is the top left corner of page_id, identical on left and right pages; "spread" is the top left corner of the spread (Druckbogen) – the right page of a spread start… - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fill_hex` (string): Fill colour as hex, e.g. "#E30613". Creates an RGB swatch. - `fill_swatch_name` (string): Exact name of an existing swatch for the fill – colour, tint or gradient swatch (see list_swatches). Not together with fill_hex. - `fill_tint_percent` (number): Tint of the fill swatch in percent (0–100). - `gradient_fill_angle_deg` (number): Angle of a linear gradient fill in degrees (-180 to 180); only visible with a gradient swatch as fill. - `gradient_stroke_angle_deg` (number): Angle of a linear gradient stroke in degrees (-180 to 180); only visible with a gradient swatch as stroke. - `layer_name` (string): Existing layer to create the object on (see list_layers). Default: the active layer. - `name` (string): Object name (label), shown in InDesign's layers panel. - `page_id` (integer, required): Page from list_pages or list_parent_pages. - `stroke_hex` (string): Stroke colour as hex. Creates an RGB swatch. - `stroke_swatch_name` (string): Exact name of an existing swatch for the stroke (colour, tint or gradient). Not together with stroke_hex. - `stroke_tint_percent` (number): Tint of the stroke swatch in percent (0–100). - `stroke_weight_pt` (number): Stroke weight in points (1 pt with a warning when a stroke colour is given without it). - `text_wrap` (string): Text wrap of the new object: none, bounding_box or object_shape. Without it the document default applies – pass "none" when text lies underneath. ### `create_polygon` (~806 tokens) Create a polygon, star or free shape Create a polygon (Polygon): either a regular polygon or star from bounds_mm with sides (3–100; a triangle is sides 3) and star_inset_percent (0 = regular polygon, greater than 0 = star with the inner points inset by that percentage), or a closed free shape from points_mm[] (3–200 anchor points {x, y} in page coordinates, straight segments; an arrow is a points_mm shape) – exactly one of the two ways. Colour, stroke, tint, gradient angle, text_wrap, layer_name and name as in create_ellipse. Returns frame_id, type "polygon", bounds_mm, sides and star_inset_percent (null for a free shape), point_count, points_mm[] read back from the path (anchor points only), fill and stroke as create_ellipse, landed_on_page_id, landed_on_page_name, swatch_ids. Note: text wrap by object shape follows the polygon outline. A timed-out call may still have created the object – check get_page_state before repeating. Input parameters: - `bounds_mm` (object): Position and size in mm from the top left corner of the page (or spread with coordinate_space "spread"). - `coordinate_space` (string): Reference for x/y: "page" (default) is the top left corner of page_id, identical on left and right pages; "spread" is the top left corner of the spread (Druckbogen) – the right page of a spread start… - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fill_hex` (string): Fill colour as hex, e.g. "#E30613". Creates an RGB swatch. - `fill_swatch_name` (string): Exact name of an existing swatch for the fill – colour, tint or gradient swatch (see list_swatches). Not together with fill_hex. - `fill_tint_percent` (number): Tint of the fill swatch in percent (0–100). - `gradient_fill_angle_deg` (number): Angle of a linear gradient fill in degrees (-180 to 180); only visible with a gradient swatch as fill. - `gradient_stroke_angle_deg` (number): Angle of a linear gradient stroke in degrees (-180 to 180); only visible with a gradient swatch as stroke. - `layer_name` (string): Existing layer to create the object on (see list_layers). Default: the active layer. - `name` (string): Object name (label), shown in InDesign's layers panel. - `page_id` (integer, required): Page from list_pages or list_parent_pages. - `points_mm` (array): Anchor points of a closed free shape in mm (page coordinates), 3 to 200. Not together with bounds_mm/sides. - `sides` (integer): Number of sides for a regular polygon or points of a star (3–100). Needs bounds_mm. - `star_inset_percent` (number): 0 (default) = regular polygon; greater than 0 = star, inset of the inner points in percent. - `stroke_hex` (string): Stroke colour as hex. Creates an RGB swatch. - `stroke_swatch_name` (string): Exact name of an existing swatch for the stroke (colour, tint or gradient). Not together with stroke_hex. - `stroke_tint_percent` (number): Tint of the stroke swatch in percent (0–100). - `stroke_weight_pt` (number): Stroke weight in points (1 pt with a warning when a stroke colour is given without it). - `text_wrap` (string): Text wrap of the new object: none, bounding_box or object_shape. Without it the document default applies – pass "none" when text lies underneath. ### `set_corner_options` (~294 tokens) Corner options of a frame Set the corner shape and size (Eckenoptionen) of a rectangle, text or graphic frame or polygon – per corner or for all four: corner_type none | rounded | inverse_rounded | bevel | inset | fancy plus radius_mm for all corners, or corners {top_left, top_right, bottom_left, bottom_right} each {type, radius_mm} – missing corners stay. At least one of them. type "none" resets the corner (the radius stays stored but has no effect). Lines and groups are refused (invalid_state). Corner options do not change bounds_mm, only the visible shape; text wrap by object shape follows the corner. Returns frame_id, type, corners {top_left {type, radius_mm}, …} read back, uniform (all four equal) and bounds_mm. get_frame_options shows the same under corners. Input parameters: - `corner_type` (string): Corner shape for all four corners. - `corners` (object): Per-corner settings; corners that are left out keep their values. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `radius_mm` (number): Corner radius in mm for all four corners. ### `create_gradient_swatch` (~394 tokens) Create a gradient swatch Create a gradient swatch (Verlaufsfarbfeld) named name with type linear (default) or radial and stops[] (2–20, in order): each stop names exactly one of swatch_name (an existing colour or tint swatch – not a gradient or mixed ink), hex (creates an RGB swatch) or cmyk {c, m, y, k} (creates a CMYK swatch " Stopp "), plus location 0–100 (ascending; a first stop above 0 or a last below 100 gives a warning) and optional midpoint 13–87. on_collision error (default), update (rewrites type and stops of an existing gradient) or version (" 2"). The swatch is then used with fill_swatch_name / stroke_swatch_name in create_rectangle, create_ellipse, create_polygon, create_line and set_frame_appearance, and the angle with gradient_fill_angle_deg. Returns name, swatch_id, type, stops[] {index, swatch_name, location, midpoint} read back, stop_count, collision, existed, previous (with update), swatch_ids of new colour swatches. Note: gradients built from RGB swatches stay RGB – build print gradients from CMYK swatches; how the export renders them depends on the PDF preset. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `name` (string, required): Swatch name, exact; must not start with "[". - `on_collision` (string): What to do when the name exists. Default error. - `stops` (array, required): Colour stops in order. - `type` (string): Gradient type. Default linear. ### `set_frame_effects` (~503 tokens) Effects: opacity, blend mode, drop shadow, feather Set InDesign effects (Effekte) of an object for target object (default), fill, stroke or text (text only on text frames): opacity_percent (0–100), blend_mode (normal, multiply, screen, overlay, soft_light, hard_light, color_dodge, color_burn, darken, lighten, difference, exclusion, hue, saturation, color, luminosity), drop_shadow {enabled (required), opacity_percent, angle_deg, distance_mm, size_mm (0–50.08), spread_percent, noise_percent, color {swatch_name | hex}, blend_mode, use_global_light, knocked_out, honor_other_effects – omitted values keep InDesign's own defaults} and feather {enabled (required), width_mm (0–352.78), corner_type sharp | rounded | diffused, noise_percent, choke_percent}. At least one of them; unknown keys are refused (inner/outer glow, bevel, satin, directional and gradient feather are not in this version). Returns frame_id, type, target, effects {opacity_percent, blend_mode, drop_shadow {…, x_offset_mm, y_offset_mm}, feather {…}} read back and changed[]. opacity_percent 100, blend_mode normal, drop_shadow.enabled false and feather.enabled false restore the plain state. Pitfalls: every effect brings transparency into the document – a PDF/X-1a preset flattens it on export, PDF/X-4 keeps it (check preflight_document and export_pdf); blend modes look different in RGB and CMYK documents; a shadow on a group acts on the group as a whole. get_frame_options shows effects (object) and has_effects {fill, stroke, text}. Input parameters: - `blend_mode` (string): Blend mode (Mischmodus). - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `drop_shadow` (object): Drop shadow (Schlagschatten). Omitted values keep InDesign's defaults. - `feather` (object): Basic feather (weiche Kante). - `frame_id` (integer, required): Object id from get_page_state. - `opacity_percent` (number): Opacity (Deckkraft) 0–100. - `target` (string): Which part the effects apply to. Default object. ### `convert_text_to_outlines` (~277 tokens) Convert text to outlines (irreversible) Convert the text of a text frame into paths (in Pfade umwandeln) – a headline as a graphic, independent of installed fonts. Irreversible: there is no undo through this interface; confirm true is required. delete_original true (default) replaces the frame with the outlines; false keeps the text frame and puts the outlines on top of it. Refused (invalid_state): empty frames, threaded frames (the story runs over more than one frame), frames with overset text, frames on locked layers. Tables inside the frame give a warning – check the result. Returns frame_id of the new object, type (group or polygon), member_count, bounds_mm, page_id, page_name, source_frame_id, source_deleted, characters_converted and fonts_used[] {family, style}; warns that the text is no longer searchable or editable. Input parameters: - `confirm` (boolean, required): Required: true confirms the irreversible conversion. - `delete_original` (boolean): Remove the text frame after converting. Default true. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. ### `replace_font` (~591 tokens) Replace a font everywhere Replace every use of a font family (or one style of it) in the document by another installed font – InDesign's "find font / replace" as one call: in paragraph and character styles and in local formatting, on document and master pages. The standard step after open_document reports missing_fonts, and when a publication changes its typeface. from_family (required), from_style (optional: without it every style of the family is replaced, keeping the style name where it exists in the target family – styles that do not exist there are left alone with a warning listing available_styles); to_family (required, must be installed – otherwise not_found with available_styles), to_style (only with from_style; default the same style name). scope all (default) | styles_only | local_only. include_master_pages (default true), include_locked_layers (default false – stories on locked layers are skipped and listed in skipped_locked). dry_run true only counts. Never changes text. Returns from, to, styles_changed[] {kind, name, from_style, to_style}, runs_changed, characters_changed, stories_touched, remaining_occurrences (runs still using the old font – 0 when everything was reached; remaining_where lists up to 20), skipped_locked[], styles_missing_in_target[], overset_stories[] (InDesign recomposes every paragraph – check get_frame_lines) and dry_run. Pitfalls: style names are family-specific ("75 Bold" is not "Bold") – check them with get_font_info_at_index; a missing font exists in the document only as a name and is replaced through that name; composite fonts and text in placed graphics are not affected. InDesign names a family with a format suffix such as "Source Sans 3 (OTF)" or "(TT)" when it knows the family in more than one format; pass the family with or without that suffix – the connector matches both and reads back the name InDesign uses. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `dry_run` (boolean): Only count and locate, change nothing. Default false. - `from_family` (string, required): Font family to replace, e.g. the missing one from find_font_usage. - `from_style` (string): Only this style of the family. Without it all styles. - `include_locked_layers` (boolean): Also stories on locked layers. Default false. - `include_master_pages` (boolean): Also master pages. Default true. - `scope` (string): Styles and/or local formatting. Default all. - `to_family` (string, required): Installed target family. - `to_style` (string): Target style; only together with from_style. Default: the same style name. ### `replace_swatch` (~495 tokens) Replace a swatch everywhere Replace every use of a swatch (fills, strokes, text, paragraph, character and object styles, tables, gradient stops) with another existing swatch and remove the old one – InDesign's "delete swatch … replace with". Typical use: RGB swatches from a foreign document replaced by CMYK swatches created with create_swatch, or duplicate swatches merged. old_name or old_swatch_id (exact, as list_swatches shows it; built-in swatches cannot be replaced), new_name or new_swatch_id (must exist – colour, tint or gradient). delete_old true (default) lets InDesign replace everything and removes the old swatch; false only reassigns text runs, fills, strokes and paragraph/character styles by search and keeps the swatch (object styles, table styles and gradient stops then keep the old one – warning). dry_run true only counts. A swatch that serves as the base of a mixed ink can be refused by InDesign (invalid_state). Returns old {name, swatch_id, kind, space, values}, new {…}, deleted, usage_before {text_runs, fills, strokes, paragraph_styles, character_styles, object_styles, tables (null – not counted), gradients}, reassigned (with delete_old false), remaining_swatches and dry_run. A change of colour space (RGB to CMYK) is no colour management – the printed colour can differ; check the values with list_swatches first, and re-read list_swatches afterwards. Input parameters: - `delete_old` (boolean): Remove the old swatch after replacing. Default true. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `dry_run` (boolean): Only count the uses, change nothing. Default false. - `include_locked_layers` (boolean): Also change text on locked layers when reassigning by search. Default false. - `new_name` (string): Replacement swatch, by exact name (must exist). - `new_swatch_id` (integer): Replacement swatch, by id. - `old_name` (string): Swatch to replace, by exact name. - `old_swatch_id` (integer): Swatch to replace, by id from list_swatches. ### `create_document` (~333 tokens) Create a document Create a new document. Page size from preset (A4, Letter, Legal, Tabloid) or width_mm/height_mm, orientation portrait or landscape, pages (default 1), facing_pages (Doppelseiten, default true). margins_mm is required: { top, bottom, left, right } or { top, bottom, inside, outside } – for facing pages InDesign treats left as the inside margin (Bundsteg) and right as the outside margin. columns { count, gutter_mm } sets the column guides (Spaltenhilfslinien). Returns document_id and page_ids plus the page size InDesign actually set. The document is untitled until save_document. Note: if this call times out, the document may still have been created – check list_documents before repeating. Input parameters: - `columns` (object): Column guides: count and gutter (Spaltenabstand) in millimetres. - `facing_pages` (boolean): Facing pages (Doppelseiten). Default true. - `height_mm` (number): Page height in millimetres. Overrides the preset height. - `margins_mm` (object, required): Required. Margins (Stege) in millimetres: top/bottom plus left/right or inside/outside. - `orientation` (string): Swaps width and height when they do not match. Default portrait. - `pages` (integer): Number of pages. Default 1. - `preset` (string): Page size preset. Alternative to width_mm/height_mm. - `width_mm` (number): Page width in millimetres. Overrides the preset width. ### `save_document` (~131 tokens) Save a document Save the document. With path it is a save-as (Speichern unter); without path the document is saved in place. A document that has never been saved needs path, otherwise the call fails with io_error. Returns path as InDesign reports it afterwards. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `path` (string): Target file path for save-as. Required for a document that has never been saved. ### `export_pdf` (~445 tokens) Export as PDF Export the document (or a page_range) as PDF to path (the target file path – not output_path). Preset chain: preset (without it the localized built-in "High Quality Print" preset); when the result exceeds fallback_over_bytes it is exported again with fallback_preset (without both there is no second pass); a preset that does not exist falls back to the localized "High Quality Print" preset, then to the current export preferences, each with a warning. A spread preset turns single pages into spreads – check exported_page_count. The server configuration can hold default values for the three preset parameters; a parameter in the call always wins. page_range uses the printed page names as shown in InDesign ("6-8", "1, 3-5"; "+3" is the third page regardless of its name). Returns path, exported_page_count and document_page_count (page_count equals exported_page_count), bytes, preset_used and page_range_used. Pass fallback_over_bytes 0 or fallback_preset "" to disable the second pass. InDesign writes anywhere on the machine, also outside shared folders. Can take minutes on a full issue. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fallback_over_bytes` (integer): Size threshold in bytes for the second pass. Default: the configured value, otherwise 0 = no second pass. - `fallback_preset` (string): Preset for the second pass when the file exceeds fallback_over_bytes. Default: the configured preset, otherwise none. "" disables the second pass. - `page_range` (string): Pages to export, by printed page name, e.g. "6-8" or "1, 3-5". Default all. - `path` (string, required): Required. Target .pdf path on the machine running InDesign. - `preset` (string): PDF export preset name (exact, as listed in InDesign). Default: the configured preset, otherwise the localized "High Quality Print". ### `preflight_document` (~256 tokens) Run InDesign preflight Run InDesign's preflight (Preflight) with profile_name or, without it, the document's working profile (falls back to the first available profile when the working profile is invalid). Waits for the process, returns profile_used, summary ("None" when there are no errors), error_count and findings[] with category, description, page_name and item, capped by max_findings (1–500, default 100). With list_profiles_only true only profiles[] is returned. Read-only: the process is created, awaited and removed. Caveat: overset text (Übersatz) is not always reported with the right page – get_frame_text on the last frame of each story is the reliable check. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `list_profiles_only` (boolean): Only list the available profiles, run nothing. - `max_findings` (integer): Cap for findings[]. Default 100. - `profile_name` (string): Preflight profile to use. Default: the document's working profile. ### `document_text_defaults` (~262 tokens) Document text defaults Read or set the document's text defaults (Textvorgaben) – the font, style, size and paragraph style every new text frame inherits and that set_text writes as local formatting. Without parameters it is read-only. Each setter works on its own; a failing one lands in problems[] without aborting the others. font takes a family name as InDesign shows it or "Family\tStyle" with a tab; font_style the style name ("Bold"); point_size 0–1296; paragraph_style the style name (not style_name). Returns the values after the change: font, font_style, point_size, paragraph_style, character_style, changed_fields[] and problems[]. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `font` (string): Font family, or "Family\tStyle" with a tab character. - `font_style` (string): Font style name, e.g. "Regular", "Bold". - `paragraph_style` (string): Paragraph style name to use as default. - `point_size` (number): Size in points. ### `set_document_bleed` (~200 tokens) Set bleed and slug Set the document bleed (Anschnitt) and slug (Infobereich). bleed_mm and slug_mm each take a number (0–50, all edges) or an object with top/left/bottom/right; edges you leave out keep their value. Returns bleed_mm and slug_mm per edge plus bleed_uniform and slug_uniform. Independent of the bleed setting inside a PDF export preset. Read the current values with get_layout_grid. Input parameters: - `bleed_mm`: Bleed in millimetres: one number for all edges or { top, left, bottom, right }. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `slug_mm`: Slug in millimetres: one number for all edges or { top, left, bottom, right }. ### `add_page` (~283 tokens) Add a page Add a page at "start", at "end" (default) or relative to a page: { after_page_id } or { before_page_id } – not position or at_index. Returns page_id, index, name and spread_page_count of the spread (Druckbogen) the page landed on, with a warning when that spread now has more than two pages (with "allow pages to shuffle" off InDesign appends to the existing spread; repair with move_pages_to_new_spread). New pages do not inherit a master page – call apply_parent_to_page. The layout window keeps its view (keep_view, default true); pass keep_view false to let InDesign show the new page, or call show_page. Input parameters: - `at`: "start", "end", { after_page_id } or { before_page_id }. Default "end". - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `keep_view` (boolean): Restore the previous view (page and zoom of the layout window) afterwards – InDesign otherwise jumps to the new page. Default true; false lets the view move. The answer carries view_restored (null wh… ### `delete_page` (~571 tokens) Delete a page Delete a page. There is no undo. Master page objects and empty frames do not block (they are reported and go with the page); frames with text or images and threaded frames (verkettete Rahmen) block – the call then fails with invalid_state and lists them, and only force true deletes anyway. The only page of a document and master pages are always protected. Objects on the pasteboard (Montagefläche) belong to the spread, not to the page: when the spread goes with the page (the page is the only one of its spread), its pasteboard objects are listed before anything happens. When InDesign regroups the spreads (facing pages with "allow pages to shuffle"), pasteboard objects stay but can end up beside other pages. on_pasteboard_items decides: "warn" (default) deletes them with the page and warns, "abort" fails with invalid_state and details.code "pasteboard_items_present" (nothing deleted), "move" first moves them to the pasteboard of the spread of pasteboard_target_page_id (same position beside the pages; right stays right). Returns page_id, name, former_index, items_deleted, boilerplate_ignored and item_summary[]; also on_pasteboard_items, pasteboard_items[] {frame_id, type, spread_index, bounds_mm (spread coordinates), link_name, link_path, text_snippet}, pasteboard_moved_ids[], pasteboard_lost_ids[] (checked after deleting; a warning names every loss) and pasteboard_relocated[] {frame_id, spread_page_ids_before, spread_page_ids, spread_page_names_before (names before deleting), spread_page_names, spread_index, bounds_mm_before, bounds_mm, on_pasteboard} for pasteboard objects that now lie beside other pages or elsewhere (a warning names them); changes.removed_page_ids. Read list_pages again afterwards. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `force` (boolean): Delete even when frames with content or threaded frames are on the page. - `on_pasteboard_items` (string): What happens to pasteboard objects of a spread that goes with the page: "warn" (default) delete and warn, "abort" fail with details.code pasteboard_items_present, "move" move them to the spread of pa… - `page_id` (integer, required): Page to delete, from list_pages. - `pasteboard_target_page_id` (integer): Document page whose spread receives the pasteboard objects with on_pasteboard_items "move"; must lie on a spread that stays. ### `move_pages` (~448 tokens) Move pages Move a block of neighbouring pages (1–48 page_ids, direct neighbours) before or after reference_page_id, which must lie outside the block. allow_page_shuffle overrides "allow document pages to shuffle" for this call only. Warnings: moving an odd number of pages flips the left/right side of every page in between; with shuffle off the pages join the target spread, and spread_page_counts shows overfilled spreads – a spread with more than two pages is a warning that spells out the new spread division (Bogenaufteilung). InDesign holds at most 10 pages on a spread: when the target spread would exceed that, the call fails before anything moves (invalid_state, details.code "spread_page_limit" with spread_index and predicted_page_count). keep_spreads true rebuilds the spreads between the old and the new place as pairs afterwards (facing pages: left and right page together, each on its left/right side, starting like the first page of the document; single-sided: one page per spread; a page that does not end up on its expected side is a warning) – the new spreads keep their pages when pages shuffle later (like move_pages_to_new_spread). Returns moved_page_ids, names_before, names_after, page_count, spread_count, spread_page_counts[], pages[] {page_id, index, name, side, spread_index}, keep_spreads and spreads_rebuilt. Input parameters: - `allow_page_shuffle` (boolean): Override "allow document pages to shuffle" for this call only. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `keep_spreads` (boolean): Rebuild the affected spreads as pairs after moving. Default false (spreads stay as InDesign leaves them). - `page_ids` (array, required): Pages to move – direct neighbours in the page order. - `position` (string, required): Where relative to the reference page. - `reference_page_id` (integer, required): Page the block is placed before or after. Must not be part of the block. ### `move_pages_to_new_spread` (~222 tokens) Move pages to a new spread Take a run of pages (1–24 page_ids, not page_id) out of their spread (Druckbogen) into a new spread directly behind it – the page order stays, only the spread division changes. Repairs a three-page spread after add_page. The pages must lie on the same spread, be direct neighbours and must not be all pages of that spread. Shuffle is suspended for the call and the new spread is created with shuffle off. Returns moved_page_ids, names, new_spread_index, new_spread_page_count, source_spread_index, source_spread_page_count, spread_count and page_count. Read list_pages and get_layout_grid again afterwards. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `page_ids` (array, required): Pages to move into the new spread – same spread, direct neighbours, not all of them. ### `list_parent_pages` (~122 tokens) List master pages List the master spreads (Musterseiten): name ("A-Cover"), prefix, base_name, applied_to_page_ids[] and pages[] with page_id, index, side and item_count. Those page_ids make master pages readable and editable with get_page_state, set_text or find_replace (scope frame). Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… ### `create_parent_page` (~426 tokens) Create a master page Create a master spread (Musterseite) with base_name (1–60 characters) and name_prefix (one capital letter; InDesign picks the next free one when omitted). facing defaults to the document's facing-pages setting. page_count (1–10) sets the number of pages of the master spread directly – also in a single-sided document, where facing true alone still gives one page. based_on names an existing master (full name with prefix) the new one is based on (Musterseite basiert auf); "[None]" for none. Returns name, page_ids[], page_count and based_on ("[None]" when none). InDesign switches the layout window to the new master spread when it is created; keep_view (default true) puts the previous page and zoom back afterwards (view_restored) – pass keep_view false to stay on the master, or call show_page with one of the page_ids to work on it visibly. Input parameters: - `base_name` (string, required): Name without prefix, e.g. "Grundlayout". - `based_on` (string): Full name of the master this one is based on, e.g. "A-Grundlayout"; "[None]" for none. Default: none. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `facing` (boolean): Two-page master. Default: like the document. - `keep_view` (boolean): Restore the previous view (page and zoom of the layout window) afterwards – InDesign otherwise jumps to the new page. Default true; false lets the view move. The answer carries view_restored (null wh… - `name_prefix` (string): One capital letter. Default: next free letter. - `page_count` (integer): Pages of the master spread (1–10), also in a single-sided document. Overrides facing; a contradicting facing value is refused. ### `duplicate_parent_page` (~322 tokens) Duplicate a master page Duplicate a master spread (Musterseite duplizieren) with all its pages and objects: source_name is the full name with prefix (e.g. "A-Grundlayout"); base_name (1–60 characters) names the copy – without it the copy keeps the base name of the source; name_prefix (one capital letter) – without it InDesign picks the next free letter. The copy keeps the master it is based on. A full name that exists already is refused with invalid_state. Returns name, prefix, base_name, page_ids[], page_count, source_name, based_on, item_count and source_item_count (a warning when they differ). The layout window keeps its view (keep_view, default true). Input parameters: - `base_name` (string): Name of the copy without prefix. Default: the base name of the source. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `keep_view` (boolean): Restore the previous view (page and zoom of the layout window) afterwards – InDesign otherwise jumps to the new page. Default true; false lets the view move. The answer carries view_restored (null wh… - `name_prefix` (string): One capital letter. Default: next free letter. - `source_name` (string, required): Full name of the master to copy, with prefix, from list_parent_pages. ### `apply_parent_to_page` (~171 tokens) Apply a master page Apply the master spread parent_name (full name with prefix, e.g. "A-Footer") to page_id. "[None]", "none" or "Ohne" detaches the page from its master – an ad page loses header, footer line and page number in one step. Returns page_id and parent_applied as InDesign reports it afterwards. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `page_id` (integer, required): Page from list_pages (or a master page from list_parent_pages). - `parent_name` (string, required): Full master name with prefix, or "[None]" to detach. ### `override_parent_item_on_page` (~138 tokens) Override a master item Make a local copy of a master page object on page_id so it can be edited there. parent_item_id must lie on a master spread (take it from get_page_state on a master page). Returns frame_id of the new local object. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `page_id` (integer, required): Document page that shows the master item. - `parent_item_id` (integer, required): Object id on the master spread. ### `insert_page_number_marker` (~126 tokens) Insert page number marker Insert the automatic page number placeholder (Seitenzahl-Platzhalter) into text frame frame_id at position "start" or "end" (default end). Works on master page frames too. Returns frame_id and position. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Text frame to write into. - `position` (string): Default "end". ### `get_layout_grid` (~384 tokens) Layout grid (Satzspiegel) Read the type area (Satzspiegel) of every document page and, by default, every master page, plus document-wide values. Per page: page_id, name, spread_index, spread_page_count, spread_position, page_offset_in_spread_mm, parent, margins_mm (top, bottom, left, right; for facing pages also inside = left and outside = right – InDesign stores the inside margin (Bundsteg) as "left"), column_count, column_gutter_mm, type_area_mm {x, y, width, height} measured from the top left corner of that page, column_width_mm, columns_positions_mm (from the left edge of the type area; a two-column grid with 5 mm gutter on 170 mm reads [0, 82.5, 87.5, 170]) and custom_column_positions. Document-wide: distinct_grids[] {margins_mm, columns, gutter_mm, page_ids}, is_uniform, baseline_grid {start_mm, increment_mm, increment_pt, relative_to (top_of_page, top_of_margin or unknown), relative_to_raw, shown, view_threshold}, baseline_grid_check {first_line_mm, starts_at_type_area_top, lines_in_type_area, last_line_mm, remainder_below_mm} for the first document page, bleed_mm {top, left, bottom, right, uniform} and slug_mm. Warnings: bleed 0, baseline grid does not fit the type area, relative_to unknown. Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_parent_pages` (boolean): Also include master pages (Musterseiten). Default true. ### `set_layout_grid` (~427 tokens) Set margins and columns Set margins, column count and gutter on document pages and, by default, master pages, and redistribute the column guides evenly (relative to the type area). Whatever is omitted stays as it is. margins_mm takes top, left, bottom, right in mm – for facing pages "left" is the inside margin (Bundsteg) and "right" the outside margin. column_count 1–30, column_gutter_mm. page_ids[] limits the change to those pages (document or master pages); without it every page and the document defaults for new pages are changed – a client may block one call over all pages, so pass page_ids in blocks if needed. Optional baseline_grid {start_mm, increment_pt, relative_to: top_of_page | top_of_margin} sets the document baseline grid (Grundlinienraster). Moves only guides, never frames. Returns changed_pages[] {page_id, name, margins_mm, column_count, column_gutter_mm, type_area_mm, column_width_mm, columns_positions_mm} read back from InDesign, with a warning per page whose column positions do not lie on the even grid. A timed-out call may still have completed in InDesign – check with get_layout_grid before repeating. Input parameters: - `baseline_grid` (object): Document baseline grid (Grundlinienraster); document-wide, not per page. - `column_count` (integer): Number of columns, 1–30. - `column_gutter_mm` (number): Gutter (Spaltenabstand) in mm. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_parent_pages` (boolean): Also include master pages (Musterseiten). Default true. - `margins_mm` (object): Margins in mm; omitted edges stay. - `page_ids` (array): Pages to change (document or master pages). Without it: all pages plus the document defaults. ### `list_guides` (~184 tokens) List ruler guides List every ruler guide (Hilfslinie) of the document – not margin or column guides – from document spreads and, by default, master spreads, merged by id. Per guide: guide_id, orientation (horizontal or vertical), spread_index, is_parent_spread, page_id (null for a horizontal guide on a multi-page spread), page_name, position_spread_mm, position_page_mm, fit_to_page, locked, layer and color. Also guides_locked_globally, count_document and count_parent. Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_parent_pages` (boolean): Also include master pages (Musterseiten). Default true. ### `delete_guides` (~250 tokens) Delete ruler guides Delete ruler guides (Hilfslinien). Pass exactly one selection: guide_ids[] (from list_guides), page_ids[] (every guide on the spreads of those pages) or confirm_all true (every guide in the document); an empty call is refused. include_parent_pages (default true) also covers master spreads. Individual locks, "lock guides" and layer locks are lifted for the call and restored. Margin and column guides are never touched. There is no undo. Returns deleted[] {guide_id, orientation, position, page}, failed[] {guide_id, reason}, remaining_document and remaining_parent. Input parameters: - `confirm_all` (boolean): true deletes every guide in the document. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `guide_ids` (array): Guides to delete, from list_guides. - `include_parent_pages` (boolean): Also include master pages (Musterseiten). Default true. - `page_ids` (array): Delete every guide on the spreads that hold these pages. ### `create_text_frame` (~859 tokens) Create a text frame Create an empty text frame on page_id (document or master page) at bounds_mm {x, y, width, height}; x/y may be negative for bleed. initial_text is put in as one paragraph – "\n" becomes a forced line break, not a new paragraph; for real paragraphs create the frame empty and use set_text. The frame inherits the document text defaults, vertical justification and text wrap (Textumfluss): with wrap on, text frames underneath can be pushed into overset – pass text_wrap "none" to switch it off at creation, and vertical_justification "top" to pin the text to the top. Frame options (Textrahmenoptionen): first_baseline_offset sets the first baseline (Versatz erste Grundlinie: ascent, cap_height, leading, x_height, fixed, embox_top) with min_first_baseline_pt as the minimum in points; ignore_text_wrap true lets this frame ignore wrap of other objects (e.g. a caption over a picture with wrap); inset_mm sets the inset (Innenabstand) as one number or {top, left, bottom, right}. A one-line caption in a frame of exactly one grid line needs first_baseline_offset appropriate to the style (ascent or fixed) – otherwise it goes into overset. Returns frame_id, bounds_mm (read back, relative to the page it landed on), landed_on_page_id and landed_on_page_name (empty = pasteboard), and the frame options read back; a landing on another page is a warning, never a silent success. A timed-out call may still have created the frame – check get_page_state before repeating. Placeholders in the text become InDesign special characters (placeholders true, default): {{line_break}} (forced line break within the paragraph), {{nbsp}} (no-break space U+00A0), {{nbsp_fixed}} (fixed-width no-break space U+202F), {{thin_space}}, {{hair_space}}, {{soft_hyphen}} (discretionary hyphen), {{nb_hyphen}} (no-break hyphen), {{en_dash}}, {{em_dash}}, {{tab}}, {{column_break}}, {{frame_break}}, {{page_break}}. Unknown {{…}} stay as written with a warning; each placeholder is exactly one character in the story. Retur… Input parameters: - `bounds_mm` (object, required): Position and size in mm from the top left corner of the page (or spread with coordinate_space "spread"). - `coordinate_space` (string): Reference for x/y: "page" (default) is the top left corner of page_id, identical on left and right pages; "spread" is the top left corner of the spread (Druckbogen) – the right page of a spread start… - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `first_baseline_offset` (string): Position of the first baseline (Versatz erste Grundlinie). Default is the document default, usually ascent. - `ignore_text_wrap` (boolean): true: this frame ignores text wrap of other objects (Textumfluss ignorieren). - `initial_text` (string): Text for the frame, one paragraph; "\n" is a line break. Placeholders such as {{nbsp}} are expanded. - `inset_mm`: Inset (Innenabstand) in mm: one number for all edges or {top, left, bottom, right}; missing edges are 0. - `min_first_baseline_pt` (number): Minimum first baseline offset in points (Min. in the frame options). - `page_id` (integer, required): Page from list_pages or list_parent_pages. - `placeholders` (boolean): Expand {{…}} placeholders into special characters. Default true; false writes them literally. - `text_wrap` (string): "none" switches text wrap off for this frame. - `vertical_justification` (string): Vertical alignment of the text inside the frame. ### `create_image_frame` (~356 tokens) Create an image frame Create an empty graphic frame (Bildrahmen) on page_id at bounds_mm; x/y may be negative for bleed. By default fill and stroke are set to [None] and the stroke weight to 0 pt, so nothing prints around the picture (appearance_cleared true); keep_default_appearance true keeps the document defaults. The frame is set to fit a picture proportionally when place_image fills it later. Returns frame_id, bounds_mm, appearance_cleared, landed_on_page_id and landed_on_page_name; a landing on another page is a warning. If a 1 pt stroke still shows in an export, run set_frame_appearance with stroke_weight_pt 0. A timed-out call may still have created the frame – check get_page_state before repeating. Input parameters: - `bounds_mm` (object, required): Position and size in mm from the top left corner of the page (or spread with coordinate_space "spread"). - `coordinate_space` (string): Reference for x/y: "page" (default) is the top left corner of page_id, identical on left and right pages; "spread" is the top left corner of the spread (Druckbogen) – the right page of a spread start… - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `keep_default_appearance` (boolean): true keeps the document default fill and stroke. Default false = fill and stroke [None], stroke 0 pt. - `page_id` (integer, required): Page from list_pages or list_parent_pages. ### `create_rectangle` (~866 tokens) Create a rectangle Create a rectangle on page_id at bounds_mm (x/y may be negative) with optional fill_hex, stroke_hex, stroke_weight_pt (points), corner_radius_mm and corner_type, fill_tint_percent, stroke_tint_percent, gradient_fill_angle_deg, gradient_stroke_angle_deg, layer_name and name. Hex colours become RGB swatches named after the value ("#1A2B3C"), reused when they exist; their ids come back as swatch_ids. For print use the existing document swatches (CMYK) instead: fill_swatch_name / stroke_swatch_name take the exact name of an existing colour, tint or gradient swatch (see list_swatches, create_gradient_swatch); each excludes the corresponding hex parameter. Without fill_hex the fill is [None]; without stroke_hex and stroke_weight_pt the stroke is [None] with 0 pt. The rectangle inherits the document text wrap (Textumfluss) – pass text_wrap "none" to switch it off, or build borders from four create_line calls. Returns frame_id, page_id, swatch_ids, bounds_mm, fill_color, fill_kind (none, color, tint, gradient, mixed_ink), stroke_color, stroke_kind, tints, gradient angles, corner_type, corners, layer_name, landed_on_page_id and landed_on_page_name. A timed-out call may still have created the rectangle – check get_page_state before repeating. Input parameters: - `bounds_mm` (object, required): Position and size in mm from the top left corner of the page (or spread with coordinate_space "spread"). - `coordinate_space` (string): Reference for x/y: "page" (default) is the top left corner of page_id, identical on left and right pages; "spread" is the top left corner of the spread (Druckbogen) – the right page of a spread start… - `corner_radius_mm` (number): Corner radius in mm for all four corners. - `corner_type` (string): Corner shape (Eckenoptionen) for all four corners: none, rounded, inverse_rounded, bevel, inset, fancy. Default rounded when corner_radius_mm is greater than 0, otherwise none. Per-corner settings: s… - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fill_hex` (string): Fill colour as hex, e.g. "#E30613". Creates an RGB swatch. - `fill_swatch_name` (string): Exact name of an existing swatch for the fill – colour, tint or gradient swatch (see list_swatches). Not together with fill_hex. - `fill_tint_percent` (number): Tint of the fill swatch in percent (0–100). - `gradient_fill_angle_deg` (number): Angle of a linear gradient fill in degrees (-180 to 180); only visible with a gradient swatch as fill. - `gradient_stroke_angle_deg` (number): Angle of a linear gradient stroke in degrees (-180 to 180); only visible with a gradient swatch as stroke. - `layer_name` (string): Existing layer to create the object on (see list_layers). Default: the active layer. - `name` (string): Object name (label), shown in InDesign's layers panel. - `page_id` (integer, required): Page from list_pages or list_parent_pages. - `stroke_hex` (string): Stroke colour as hex. Creates an RGB swatch. - `stroke_swatch_name` (string): Exact name of an existing swatch for the stroke (colour, tint or gradient). Not together with stroke_hex. - `stroke_tint_percent` (number): Tint of the stroke swatch in percent (0–100). - `stroke_weight_pt` (number): Stroke weight in points (1 pt with a warning when a stroke colour is given without it). - `text_wrap` (string): Text wrap of the new object: none, bounding_box or object_shape. Without it the document default applies – pass "none" when text lies underneath. ### `create_line` (~430 tokens) Create a line Create a straight line on page_id from start_mm {x, y} to end_mm {x, y} (negative values allowed) with stroke_weight_pt (required, greater than 0, set in points – never in mm) and optional colour: swatch_name (exact name of an existing swatch, the right way for print – the document's CMYK swatches, see list_swatches) or stroke_hex (creates an RGB swatch); default Black. The line has no text wrap. Returns frame_id, page_id, start_mm, end_mm, stroke_weight_pt and stroke_color read back, swatch_ids, landed_on_page_id and landed_on_page_name. A timed-out call may still have created the line – check get_page_state before repeating. Input parameters: - `coordinate_space` (string): Reference for x/y: "page" (default) is the top left corner of page_id, identical on left and right pages; "spread" is the top left corner of the spread (Druckbogen) – the right page of a spread start… - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `end_mm` (object, required): End point in mm. - `gradient_stroke_angle_deg` (number): Angle of a linear gradient stroke in degrees; only visible with a gradient swatch. - `page_id` (integer, required): Page from list_pages or list_parent_pages. - `start_mm` (object, required): Start point in mm. - `stroke_hex` (string): Stroke colour as hex (creates an RGB swatch). Default Black. - `stroke_tint_percent` (number): Tint of the stroke swatch in percent (0–100). - `stroke_weight_pt` (number, required): Stroke weight in points, greater than 0. - `swatch_name` (string): Exact name of an existing swatch for the stroke. Not together with stroke_hex. ### `duplicate_frame` (~211 tokens) Duplicate an object Duplicate a text frame, image frame, rectangle, line or group (as a whole, placed graphics included) and shift the copy by offset_mm {x, y}. The duplicate stays on the spread (Druckbogen) of the original – to put it on another page use move_frame_to_page. Returns source_frame_id, frame_id of the duplicate, type, bounds_mm, landed_on_page_id and landed_on_page_name; the change report lists new_frames. A timed-out call may still have duplicated – check get_page_state before repeating. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object to duplicate, from get_page_state. - `offset_mm` (object): Shift of the copy in mm. Default {0, 0} = exactly on top of the original. ### `delete_frame` (~149 tokens) Delete an object Delete a text frame, image frame, rectangle, line or group (as a whole) by frame_id. A threaded text frame (verketteter Rahmen) takes its own text portion with it; the rest of the story stays in the other frames. There is no undo. Returns frame_id, type, was_threaded, characters_removed and removed_frame_ids (group members included). Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object to delete, from get_page_state. ### `clear_frame_content` (~153 tokens) Remove a placed graphic Remove the placed graphic from a frame and keep the frame itself – position, size, stroke, corners, object style and stacking order stay, for recycled layouts. Text is left untouched (use set_text with "" for that). Returns frame_id and graphics_removed (0 when the frame was empty already), plus removed_link_names. No undo for the removed graphic; the link on disk is not deleted. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Frame to empty, from get_page_state. ### `set_frame_bounds` (~408 tokens) Move or resize an object Move or resize an existing text frame, image frame, rectangle or line without rebuilding it: bounds_mm {x, y, width, height}. With page_id the values are relative to that page (x/y may be negative for bleed); without page_id they are spread coordinates (Druckbogen). Never changes the spread. Groups are refused (their graphics would stay behind) – use move_frame_to_page. A rotated object takes the values in its rotated space; set set_frame_rotation 0 first. Resizing an image frame crops: the picture keeps its position and scale inside the frame, so a smaller frame shows less of it (the way to trim a bleed picture to the trim edge, or to crop a photo without rescaling) – use scale_image_in_frame or fit_frame when the picture should follow the new frame instead. Returns frame_id, bounds_mm as InDesign reports them, landed_on_page_id and landed_on_page_name; a landing on another page is a warning. Returns coordinate_space ("page" with page_id, otherwise "spread"); a page change without page_id is a warning, because page-relative values read elsewhere shift the object by one page width when passed as spread coordinates. When the object carries a text wrap, the document is recomposed afterwards and recomposed, overset_stories_before, overset_stories_after and overset_changed report whether the overset state of the document changed. Input parameters: - `bounds_mm` (object, required): Position and size in mm from the top left corner of the page (or spread with coordinate_space "spread"). - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `page_id` (integer): Page the coordinates refer to (same spread). Without it: spread coordinates. ### `move_frame_to_page` (~477 tokens) Move an object to another page Move a text frame, image frame, rectangle, line or group to another page of the same document, keeping id, content, threading and links; graphics of a group travel with it (DOM move(), not bounds). position_mm {x, y} sets the top left corner relative to the new page; without it the object keeps the position it had on the old page. pasteboard {side, gap_mm, y_mm} puts the object on the pasteboard (Montagefläche) beside the spread of page_id instead: side left = left of the leftmost page of that spread, right = right of the rightmost page, gap_mm between object and page edge, y_mm the top edge relative to the page (default: as on the old page); not together with position_mm. The answer then carries on_pasteboard true and landed_on_page_id null; bounds_mm stay relative to page_id (negative x on the left side). Objects inside a group are refused. Returns frame_id, id_preserved (false only when InDesign needed duplicate-and-delete, then the id is new), landed_on_page_id, landed_on_page_name and bounds_mm. Careful: InDesign assigns an object to the page holding its centre – a half-page bleed object can stay on the neighbouring page (warning); then use set_frame_bounds without page_id. Rotated objects: set rotation 0 first. Returns coordinate_space "page"; when the object carries a text wrap the document is recomposed afterwards (recomposed, overset_stories_before, overset_stories_after, overset_changed). Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `page_id` (integer, required): Target page from list_pages or list_parent_pages. - `pasteboard` (object): Put the object on the pasteboard (Montagefläche) beside the spread of page_id instead of on the page. Not together with position_mm. - `position_mm` (object): Top left corner on the new page in mm. Default: same position as on the old page. ### `set_frame_rotation` (~164 tokens) Rotate an object Set the absolute rotation of an object in degrees (-360 to 360; positive = counterclockwise, as in InDesign; a portrait photo credit is -90; 0 straightens it). Rotates around the centre of the object. Returns frame_id, angle_deg read back and bounds_mm in the rotated space. Rule: draw frames unrotated, then rotate. Input parameters: - `angle_deg` (number, required): Absolute angle in degrees, positive counterclockwise. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. ### `set_frame_stacking` (~131 tokens) Change stacking order Change the stacking order (Stapelreihenfolge) of an object within its layer: bring_to_front, send_to_back, bring_forward or send_backward. Newly created objects always start on top. Returns frame_id and action. Input parameters: - `action` (string, required): Stacking action within the layer. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. ### `set_frame_appearance` (~569 tokens) Fill and stroke of an object Set fill, stroke colour and stroke weight of an object. fill and stroke take "#RRGGBB" (an RGB swatch is created or reused) or "none"; fill_swatch_name and stroke_swatch_name take the exact name of an existing colour, tint or gradient swatch instead (print: the document's CMYK swatches, see list_swatches, create_gradient_swatch) and each excludes the corresponding hex parameter. stroke_weight_pt is in points (0 or more). fill_tint_percent / stroke_tint_percent set the tint (0–100), gradient_fill_angle_deg / gradient_stroke_angle_deg the angle of a linear gradient (a warning when the swatch is no gradient). At least one parameter besides frame_id is required. Returns fill_kind and stroke_kind (none, color, tint, gradient, mixed_ink), the tints (null when none is set), the gradient angles and gradient_fill_start_mm / gradient_fill_length_mm as InDesign holds them. stroke "none" also sets the weight to 0, because [None] alone can resolve to black in localised documents – the reliable way to remove a stroke is stroke_weight_pt 0; check the export. Returns applied_fill, applied_stroke and applied_stroke_weight_pt read back from the object, plus swatch_ids of new swatches. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fill` (string): "#RRGGBB" or "none". - `fill_swatch_name` (string): Exact name of an existing swatch for the fill. Not together with fill. - `fill_tint_percent` (number): Tint of the fill swatch in percent (0–100). - `frame_id` (integer, required): Object id from get_page_state. - `gradient_fill_angle_deg` (number): Angle of a linear gradient fill in degrees (-180 to 180); a warning when the fill is no gradient swatch. - `gradient_stroke_angle_deg` (number): Angle of a linear gradient stroke in degrees (-180 to 180); a warning when the stroke is no gradient swatch. - `stroke` (string): "#RRGGBB" or "none" (also sets the weight to 0). - `stroke_swatch_name` (string): Exact name of an existing swatch for the stroke. Not together with stroke. - `stroke_tint_percent` (number): Tint of the stroke swatch in percent (0–100). - `stroke_weight_pt` (number): Stroke weight in points; 0 removes the stroke. ### `set_frame_columns` (~200 tokens) Columns inside a text frame Set the number of columns inside a text frame (not the page grid): count (1 or more; the parameter is count, not column_count) and gutter_mm (Spaltenabstand; without it the frame keeps its current gutter – InDesign's own default for new frames is 1 pica = 4.233 mm). Returns frame_id, count and gutter_mm read back. Fails with invalid_state for anything but a text frame. Input parameters: - `count` (integer, required): Number of columns inside the frame. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `gutter_mm` (number): Gutter between the columns in mm. Without it the current gutter of the frame stays. ### `set_frame_inset` (~234 tokens) Inset of a text frame Set the inset spacing (Innenabstand) of a text frame: inset_mm {top, left, bottom, right}, all four required, 0 or more; and/or the vertical justification (vertikale Ausrichtung, Textrahmenoptionen): vertical_justification top, center, bottom or justify. At least one of the two; what is omitted stays. Returns frame_id, inset_mm and vertical_justification read back (get_frame_options reads both under text). Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `inset_mm` (object): Inset in mm: { top, left, bottom, right }, all required. Optional when vertical_justification is given. - `vertical_justification` (string): Vertical justification of the text in the frame (vertikale Ausrichtung). Without it the frame keeps its setting. ### `set_text_wrap` (~233 tokens) Text wrap of an object Set the text wrap (Textumfluss) of an object: mode none, bounding_box, object_shape, jump_object or next_column, with an optional offset as offset_mm or offset_pt {top, left, bottom, right} (one of them, not both; object_shape uses only one distance). The reliable cure for text frames pushed into overset by a new frame is mode "none". Returns frame_id, mode and offset_mm read back. The document is recomposed afterwards; recomposed, overset_stories_before, overset_stories_after and overset_changed report whether the overset state of the document changed. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `mode` (string, required): Text wrap mode. - `offset_mm` (object): Wrap offset in mm. - `offset_pt` (object): Wrap offset in points. ### `thread_text_frames` (~180 tokens) Thread two text frames Thread (verketten) two text frames into one story: the text of source_frame_id continues in target_frame_id. Already threaded to each other = no-op (already_threaded true). Text already in the target is merged into the story after the source text (warning). A source that already continues elsewhere, or a target that already continues another frame, is refused with invalid_state. Returns source_frame_id, target_frame_id, story_id and story_character_count. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `source_frame_id` (integer, required): Frame whose text continues in the target. - `target_frame_id` (integer, required): Frame that receives the continuation. ### `place_image` (~508 tokens) Place an image or PDF Place an image or PDF file (real path on the InDesign machine) into a graphic frame, replacing whatever it held (crop and scale are reset – to merely swap the file use relink_links). fit: fill_proportionally, fit_proportionally, fit_content_to_frame or center_content; without it the frame fitting options of the frame apply. pdf_crop chooses the PDF page box: media (InDesign default – the whole sheet including printer marks, the usual reason for misplaced ads), crop, trim, bleed (for bleed ads), art or content; pdf_page picks the page (default 1). When the PDF has no such box (a QR code PDF without TrimBox, say), InDesign refuses – the tool then falls back to the next larger box (bleed → trim → crop → media) with a warning and reports pdf_crop_used; pdf_crop_fallback false turns that off and returns the io_error instead. The place preferences are set for this call only and restored. Returns frame_id, link_status, frame_bounds_mm, graphic_bounds_mm, pdf_crop_used and fits_frame (true when the graphic covers the frame within 0.2 mm; otherwise a warning); a warning when the effective resolution is below min_ppi. A changed CropBox of a PDF is ignored by InDesign; for asymmetric bleed derive a placement copy of the PDF. A timed-out call may still have placed – check get_image_link_info before repeating. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fit` (string): Fitting after placing. - `frame_id` (integer, required): Object id from get_page_state. - `image_path` (string, required): Real file path of the image or PDF on the machine running InDesign. - `min_ppi` (number): Effective resolution in ppi below which a warning is given. Default: the configured value, otherwise 300 (the usual offset print value: twice the 150 lpi screen). - `pdf_crop` (string): PDF page box to import. InDesign default media. - `pdf_crop_fallback` (boolean): Fall back to the next larger PDF box with a warning when the requested box is missing. Default true. - `pdf_page` (integer): Page of a multi-page PDF. Default 1. ### `scale_image_in_frame` (~254 tokens) Scale a placed graphic Scale the graphic inside a frame by zoom_factor (greater than 0; 1.2 = 20 % larger) around an anchor of the frame (center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right; default center). Frame and crop stay. Returns graphic_bounds_mm, frame_bounds_mm and effective_ppi after the zoom (warning below min_ppi; PDFs report none). Input parameters: - `anchor` (string): Anchor of the frame that stays fixed. Default center. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `min_ppi` (number): Effective resolution in ppi below which a warning is given. Default: the configured value, otherwise 300 (the usual offset print value: twice the 150 lpi screen). - `zoom_factor` (number, required): Scale factor, e.g. 1.2 for 20 % larger, 0.9 for 10 % smaller. ### `position_image_in_frame` (~307 tokens) Position a placed graphic Move the graphic inside a frame without scaling it; the frame stays as it is (frame bounds, crop edges and page). align puts the graphic's reference point onto the same reference point of the frame (center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right – e.g. top_left: upper left corners meet, center: centred); offset_mm {x, y} then shifts it by x/y mm (positive = right/down). Pass align, offset_mm or both. Returns frame_id, graphic_id, align, offset_mm, moved_by_mm {x, y}, graphic_bounds_mm, graphic_bounds_before_mm and frame_bounds_mm (relative to page_id, coordinate_space "page"; "spread" on the pasteboard) and fits_frame – a warning when the graphic no longer covers the frame. To change the size use scale_image_in_frame or fit_frame. Input parameters: - `align` (string): Reference point of graphic and frame that are brought together (one of nine). - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `offset_mm` (object): Shift in mm after align (or from the current position): positive x to the right, positive y down. ### `get_image_link_info` (~201 tokens) Graphic and link details of a frame Read every graphic in a frame: file_name, file_path, link_status (NORMAL, MISSING, OUT_OF_DATE, EMBEDDED), effective_ppi, actual_ppi, color_space (CMYK, RGB, GRAY …), image_type, frame_bounds and graphic_bounds in mm relative to the page. For placed PDFs InDesign reports neither ppi nor colour space – the entry carries an err hint, no error. frame_bounds and graphic_bounds drifting apart by exactly one distance points to a wrong group move. Read-only. Returns coordinate_space ("page" or "spread"): frame_bounds and graphic_bounds are relative to page_id. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. ### `list_links` (~168 tokens) List links List the links (Verknuepfungen) of the document, optionally filtered by path_contains (substring of path or file name, case-insensitive). Per link: link_id, file_name, file_path, status (NORMAL, LINK_MISSING, LINK_OUT_OF_DATE, EMBEDDED), page_id, page_name and frame_id. Also count. Use it to match pictures to articles by page number or to spot motifs of old issues by file name. Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `path_contains` (string): Substring of the file path or name. ### `relink_links` (~180 tokens) Relink links to new files Point links to new files with InDesign's own relink: relink[] {link_id, new_path}, 1 to 500 entries – frame, placement, scale and crop stay. Unknown ids, missing files and a new path equal to the current one (use update_links then) fail individually; the rest runs. Returns results[] {link_id, ok, status_after, reason, new_link_id}, relinked and failed. A 0-byte file is usually a cloud placeholder that is not downloaded yet. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `relink` (array, required): Links to relink with their new file paths. ### `update_links` (~155 tokens) Update out-of-date links Update links whose file changed on disk ("Verknuepfung aktualisieren"): link_ids[] (1 to 500) or, without it, every LINK_OUT_OF_DATE link. Ids that are not out of date come back as "nothing to do", no error. Returns results[] {link_id, name, page_name, status_before, status_after}, updated, failed and considered. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `link_ids` (array): Links to update. Default: all out-of-date links. ### `get_frame_text` (~415 tokens) Read the text of a frame Read the story of a text frame: story_id, story_length, paragraphs[] {index, start_index, end_index (exclusive, without the break), end_index_incl_break, paragraph_style, text, is_empty, break_type (paragraph, column, frame, page, odd_page, even_page or none for the last paragraph)} and overset for this frame. Column breaks count like paragraph marks; zero-width characters (U+FEFF) are returned as they are. For a threaded frame the whole story is returned, with frame_start_index and frame_end_index marking this frame's portion – pass only_frame_portion true to get only the paragraphs in this frame (text clipped at the frame boundaries, clipped_start/clipped_end mark the cut), and max_chars to cap the text returned (truncated true, paragraphs_omitted counts the rest). Indices always refer to the whole story, so they can be used with set_text_in_range and the *_to_range tools. Read-only. There is no include_overset parameter. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `max_chars` (integer): Budget for the text returned across all paragraphs; the rest is counted in paragraphs_omitted. - `only_frame_portion` (boolean): true: only the paragraphs shown in this frame, text clipped at its boundaries. Default false = whole story. - `show_placeholders` (boolean): Show special characters in text as {{…}} placeholders (line_break, nbsp, nbsp_fixed, thin_space, hair_space, soft_hyphen, nb_hyphen, en_dash, em_dash, tab, column_break, frame_break, page_break). Def… ### `set_text` (~381 tokens) Replace the text of a frame Replace the whole story of a text frame (really replace, never append): text with real line breaks as paragraph marks ("\n" or "\r\n" in the parameter become paragraph returns; U+2028 stays a forced line break). "" empties the frame. The text takes the document text defaults as local formatting – apply a paragraph style afterwards with apply_paragraph_style_to_range over the whole story. For a threaded frame the entire story across all frames is replaced (warning). Returns frame_id, character_count read back and overset. Placeholders in the text become InDesign special characters (placeholders true, default): {{line_break}} (forced line break within the paragraph), {{nbsp}} (no-break space U+00A0), {{nbsp_fixed}} (fixed-width no-break space U+202F), {{thin_space}}, {{hair_space}}, {{soft_hyphen}} (discretionary hyphen), {{nb_hyphen}} (no-break hyphen), {{en_dash}}, {{em_dash}}, {{tab}}, {{column_break}}, {{frame_break}}, {{page_break}}. Unknown {{…}} stay as written with a warning; each placeholder is exactly one character in the story. Returns placeholders_replaced {name: count} and placeholders_unknown[]. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `placeholders` (boolean): Expand {{…}} placeholders into special characters. Default true; false writes them literally. - `text` (string, required): New text; line breaks become paragraph marks, {{line_break}} a forced line break; "" empties the frame. ### `set_text_in_range` (~613 tokens) Replace a character range Replace characters start_index (inclusive) to end_index (exclusive) of the story of a text frame with text; start == end inserts, text "" deletes the range. The new text keeps the formatting of the first replaced character up to its first paragraph mark (keep_format_of "start", default) – also when the range begins a paragraph that follows a paragraph with other formatting; every further new paragraph takes the formatting and paragraph style of the replaced paragraph at the same position (beyond the last one: of the last replaced paragraph). If the range begins with a paragraph mark, the paragraphs merge and the new text continues that paragraph in its formatting. The right way for formatted placeholders and for a full swap (0 to story_length). keep_format_of "before" leaves the choice to InDesign (the range is replaced in one step); "none" removes character style and local character formatting from the new text, so it shows its paragraph style. An insertion (start == end) takes InDesign's formatting of the insertion point unless keep_format_of is "none". An empty line is two line breaks. Indexes come from get_frame_text. Returns frame_id, replaced_chars, inserted_chars, story_length and keep_format_of. Placeholders in the text become InDesign special characters (placeholders true, default): {{line_break}} (forced line break within the paragraph), {{nbsp}} (no-break space U+00A0), {{nbsp_fixed}} (fixed-width no-break space U+202F), {{thin_space}}, {{hair_space}}, {{soft_hyphen}} (discretionary hyphen), {{nb_hyphen}} (no-break hyphen), {{en_dash}}, {{em_dash}}, {{tab}}, {{column_break}}, {{frame_break}}, {{page_break}}. Unknown {{…}} stay as written with a warning; each placeholder is exactly one character in the story. Returns placeholders_replaced {name: count} and placeholders_unknown[]. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `end_index` (integer, required): End of the range (exclusive); equal to start_index inserts. - `frame_id` (integer, required): Object id from get_page_state. - `keep_format_of` (string): Formatting of the new text: "start" (default) the first replaced character up to the first new paragraph mark, then paragraph by paragraph the replaced paragraph at the same position; "before" whatev… - `placeholders` (boolean): Expand {{…}} placeholders into special characters. Default true; false writes them literally. - `start_index` (integer, required): First character to replace (inclusive). - `text` (string, required): Replacement text; "" deletes. Placeholders such as {{nbsp}} are expanded. ### `find_replace` (~395 tokens) Find and replace text Find and replace text in the document or in one frame: find, replace, mode literal or grep (default literal), scope document or frame (frame needs frame_id), include_master_pages, include_hidden_layers, include_locked_layers (all default false), case_sensitive and whole_word (default false). dry_run true only counts and lists up to 200 matches with frame_id, page_name and index – use it before any name replacement. GREP metacharacters: ~M column break, ~R frame break, ~P page break, ~S non-breaking space (a literal U+00A0 is not found in literal mode); a straight " in GREP matches every quote, including typographic ones. Returns replacements, matches_found, scope, mode and master_pages_included. No undo. Input parameters: - `case_sensitive` (boolean): Literal mode: match case. Default false. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `dry_run` (boolean): true: count and list matches, change nothing. - `find` (string, required): Text or GREP pattern to find. - `frame_id` (integer): Frame for scope "frame". - `include_hidden_layers` (boolean): Also search hidden layers. Default false. - `include_locked_layers` (boolean): Also search locked layers and stories. Default false. - `include_master_pages` (boolean): Also search master pages. Default false. - `mode` (string): literal (default) or grep. - `replace` (string): Replacement text; required unless dry_run is true. "" deletes the matches. - `scope` (string): document (default) or frame (needs frame_id). - `whole_word` (boolean): Literal mode: whole words only. Default false. ### `list_paragraph_styles` (~222 tokens) List paragraph and character styles List the paragraph styles (Absatzformate) of the document, including those in style groups: styles[] {name, style_id, group ("" at top level, "Group/Subgroup" nested), based_on, font_family, font_style, point_size, leading_pt (null when automatic), leading_auto, fill_swatch, alignment, space_before_pt, space_after_pt, hyphenation, tracking, keep_options, hyphenation_options, justification_options} and the character styles (Zeichenformate) as character_styles[] {name, style_id, group, based_on, font_family, font_style, point_size, fill_swatch, tracking – null for attributes the style does not set}. Internal styles whose name starts with "[" are excluded (internal_styles_excluded counts them). Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… ### `define_paragraph_style` (~1230 tokens) Define a paragraph style Create a paragraph style (Absatzformat) with name and any of font_family, font_style (exact InDesign style name, e.g. "75 Bold"), size_pt, leading_pt (points or "auto"), alignment (left, center, right, justify = Blocksatz with the last line left), color_hex (creates an RGB swatch named after the hex value) or swatch_name (an existing swatch by exact name – the way to a CMYK or spot colour; not together with color_hex), space_before_pt, space_after_pt, tracking (Laufweite in 1/1000 em), hyphenation, and the option groups keep_options (Umbruchoptionen: keep_with_next, keep_first_lines, keep_last_lines, keep_lines_together, keep_all_lines_together, keep_with_previous, start_paragraph), hyphenation_options (Silbentrennungseinstellungen) and justification_options (Blocksatz-Abstände, composer). Indents in mm: left_indent_mm, first_line_indent_mm (negative for a hanging indent, never further left than the left indent), right_indent_mm, last_line_indent_mm. tab_stops[] {position_mm, alignment left|center|right|character, leader, align_on} replaces the whole tab list ([] clears it); language selects the dictionary by the name InDesign shows, its untranslated name or an ICU locale (de_DE, en_GB – the safest form). The answer reads them back under indents {left_indent_mm, first_line_indent_mm, right_indent_mm, last_line_indent_mm, tab_stops[], language {name, untranslated_name, icu_locale}}. InDesign names a family with a format suffix such as "Source Sans 3 (OTF)" or "(TT)" when it knows the family in more than one format; pass the family with or without that suffix – the connector matches both and reads back the name InDesign uses. Strict keep options can produce overset or empty column ends – check overset and get_frame_lines afterwards. on_collision decides what happens when the name exists: error (default), update or version ("Name 2"). The font must be installed: InDesign rejects a font it does not have, even as family plus style (not_found with available_styles) – def… Input parameters: - `alignment` (string): Alignment; justify = Blocksatz, last line left. - `color_hex` (string): Text colour as hex; an RGB swatch named after it is created if needed. Not together with swatch_name. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `first_line_indent_mm` (number): First-line indent (Einzug erste Zeile) in mm; negative = hanging indent, at most -left_indent_mm. - `font_family` (string): Font family, e.g. "Futura PT". - `font_style` (string): Exact style name, e.g. "Book" or "75 Bold" (see get_font_info_at_index). - `hyphenation` (boolean): Hyphenation on or off (Silbentrennung). - `hyphenation_options` (object): Hyphenation settings (Silbentrennungseinstellungen). The plain hyphenation switch stays a separate parameter. Whatever is omitted stays. - `justification_options` (object): Justification settings (Abstandseinstellungen für Blocksatz). Whatever is omitted stays. The paragraph composer recomposes the whole paragraph on every change – check get_frame_lines afterwards. - `keep_options` (object): Keep options (Umbruchoptionen / Absatzkontrolle). Whatever is omitted stays. - `language` (string): Language of the text (Sprache, for hyphenation and spelling): the name InDesign shows (e.g. "Deutsch: 2006 Rechtschreibreform", "Englisch: Großbritannien"), its untranslated name as InDesign holds it… - `last_line_indent_mm` (number): Last-line right indent (Einzug letzte Zeile) in mm. - `leading_pt`: Leading in points, or "auto". - `left_indent_mm` (number): Left indent (Einzug links) in mm. - `name` (string, required): Style name; must not start with "[". - `on_collision` (string): What to do when the name exists: error (default) fails, update changes the existing one, version creates "Name 2". - `right_indent_mm` (number): Right indent (Einzug rechts) in mm. - `size_pt` (number): Point size (Schriftgrad). - `space_after_pt` (number): Space after (Abstand danach) in points. - `space_before_pt` (number): Space before (Abstand davor) in points. - `swatch_name` (string): Text colour as an existing swatch by exact name (CMYK, spot, tint or gradient; see list_swatches). Not together with color_hex. - `tab_stops` (array): Complete list of tab stops (Tabulatoren); replaces every existing tab stop, [] removes all. Text reaches a tab stop through {{tab}} in set_text. - `tracking` (number): Tracking (Laufweite) in 1/1000 em; a character style with its own tracking replaces this value where it is applied. ### `define_character_style` (~434 tokens) Define a character style Create a character style (Zeichenformat) with name and at least one of font_family, font_style (exact InDesign style name), point_size, fill_hex (creates an RGB swatch) or swatch_name (an existing swatch by exact name; not together with fill_hex), and tracking (Laufweite in 1/1000 em, -1000 to 10000; where the style is applied it replaces the tracking of the paragraph style – see apply_character_style_to_range). on_collision: error (default), update or version. Returns style_id, name, collision (none, updated, versioned), existed, applied[] and the definition read back (null for attributes the style leaves untouched). InDesign names a family with a format suffix such as "Source Sans 3 (OTF)" or "(TT)" when it knows the family in more than one format; pass the family with or without that suffix – the connector matches both and reads back the name InDesign uses. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `fill_hex` (string): Text colour as hex; an RGB swatch is created if needed. Not together with swatch_name. - `font_family` (string): Font family. - `font_style` (string): Exact style name, e.g. "75 Bold". - `name` (string, required): Style name; must not start with "[". - `on_collision` (string): What to do when the name exists: error (default) fails, update changes the existing one, version creates "Name 2". - `point_size` (number): Point size. - `swatch_name` (string): Text colour as an existing swatch by exact name (CMYK, spot, tint or gradient; see list_swatches). Not together with fill_hex. - `tracking` (number): Tracking (Laufweite) in 1/1000 em. ### `apply_paragraph_style` (~232 tokens) Apply a paragraph style to a whole frame Apply a paragraph style (Absatzformat) to every paragraph of a text frame. By default (clear_overrides true) local formatting and character styles are cleared first, so the print matches the style, not only its name; with clear_overrides false deliberate local bold or italic stays, and so does every stray override. For a threaded frame only the paragraphs touching this frame are formatted – use apply_paragraph_style_to_range over the whole story (0 to story_length from get_frame_text) for the rest. Returns frame_id, style_applied, affected_paragraphs, overrides_cleared and threaded. Input parameters: - `clear_overrides` (boolean): Clear local character formatting and character styles first. Default true. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `style_name` (string, required): Paragraph style name (see list_paragraph_styles). ### `apply_paragraph_style_to_range` (~275 tokens) Apply a paragraph style to a range Apply a paragraph style (Absatzformat) to every paragraph touched by the character range start_index (inclusive) to end_index (exclusive) of the story of a text frame. Clears paragraph overrides, character styles and local character formatting of those paragraphs; never changes text. Caveat: when start_index is the paragraph mark of the preceding paragraph, that paragraph is formatted too (warning) – start one character later. Recommended order: base style over the whole story first, then the special styles. One call is enough (it runs the clean-up twice internally). Returns frame_id, story_id, style_applied, affected_paragraphs, first_paragraph_start_index and last_paragraph_end_index. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `end_index` (integer, required): End of the range (exclusive); must be greater than start_index. - `frame_id` (integer, required): Object id from get_page_state. - `start_index` (integer, required): First character of the range (inclusive), a story index from get_frame_text. - `style_name` (string, required): Paragraph style name (see list_paragraph_styles). ### `apply_character_style_to_range` (~276 tokens) Apply a character style to a range Apply an existing character style (Zeichenformat) to the characters start_index (inclusive) to end_index (exclusive) of the story of a text frame. The style must exist (define_character_style; list_paragraph_styles lists them). Never changes text. Returns frame_id, characters_affected, style_applied and tracking {effective, character_style, paragraph_style}: a character style that carries its own tracking replaces the tracking of the paragraph style for that range (it is not added) – a paragraph style with tracking 100 plus a character style with tracking 260 gives 260, visibly wider. effective is what InDesign uses at the first character of the range; character_style is null when the style leaves tracking alone. Input parameters: - `character_style_name` (string, required): Existing character style name. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `end_index` (integer, required): End of the range (exclusive); must be greater than start_index. - `frame_id` (integer, required): Object id from get_page_state. - `start_index` (integer, required): First character of the range (inclusive), a story index from get_frame_text. ### `apply_character_format_to_range` (~416 tokens) Format a range locally Local character formatting without a style for the characters start_index (inclusive) to end_index (exclusive) of the story of a text frame: font_style (exact InDesign style name – fetch it with get_font_info_at_index first, "75 Bold" rather than "Bold"; optional font_family to switch the family), swatch_name (an existing swatch, exact name; built-ins are "Black", "Paper", "None"), superscript (true/false), tracking (Laufweite in 1/1000 em, -1000 to 10000; the server configuration can set a tolerance beyond which a warning is given), point_size (0–1296, the only way to a size without a paragraph style). At least one attribute. Never changes text. Returns applied[], point_size_applied, font_family, font_style and fill_color read back at the first character for a cross-check, plus characters_affected. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `end_index` (integer, required): End of the range (exclusive); must be greater than start_index. - `font_family` (string): Font family to switch to (optional; needs the font to be installed unless font_style is given too). - `font_style` (string): Exact style name within the family, e.g. "75 Bold". - `frame_id` (integer, required): Object id from get_page_state. - `point_size` (number): Point size. - `start_index` (integer, required): First character of the range (inclusive), a story index from get_frame_text. - `superscript` (boolean): true sets superscript, false resets to normal position. - `swatch_name` (string): Existing swatch name for the text colour. - `tracking` (number): Tracking in 1/1000 em. ### `set_paragraph_options` (~878 tokens) Set paragraph options (alignment, hyphenation, keep, justification) Set paragraph options of a text frame: alignment (left, center, right, justify_left, justify_center, justify_right, justify_full), hyphenation (true/false – usually false for headlines), no_break (true/false, keeps the text of the paragraphs on one line), and the option groups keep_options (Umbruchoptionen: keep_with_next, keep_first_lines, keep_last_lines, keep_lines_together, keep_all_lines_together, keep_with_previous, start_paragraph), hyphenation_options (Silbentrennungseinstellungen: words_longer_than, after_first, before_last, ladder_limit, zone_mm, capitalized_words, last_word, across_columns, weight) and justification_options (word_spacing, letter_spacing, glyph_scaling, single_word_justification, composer, auto_leading_percent). Indents in mm: left_indent_mm, first_line_indent_mm (negative for a hanging indent, never further left than the left indent), right_indent_mm, last_line_indent_mm. tab_stops[] {position_mm, alignment left|center|right|character, leader, align_on} replaces the whole tab list ([] clears it); language selects the dictionary by the name InDesign shows, its untranslated name or an ICU locale (de_DE, en_GB – the safest form). The answer reads them back under indents {left_indent_mm, first_line_indent_mm, right_indent_mm, last_line_indent_mm, tab_stops[], language {name, untranslated_name, icu_locale}}. Without start_index/end_index every paragraph of the frame is changed; with them every paragraph the range touches. Returns paragraphs_changed, alignment, hyphenation, no_break, keep_options, hyphenation_options, justification_options, indents of the first paragraph read back after the change, and overset of the story – strict keep options can push text into overset or leave empty column ends; check get_frame_lines. Input parameters: - `alignment` (string): Paragraph alignment. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `end_index` (integer): Optional range end (exclusive). - `first_line_indent_mm` (number): First-line indent (Einzug erste Zeile) in mm; negative = hanging indent, at most -left_indent_mm. - `frame_id` (integer, required): Object id from get_page_state. - `hyphenation` (boolean): Hyphenation on or off. - `hyphenation_options` (object): Hyphenation settings (Silbentrennungseinstellungen). The plain hyphenation switch stays a separate parameter. Whatever is omitted stays. - `justification_options` (object): Justification settings (Abstandseinstellungen für Blocksatz). Whatever is omitted stays. The paragraph composer recomposes the whole paragraph on every change – check get_frame_lines afterwards. - `keep_options` (object): Keep options (Umbruchoptionen / Absatzkontrolle). Whatever is omitted stays. - `language` (string): Language of the text (Sprache, for hyphenation and spelling): the name InDesign shows (e.g. "Deutsch: 2006 Rechtschreibreform", "Englisch: Großbritannien"), its untranslated name as InDesign holds it… - `last_line_indent_mm` (number): Last-line right indent (Einzug letzte Zeile) in mm. - `left_indent_mm` (number): Left indent (Einzug links) in mm. - `no_break` (boolean): No-break for the paragraph text. - `right_indent_mm` (number): Right indent (Einzug rechts) in mm. - `start_index` (integer): Optional range start (inclusive); without it the whole frame. - `tab_stops` (array): Complete list of tab stops (Tabulatoren); replaces every existing tab stop, [] removes all. Text reaches a tab stop through {{tab}} in set_text. ### `get_font_info_at_index` (~165 tokens) Font at a character Read the font at story index of a text frame: font_family, font_style (the exact style name to use in apply_character_format_to_range or define_paragraph_style), font_status (installed, substituted, not_available), available_styles[] of that family as installed, point_size, paragraph_style, character_style (localized name) and character_style_is_none. Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `index` (integer, required): Story index of the character (from get_frame_text). ### `find_font_usage` (~275 tokens) Where is a font used Find where fonts are used in the document. fonts_used[] {family, style, status (installed, substituted, not_available), occurrences, characters} is always complete; occurrences[] {family, style, status, story_id, frame_ids[], page_id, page_name, is_master, start_index, end_index, snippet} is filtered by font_family and font_style (exact names, case-insensitive – "Futura" does not match "Futura PT"), only_missing (status other than installed) and include_master_pages (default true). Runs of the same family and style are merged; at most 500 occurrences are listed. Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `font_family` (string): Family to filter occurrences by (case-insensitive; a format suffix such as "(OTF)" may be left out). - `font_style` (string): Style to filter occurrences by (exact, case-insensitive). - `include_master_pages` (boolean): Include stories on master pages. Default true. - `only_missing` (boolean): List only occurrences of fonts that are not installed. Default false. ### `debug_inspect_run` (~305 tokens) Inspect formatting at a character Diagnosis only: the effective formatting at story index (default 0) of a text frame – point_size, leading_pt, applied_paragraph_style, applied_character_style (InDesign's own name, localized – "[Ohne]" in German) with character_style_is_none (true when no character style is applied, the language-independent check), fill_color, applied_font, font_style, tracking, horizontal_scale, vertical_scale, style_overridden (local formatting on top of the style), frame_scale {horizontal, vertical} of the frame and paragraph {index (0-based in the story), start_index (story index of its first character), alignment, hyphenation, keep_options, hyphenation_options, justification_options} of the paragraph holding the character. With style_name also style {found, kind, matches, duplicated, nested, groups[], definition} – whether the name occurs more than once or inside a group. The only way to see local formatting hiding behind a correct style name. Read-only. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `index` (integer): Story index to inspect. Default 0. - `style_name` (string): Paragraph or character style name to look up. ### `create_swatch` (~247 tokens) Create a colour swatch Create a process colour swatch (Farbfeld) with the exact name (1–60 characters) from hex (RGB, "#1A2B3C") or cmyk ({c, m, y, k} in percent – for print production); exactly one of the two. on_collision: error (default), update (rewrites the values of the existing colour) or version ("Name 2"). Returns name, swatch_id, collision (none, updated, versioned), existed, space (rgb or cmyk) and values. Input parameters: - `cmyk` (object): CMYK values in percent. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `hex` (string): RGB colour as hex. - `name` (string, required): Exact swatch name; must not start with "[". - `on_collision` (string): What to do when the name exists: error (default) fails, update changes the existing one, version creates "Name 2". ### `get_frame_options` (~507 tokens) Options of a frame Read the options of an object as InDesign holds them: type (text, image, rectangle, ellipse, polygon, line, group, other), page_id/page_name (landing), bounds_mm, rotation_deg, text_wrap {mode, offset_mm}, appearance {fill_color, fill_kind, stroke_color, stroke_kind, stroke_weight_pt, fill_tint_percent, stroke_tint_percent, gradient_fill_angle_deg, gradient_stroke_angle_deg, gradient_fill_start_mm, gradient_fill_length_mm}, corners {top_left {type, radius_mm}, …, uniform} (null for lines and groups), effects {opacity_percent, blend_mode, drop_shadow, feather} of the object and has_effects {fill, stroke, text} (true where something deviates from normal / 100 %), parent_group_id, layer {layer_id, layer_name, visible, locked}, locked (Objekt > Sperren) and anchored {story_id, index, position} (null when the object is not anchored in text). For a text frame additionally text: columns {count, gutter_mm, type, fixed_width_mm}, inset_mm, vertical_justification, vertical_threshold_mm, first_baseline_offset (ascent, cap_height, leading, x_height, fixed, embox_top), min_first_baseline_pt, ignore_text_wrap, optical_margin_alignment and optical_margin_size_pt (story-wide, see set_story_options), threading {story_id, story_length, frame_index, frame_count, previous_frame_id, next_frame_id, overset, story_overset}, first_baseline_mm (baseline of the first line in mm from the top of the page – the direct check whether the first line sits on the baseline grid, if the layout uses one) and character_count. Read-only. Use it to copy the settings of an existing frame before rebuilding it with create_text_frame, set_frame_columns, set_frame_inset and set_text_wrap. Returns coordinate_space ("page" when the object lies on a page, "spread" on the pasteboard): bounds_mm is relative to page_id and can be passed back to set_frame_bounds together with page_id. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. ### `group_frames` (~242 tokens) Group objects Group two or more objects (text frames, graphic frames, rectangles, lines, groups) into one group (Gruppe). All objects must lie on the same spread (Druckbogen) and must not already be members of a group. Returns frame_id of the new group, member_ids, member_count, bounds_mm, landed_on_page_id and landed_on_page_name. The group is what get_page_state lists as type "group"; move it with move_frame_to_page, delete it with delete_frame, dissolve it with ungroup_frame. Members keep their ids and can still be read (get_frame_text, get_frame_options), but set_frame_bounds and move_frame_to_page work only on the group as a whole. A timed-out call may still have grouped – check get_page_state before repeating. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_ids` (array, required): Ids of the objects to group, at least two, all on the same spread. ### `ungroup_frame` (~161 tokens) Ungroup a group Dissolve a group (Gruppe aufheben): its members become independent objects of the page again and keep their ids; the group id disappears. Nested groups inside are kept as groups. Returns frame_id (the former group), member_ids, member_count, landed_on_page_id and landed_on_page_name of the members. Fails with invalid_state when the object is not a group or is itself inside a group (ungroup the outer group first). Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. ### `export_page_image` (~474 tokens) Export pages as images Export document pages as PNG or JPEG images, one file per page (for proofs, correction mails, the website or a measuring run without PDF). Select pages with page_ids (from list_pages) or page_range like export_pdf ("6-8", "1, 3-5", "+2"; printed page names). path is the target file; with several pages the page name is inserted before the extension (Seite.png → Seite_8.png). format png (default) or jpeg, dpi 36–600 (default 150), quality low/medium/high (default)/maximum, color_space rgb (default), gray or cmyk (jpeg only), transparent_background (png), use_bleed (include the bleed), anti_alias (default true). Master pages cannot be exported. The export preferences are set for this call only and restored. Returns format, dpi, count and files[] {page_id, page_name, path, bytes}. Read the files with an image tool of the client to check a layout visually. A timed-out call may still have written files – check the folder before repeating. Input parameters: - `anti_alias` (boolean): Smooth edges. Default true. - `color_space` (string): rgb (default), gray, or cmyk (jpeg only). - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `dpi` (number): Resolution in dpi. Default 150. - `format` (string): Image format. Default png. - `page_ids` (array): Pages to export, from list_pages. Alternative to page_range. - `page_range` (string): Page range against the printed page names, like export_pdf. Alternative to page_ids. - `path` (string, required): Target file on the InDesign machine, e.g. /Users/.../Seite.png; the page name is inserted before the extension when several pages are exported. - `quality` (string): Compression quality. Default high. - `transparent_background` (boolean): PNG only: transparent instead of white background. Default false. - `use_bleed` (boolean): Include the document bleed (Anschnitt). Default false. ### `place_text_file` (~773 tokens) Place a text file Place a manuscript file (.docx, .doc, .rtf or .txt on the InDesign machine) into a text frame – the cheap way for long articles instead of passing the text as a string. mode replace (default) empties the story first; append adds at the end of the story. retain_formatting false (default) imports plain text (Word styles and local formatting removed) so that paragraph_style (applied to every placed paragraph, like apply_paragraph_style_to_range) gives the document's paragraph style; retain_formatting true keeps Word styles and local formatting and imports the Word paragraph styles (names that already exist in the document are used as they are). style_map {"Word style": "document style"} maps Word paragraph styles to existing document styles after the import (forces retain_formatting true) and removes the mapped Word styles again (styles_removed); every target style must exist. typographers_quotes (default true) converts straight quotes. Footnotes and endnotes are imported, tables come in as InDesign tables, graphics, index and table of contents are not imported. Returns placed_start_index, placed_end_index and inserted_chars (story indices for the *_to_range tools), story_length, paragraph_count, styles_added (paragraph styles the import created – remove or map them), styles_mapped and overset of the story. autoflow true (Sitzung 8) keeps adding pages after the page of the last frame – same parent page, a frame with the bounds and frame options of the last one (columns, gutter, insets, vertical justification, first baseline – copied value by value), threaded – until the text fits or max_pages (default 20) is reached; the result carries autoflow {pages_added, frames_added[] {frame_id, page_id, bounds_mm, frame_options_copied, frame_options_failed[], frame_options_skipped[] (values that do not apply, e.g. vertical_threshold without vertical justify), columns {count, gutter_mm}}, overset, stopped}. Without autoflow, thread frames with thread_text_frames. Autoflow keeps t… Input parameters: - `autoflow` (boolean): Add pages and threaded frames until the text fits. Default false. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `file_path` (string, required): Real path of the .docx, .doc, .rtf or .txt file on the machine running InDesign. - `frame_id` (integer, required): Object id from get_page_state. - `keep_view` (boolean): Restore the previous view (page and zoom of the layout window) afterwards – InDesign otherwise jumps to the new page. Default true; false lets the view move. The answer carries view_restored (null wh… - `max_pages` (integer): autoflow: at most this many pages. Default 20. - `mode` (string): replace (default): empty the story first; append: add at the end of the story. - `paragraph_style` (string): Existing paragraph style applied to every placed paragraph. - `retain_formatting` (boolean): true keeps Word styles and local formatting. Default false = plain text. - `style_map` (object): Word paragraph style name → existing document style name; applied after the import. - `typographers_quotes` (boolean): Convert straight quotes to typographic ones. Default true. ### `fit_frame` (~419 tokens) Fit frame or content InDesign's fitting commands (Anpassen) as one call. For a graphic frame: content_to_frame (distorts), fit_proportionally (whole picture visible, may leave space), fill_proportionally (frame filled, picture cropped), center_content, or frame_to_content (the frame takes the size of the picture, top left corner stays). For a text frame only frame_to_content: the frame shrinks or grows to its text (Rahmen an Inhalt anpassen) – InDesign fits width and height (the width to the longest line); keep_width true fits the height only and keeps the width (via auto-size height only, reference top left) – the usual choice for headlines and captions; if the layout uses a baseline grid, check the result against it. Returns frame_bounds_before_mm, frame_bounds_mm, frame_changed, and for pictures graphic_bounds_mm, fits_frame and effective_ppi (warning below min_ppi), for text overset. Fails on groups, lines, empty graphic frames and members of a group. Returns coordinate_space ("page", or "spread" on the pasteboard); when the object carries a text wrap the document is recomposed afterwards (recomposed, overset_stories_before, overset_stories_after, overset_changed). Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `keep_width` (boolean): Text frames, frame_to_content: fit the height only and keep the width. Default false = InDesign behaviour (width and height). - `min_ppi` (number): Effective resolution in ppi below which a warning is given. Default: the configured value, otherwise 300 (the usual offset print value: twice the 150 lpi screen). - `mode` (string, required): Which fitting to apply. ### `list_swatches` (~258 tokens) List swatches List the swatches (Farbfelder) of the document: swatches[] {swatch_id, name, kind (none, color, tint, gradient, mixed_ink), space (RGB, CMYK, LAB, MIXED_INK), model (process, spot, registration), values (RGB 0–255 or CMYK percent; ink percentages for mixed inks), tint_percent and base_color for tints, stop_count, type (linear, radial) and stops[] {index, swatch_name, location, midpoint} for gradients, built_in}. include_built_in false hides None, Black, Paper and Registration. Read-only. Use the exact names for swatch_name parameters (create_line, create_rectangle, set_frame_appearance, apply_character_format_to_range); hex parameters create RGB swatches, which print differently from the CMYK swatches of the document. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_built_in` (boolean): Also list None, Black, Paper and Registration. Default true. ### `list_layers` (~185 tokens) List layers List the layers (Ebenen) of the document in panel order: layers[] {layer_id, name, index (0 = topmost), visible, locked, printable, ignore_wrap, show_guides, lock_guides, item_count (objects on the layer, document and parent pages)}, count, active_layer_id (where new objects land), hidden_count, locked_count, non_printing_count. Read-only. A locked layer makes every writing tool on its objects fail; a hidden layer hides them; a non-printing layer drops them from PDF exports – read this before you wonder why a call fails or a page looks empty. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… ### `set_frame_layer` (~262 tokens) Move object to a layer Move an object (frame, line, group) to another layer (Ebene). Pass layer_name or layer_id; with create_if_missing true a missing layer_name is created on top (warning). Members of a group cannot be moved separately (invalid_state; move the group). Fails with invalid_state when the object lies on a locked layer, is itself locked, or the target layer is locked – unlock with set_layer_visibility first. Returns layer_id, layer_name, previous_layer_id, previous_layer_name, layer_created, changed; warns when the target layer is hidden. Input parameters: - `create_if_missing` (boolean): Create the layer named layer_name on top when it does not exist. Default false. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `layer_id` (integer): Layer id from list_layers. Pass either layer_name or layer_id. - `layer_name` (string): Layer name (Ebene), exact, as list_layers returns it. Pass either layer_name or layer_id. ### `set_layer_visibility` (~250 tokens) Show, hide, lock or unlock a layer Set visible, locked and/or printable on one layer (Ebene): at least one of the three. Pass layer_name or layer_id. Returns the layer state after the change, previous {visible, locked, printable}, item_count and changed. Warns when a layer with objects is hidden and when a layer is set to not print (its objects vanish from PDF exports). Unlocking is the fix when writing tools fail on objects of a locked layer. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `layer_id` (integer): Layer id from list_layers. Pass either layer_name or layer_id. - `layer_name` (string): Layer name (Ebene), exact, as list_layers returns it. Pass either layer_name or layer_id. - `locked` (boolean): Lock (true) or unlock (false) the layer. - `printable` (boolean): Print/export (true) or not (false). - `visible` (boolean): Show (true) or hide (false) the layer. ### `create_table` (~528 tokens) Create a table Create a table (Tabelle) in the story of a text frame: rows (body rows) x columns, plus header_rows and footer_rows; position end (default, after the existing text, in its own paragraph), start, or replace (the story is emptied first). Optional cells fill it row-major (header rows first, then body, then footer), table_style, cell_style, paragraph_style (applied inside every cell), column_widths_mm or width_mm. Returns table_id, table_index (in the story), frame_id (where the table starts), story_offset_index, rows/body_rows/header_rows/footer_rows/columns, table_style, width_mm, height_mm, column_widths_mm, cells_written, overflowing_cells, overset. A table that does not fit makes the story overflow – warning; enlarge the frame or thread another one. Use set_table_cells for further contents and get_table to read it back. Input parameters: - `cell_style` (string): Cell style (Zellenformat) by exact name; get_table lists the available ones. - `cells` (array): Rows of cell texts, row-major: [["Datum","Ort"],["12.05.","A"]]. Numbers are written as text, null leaves the cell untouched. Line breaks (\n) become paragraphs inside the cell. - `column_widths_mm` (array): Column widths in mm, one per column. - `columns` (integer, required): Columns, 1 to 100. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `footer_rows` (integer): Footer rows (Tabellenfuß). Default 0. - `frame_id` (integer, required): Object id from get_page_state. - `header_rows` (integer): Header rows (Tabellenkopf), repeated when the table breaks. Default 0. - `paragraph_style` (string): Paragraph style applied in every cell (exact name, see list_paragraph_styles). - `position` (string): Where in the story: end (default), start, or replace the whole story text. - `rows` (integer, required): Body rows (Textzeilen), 1 to 1000. - `table_style` (string): Table style (Tabellenformat) by exact name; get_table lists the available ones. - `width_mm` (number): Total table width in mm (columns scaled proportionally). Ignored when column_widths_mm is given. ### `set_table_cells` (~369 tokens) Write table cells Write cell texts into an existing table from a matrix, starting at start_row/start_column (0-based, rows counted across header, body and footer). By default the matrix must fit; grow true adds body rows and columns as needed. Optional paragraph_style and cell_style for the written cells. Cells hidden by a merged cell are skipped (warning). Returns cells_written, cells_skipped, rows_added, columns_added, overflowing_cells (cells whose text does not fit – widen the column or shorten), overset of the story, and the table summary as get_table. Input parameters: - `cell_style` (string): Cell style (Zellenformat) by exact name; get_table lists the available ones. - `cells` (array, required): Rows of cell texts, row-major: [["Datum","Ort"],["12.05.","A"]]. Numbers are written as text, null leaves the cell untouched. Line breaks (\n) become paragraphs inside the cell. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `grow` (boolean): Add rows and columns when the matrix exceeds the table. Default false = invalid_argument. - `paragraph_style` (string): Paragraph style applied in the written cells (exact name). - `start_column` (integer): First column to write, 0-based. Default 0. - `start_row` (integer): First row to write, 0-based across all rows. Default 0. - `table_index` (integer): Which table of the story, in text order, 0 = first. Default 0. ### `set_table_style` (~342 tokens) Table style, cell style, widths Change how a table looks: table_style (Tabellenformat), cell_style with cell_style_scope all|header|body|footer, column_widths_mm (one per column) or width_mm (proportional), header_rows and footer_rows (converted from existing rows; at least one body row must remain). At least one parameter. Unknown style names are not_found with the available names in the details. Returns the table summary (widths, heights, counts, table_style), cells_styled, changed, overset. Input parameters: - `cell_style` (string): Cell style (Zellenformat) by exact name; get_table lists the available ones. - `cell_style_scope` (string): Which rows get cell_style. Default all. - `column_widths_mm` (array): Column widths in mm, one per column. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `footer_rows` (integer): Number of footer rows (taken from the bottom rows). - `frame_id` (integer, required): Object id from get_page_state. - `header_rows` (integer): Number of header rows (taken from the top rows). - `table_index` (integer): Which table of the story, in text order, 0 = first. Default 0. - `table_style` (string): Table style (Tabellenformat) by exact name; get_table lists the available ones. - `width_mm` (number): Total table width in mm, columns scaled proportionally. ### `get_table` (~262 tokens) Read a table Read a table of the story of a text frame: table_id, table_index, table_count (tables in the story), frame_id (where it starts), story_offset_index, rows/body_rows/header_rows/footer_rows/columns, row_types, table_style, width_mm, height_mm, column_widths_mm, row_heights_mm, rows_text (matrix of cell texts, null where a merged cell covers the position, cut at max_chars_per_cell with truncated true), merged_cells {row, column, row_span, column_span}, overflowing_cells, cell_styles (name and count), available_table_styles, available_cell_styles, overset. Read-only. not_found when the story has no table or table_index is beyond table_count. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `max_chars_per_cell` (integer): Text budget per cell. Default 200. - `table_index` (integer): Which table of the story, in text order, 0 = first. Default 0. ### `list_object_styles` (~344 tokens) List object styles List the object styles (Objektformate) of the document: styles[] {style_id, name, group_path, based_on, built_in ([None], [Basic Graphics Frame], [Basic Text Frame] – localized names in a German InDesign), applies {fill, stroke, stroke_and_corner, transform, text_frame_general, text_frame_baseline, text_frame_auto_sizing, paragraph_style, story_options, text_wrap_and_others, anchored_object, frame_fitting} (which categories the style sets), fill_color, stroke_color, stroke_weight_pt, paragraph_style, and – each only when the style sets that category, otherwise null – fill_tint_percent, overprint_fill, stroke_tint_percent, stroke_type, corners {top_left {type, radius_mm} … uniform}, text_frame {columns, inset_mm, vertical_justification, vertical_threshold_mm, first_baseline_offset, min_first_baseline_pt, ignore_text_wrap}, text_wrap {mode, offset_mm}, effects (opacity, blend mode, drop shadow, feather), anchored, frame_fitting {on_empty_frame, auto_fit, crop_mm}, story {optical_margin_alignment, optical_margin_size_pt}}, count. include_built_in false hides the bracketed defaults. Read-only. Use the exact names with apply_object_style. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_built_in` (boolean): Also list the bracketed default styles. Default true. ### `apply_object_style` (~223 tokens) Apply an object style Apply an object style (Objektformat) to a frame, line or group by exact name; clear_overrides true (default) removes local overrides of the categories the style sets. Unknown names are not_found with the available names in the details. Returns style_name (read back), style_id, previous_style_name, changed, bounds_mm and bounds_changed (auto-size or fitting options can move the frame), appearance {fill_color, stroke_color, stroke_weight_pt} and overset for text frames (warning). Fails with invalid_state on locked layers and locked objects. Input parameters: - `clear_overrides` (boolean): Clear local overrides while applying. Default true. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `style_name` (string, required): Object style name, exact, as list_object_styles returns it. ### `list_stories` (~298 tokens) List stories Overview of the stories (Textabschnitte) of the document: which frames belong to which story and in what order, and which story overflows. stories[] {story_id, frame_ids (chain order), frame_count, frames[] {frame_id, index, page_id, page_name, on_pasteboard, on_parent_page, bounds_mm}, character_count, paragraph_count, table_count, overset, on_parent_page, first_page_id, first_page_name, first_paragraph_style, snippet}, count, total_stories, overset_count (warning when above 0). Stories on parent pages are skipped unless include_parent_pages true; empty stories are listed unless include_empty false; page_id keeps only stories with a frame on that page. Read-only. get_frame_text reads one story; thread_text_frames changes the chain. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_empty` (boolean): List stories without text. Default true. - `include_parent_pages` (boolean): Also list stories on parent (master) pages. Default false. - `page_id` (integer): Only stories that have a frame on this page. - `snippet_chars` (integer): Length of the text snippet per story. Default 80. ### `anchor_frame_in_text` (~538 tokens) Anchor object in text Anchor a frame, picture, line or group at a text position (verankertes Objekt) so it moves with the text on reflow: target_frame_id names a frame of the story, index the character position (default: end of the story), position inline (on the baseline), above_line, or custom with offset_mm {x, y}, anchor_point, horizontal_reference (anchor_location, column_edge, text_frame, page_margins, page_edge), vertical_reference (line_baseline, line_xheight, line_ascent, cap_height, top_of_leading, embox_top, embox_middle, embox_bottom, column_edge, text_frame, page_margins, page_edge), horizontal_alignment (left, center, right, text), vertical_alignment (top, center, bottom), keep_within_frame, lock_position. The object leaves its page and becomes part of the story (an U+FFFC character at index). Returns frame_id (read back; a new id is warned), story_id, index, story_length, settings, bounds_mm, page_id and story_overset (warning). Fails on group members, already anchored objects, a frame of the target story, locked layers. An anchored object leaves its place on the page and follows the text on reflow – anchor deliberately (captions, marginalia, inline symbols) and leave objects that must keep their position unanchored. Input parameters: - `anchor_point` (string): custom only: reference point on the object. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `horizontal_alignment` (string): custom only. - `horizontal_reference` (string): custom only. - `index` (integer): Character index in the story (0 = before the first character). Default: end of the story. - `keep_within_frame` (boolean): custom only: keep the object within the top and bottom of the text frame (pin position). - `lock_position` (boolean): custom only: prevent manual dragging. - `offset_mm` (object): custom only: offset in mm (x right, y down). - `position` (string): inline (default), above_line or custom. - `target_frame_id` (integer, required): A text frame of the story to anchor into. - `vertical_alignment` (string): custom only. - `vertical_reference` (string): custom only. ### `unanchor_frame` (~140 tokens) Release anchored object Release an anchored object from its text: it stays where it is drawn but becomes a free object of the page again (the anchor character is removed from the story). Returns frame_id (read back), was_anchored {story_id, index, position}, bounds_mm, page_id/page_name. invalid_state when the object is not anchored. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. ### `import_styles` (~251 tokens) Import styles from a file Load styles and swatches from another InDesign file (.indd, .indt, .idml) into this document: kinds paragraph, character, object, table, cell, swatches (default all six); on_conflict keep_existing (default: a style whose name exists already is not loaded), overwrite (existing styles with the same name are replaced) or rename (imported copies get a new name). Returns results per kind {before, after, added[]} and total_added; warns when nothing new arrived. Typical use when setting up a new issue from the previous one. Swatches are loaded without a conflict strategy (existing names stay). Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `file_path` (string, required): Real path of an .indd, .indt or .idml file on the machine running InDesign. - `kinds` (array): Which kinds to import. Default: all. - `on_conflict` (string): What happens to a name that exists already. Default keep_existing. ### `list_sections` (~170 tokens) List sections List the sections (Abschnitte) of the document that control page numbering: sections[] {section_id, name, start_page_id, start_page_name, start_page_index, length, continue_numbering, page_number_start, page_number_style (arabic, upper_roman, lower_roman, upper_letters, lower_letters, or a custom list name), section_prefix, include_section_prefix, marker}, count, and pages[] {page_id, name} with the page names as they result. Read-only. Every document has a section on its first page. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… ### `set_section` (~358 tokens) Start or change a section Start a section on page_id or change the one starting there: page_number_start (sets continue_numbering false), continue_numbering, page_number_style (arabic, upper_roman, lower_roman, upper_letters, lower_letters), section_prefix (up to 8 characters), include_section_prefix, marker (text for the section marker), name. remove true deletes the section starting on page_id (never the first). Returns created, section (read back), previous, sections[] and pages[] {page_id, name} – page names change with the numbering, so re-read them before using page names in export_pdf ranges. Use it for an issue that starts at page 3, roman front matter, or a supplement with its own numbering. Input parameters: - `continue_numbering` (boolean): true: continue from the previous section. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_section_prefix` (boolean): Show the prefix in page numbers. - `marker` (string): Section marker text (Abschnittsmarke). - `name` (string): Section name. - `page_id` (integer, required): Document page on which the section starts (from list_pages). - `page_number_start` (integer): Page number of the first page of the section; implies continue_numbering false. - `page_number_style` (string): Numbering style. - `remove` (boolean): Remove the section starting on page_id. Not combinable with other settings. - `section_prefix` (string): Prefix before the page number, up to 8 characters. ### `set_document_setup` (~324 tokens) Change document setup Change the document setup (Dokument einrichten) of an existing document: page size via preset (A4, Letter, Legal, Tabloid) or width_mm/height_mm, orientation (swaps width and height), facing_pages, pages (page count – a lower count deletes the last pages with their contents and needs allow_page_removal true), start_page_number. At least one parameter. Margins and bleed are set with set_layout_grid and set_document_bleed. Objects are not adjusted to a new page size. Returns setup (read back), previous, pages_added, pages_removed, changed; warns when the page size or facing pages changed. Input parameters: - `allow_page_removal` (boolean): Confirm that a lower page count may delete pages with their contents. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `facing_pages` (boolean): Facing pages (Doppelseiten) on or off. - `height_mm` (number): Page height in mm. - `orientation` (string): Swaps width and height when they do not match. - `pages` (integer): Page count. Fewer than now deletes pages (allow_page_removal). - `preset` (string): Page size preset. - `start_page_number` (integer): Number of the first page (document preference; sections may override it). - `width_mm` (number): Page width in mm. ### `list_text_variables` (~172 tokens) List text variables List the text variables (Textvariablen) of the document: variables[] {name, type (custom_text, running_header_paragraph, running_header_character, file_name, output_date, creation_date, modification_date, last_page_number, chapter_number, or the raw type), options per type (text; paragraph_style/character_style, use first|last, text_before, text_after, delete_end_punctuation; include_extension, include_path; format), instance_count (instances in the stories)}, count. Read-only. Every document carries InDesign's default variables. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… ### `create_text_variable` (~409 tokens) Create or update a text variable Create a text variable (Textvariable) or update the options of an existing one with the same name and type: type custom_text (text), running_header_paragraph (paragraph_style, use first|last, text_before, text_after, delete_end_punctuation), running_header_character (character_style, …), file_name (include_extension, include_path, text_before, text_after), output_date/creation_date/modification_date (date_format, text_before, text_after), last_page_number, chapter_number. remove true deletes the variable (and its instances in the text – warning). A running header from the headline style is the classic use on parent pages: create the variable, then insert_text_variable into a frame on the parent page. Input parameters: - `character_style` (string): running_header_character: character style to pick the text from. - `date_format` (string): Date variables: format string as in InDesign (e.g. dd.MM.yyyy). - `delete_end_punctuation` (boolean): Running headers: drop end punctuation. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `include_extension` (boolean): file_name: include the extension. - `include_path` (boolean): file_name: include the folder path. - `name` (string, required): Name of the text variable, exact. - `paragraph_style` (string): running_header_paragraph: paragraph style to pick the text from. - `remove` (boolean): Delete the variable named name. - `text` (string): custom_text: the text. - `text_after` (string): Text after the value. - `text_before` (string): Text before the value. - `type` (string): Variable type; required unless remove. - `use` (string): Running headers: first or last occurrence on the page. Default first. ### `insert_text_variable` (~176 tokens) Insert a text variable Insert an instance of a text variable at a text position: frame_id (a frame of the story, also on a parent page), name, index (default: end of the story). Returns instance_id, story_id, frame_id, index, result_text (what the variable shows there), story_length, overset. The instance counts as one character in the story. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer, required): Object id from get_page_state. - `index` (integer): Character index in the story. Default: end. - `name` (string, required): Name of the text variable, exact. ### `save_document_as` (~223 tokens) Save a copy or switch file Write the document to another file: mode copy (default) saves a copy (Kopie speichern) and the open document keeps its own file – the way to start the next issue from the current one; mode switch saves under the new name and the open document continues there (Speichern unter). template true writes an .indt. An existing file needs overwrite true. Returns path, bytes, overwritten, name and document_path of the open document afterwards. save_document is for saving in place. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `mode` (string): copy (default) or switch. - `overwrite` (boolean): Replace an existing file. Default false. - `path` (string, required): Target file path, ending in .indd or .indt, in an existing folder. - `template` (boolean): Write as template (.indt / stationery). Default false. ### `package_document` (~511 tokens) Package for print Package the document for the printer (Verpacken): a folder with the document, Links, Document fonts and a report; options copy_fonts, copy_graphics, update_graphics (default true), copy_profiles, include_hidden_layers, ignore_preflight_errors (default true), create_report (default true), include_idml, include_pdf with pdf_preset (default: the high quality preset). The document must be saved. Missing links and fonts come back as warnings and fields; InDesign refuses the package when preflight errors are not ignored. Returns folder_path, the options used, missing_links, missing_fonts, entries_in_folder, and the font list of the document with its package status: fonts[] {family, style, name, postscript_name, type (opentype_cff, opentype_tt, truetype, type1 …), status, location, packaged (true, false, or null when the file could not be matched), reason (not_installed, adobe_fonts, not_copied, copy_fonts_off, location_unknown, fonts_folder_missing)}, fonts_total, fonts_packaged_count, fonts_not_packaged[] and fonts_folder. The document font list includes fonts used only by unused styles (e.g. the basic paragraph style), so it can be longer than find_font_usage. Fonts activated through Adobe Fonts (Creative Cloud) are never copied by InDesign – a warning names them. Long operation (timeout 600 s). Input parameters: - `copy_fonts` (boolean): Default true. - `copy_graphics` (boolean): Default true. - `copy_profiles` (boolean): Default false. - `create_report` (boolean): Write the instructions/report file. Default true. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `folder_path` (string, required): Package folder (created or filled by InDesign); its parent folder must exist. - `ignore_preflight_errors` (boolean): Default true. - `include_hidden_layers` (boolean): Default false. - `include_idml` (boolean): Also write an IDML. Default false. - `include_pdf` (boolean): Also export a PDF with pdf_preset. Default false. - `pdf_preset` (string): PDF export preset name for include_pdf. - `update_graphics` (boolean): Update links to the copied graphics. Default true. ### `align_objects` (~320 tokens) Align or distribute objects Align (mode align) or distribute (mode distribute) several objects on one spread like the Align panel (Ausrichten): edge left, horizontal_center, right, top, vertical_center, bottom – for distribute also horizontal_space and vertical_space (equal gaps; with spacing_mm a fixed gap). relative_to selection (default: the objects' common bounds), key_object (with key_frame_id, the key stays put), margins, page or spread. Groups move as a whole; members of a group, objects on other spreads and locked layers are refused. Returns objects[] {frame_id, bounds_mm} after, before, moved_count (warning when nothing moved). All coordinates are page millimetres of the page each object lands on. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `edge` (string, required): Which edges or centres; *_space only for distribute. - `frame_ids` (array, required): Objects to align or distribute (2 or more; 1 is enough when aligning to margins, page or spread). - `key_frame_id` (integer): relative_to key_object: the object that stays in place (one of frame_ids). - `mode` (string): align (default) or distribute. - `relative_to` (string): Reference bounds. Default selection. - `spacing_mm` (number): distribute: fixed distance in mm instead of equal distribution. ### `get_selection` (~196 tokens) Read the selection What is selected in the document window right now: items[] {frame_id, type, class_name, page_id, page_name, on_parent_page, bounds_mm, layer_name, parent_group_id}, frame_ids, text {story_id, start_index, end_index, length, frame_id, text} when text or an insertion point is selected, other[] (class names of anything else), count, is_active_document (the selection belongs to the active window; other documents report empty). Read-only. The natural hand-over when the user points at something in InDesign and wants you to continue with it. Each item carries coordinate_space ("page" or "spread") for its bounds_mm. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… ### `set_selection` (~221 tokens) Select objects Select objects in the document window by frame_ids (replaces the selection) – to show the user what you mean – or a text range with text_range {frame_id, start_index, end_index} (story indices as get_frame_text gives them; start_index equal to end_index places the insertion point there), or clear true to deselect everything. Selecting text switches InDesign to the text tool at that place; combine with show_page to make it visible. Objects on hidden or locked layers cannot be selected (warning when fewer objects end up selected). Returns the selection as get_selection does plus cleared (and story_length for a text range). Input parameters: - `clear` (boolean): Deselect everything instead. - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_ids` (array): Objects to select. - `text_range` (object): Text to select instead of objects. ### `embed_link` (~200 tokens) Embed links Embed linked graphics into the document (Verknüpfung einbetten): link_ids from list_links or frame_id (all graphics of the object). Missing and already embedded links are skipped with a warning. Returns embedded[] {link_id, file_name, file_path, status_before, bytes, status}, skipped[] with reason, and links_after (the whole link list – embedding changes link objects). Embedding grows the document file; the normal way in print production is to keep links and package_document. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `frame_id` (integer): All linked graphics of this object. Pass either link_ids or frame_id. - `link_ids` (array): Links from list_links. Pass either link_ids or frame_id. ### `unembed_link` (~181 tokens) Unembed links Turn embedded graphics back into links (Einbettung aufheben): without folder_path InDesign links to the original file again (fails when it is gone), with folder_path the file is written to that folder and linked from there. Returns unembedded[] with the new file_path and status, skipped[] (not embedded), links_after. Input parameters: - `document_id` (integer): Document to act on, from list_documents or open_document. Without it the frontmost document is used. A document opened with show_window false is never the active one and must always be addressed by i… - `folder_path` (string): Existing folder to write the files into. - `frame_id` (integer): All linked graphics of this object. Pass either link_ids or frame_id. - `link_ids` (array): Links from list_links. Pass either link_ids or frame_id. ## Diagnostics Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/com-mcp-interfaces-layoutbridge-spm/layoutbridge-spm#diagnostics ## Score history - 2026-09-27: 60 - 2026-09-26: 60 - 2026-09-25: 60 - 2026-09-24: 60 - 2026-09-23: 50 ## Common questions ### What is the LayoutBridge for Adobe InDesign® MCP server? LayoutBridge for Adobe InDesign® is an MCP server listed in the public MCP registry as com.mcp-interfaces/layoutbridge-spm. layoutbridge-spm – MCP server for Adobe® InDesign®: pages, frames, text, styles, tables, export. This page covers its npm package (layoutbridge-spm). ### Is the LayoutBridge for Adobe InDesign® MCP server safe to use? LayoutBridge for Adobe InDesign® scores 60 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 27 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm. ### What tools does the LayoutBridge for Adobe InDesign® MCP server expose? LayoutBridge for Adobe InDesign® exposes 110 tools: get_app_version, list_documents, open_document, close_document, list_pages, and 105 more. Their descriptions and schemas cost roughly 37,080 tokens of context every time the server is loaded. ### Is the LayoutBridge for Adobe InDesign® MCP server still maintained? LayoutBridge for Adobe InDesign® is still listed as active in the MCP registry. We last reached this channel on 27 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced. ## Links - npm package: https://www.npmjs.com/package/layoutbridge-spm - Socket report: https://socket.dev/npm/package/layoutbridge-spm - Website: https://mcp-interfaces.com/layoutbridge/ - Changelog RSS feed: https://verifymcp.io/servers/com-mcp-interfaces-layoutbridge-spm/layoutbridge-spm.xml - Changelog JSON feed: https://verifymcp.io/servers/com-mcp-interfaces-layoutbridge-spm/layoutbridge-spm.json - HTML version of this page: https://verifymcp.io/servers/com-mcp-interfaces-layoutbridge-spm/layoutbridge-spm