Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
---
title: RenderCanvas
description: >-
See a read-only PNG photo of a Macro canvas using the actual Canvas shape/text
renderer.
---
# RenderCanvas
See a read-only PNG photo of a Macro canvas using the actual Canvas shape/text renderer. Returns a native image plus an immutable revision, source clock, world crop bounds and object IDs. Use for visual/layout understanding and to review edits. Optional item_ids fit a selection; crop requests precise world bounds. No UI, cursors or ghosts are included. Referenced media not accessible to this scoped renderer is explicitly marked unavailable; this tool never fetches arbitrary URLs or expands reference permissions. Image pixels map linearly across crop bounds; use ReadCanvas for exact geometry.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `document_id` | string | Yes | Canvas document ID from the attachment or search. |
| `item_ids` | string[] | No | Optional stable item selection used to fit the crop, at most 100. |
| `crop` | CanvasBounds | No | Optional world-space rectangle; overrides selection-derived bounds. |