Run common TinyImage tasks from Figma Quick Actions without opening the plugin panel. Choose a named shortcut below. Use the normal plugin panel for detailed settings and authoring.
Run a Quick Action
Figma Motion controls held only in the open panel are not persisted between runs; those controls use explicit shortcut inputs or documented fallbacks.
Every shortcut requires a verified valid license or remaining trials. If verification fails or your trials have expired, open the normal plugin panel to activate your license. Opening the panel remains available.
- Select the layers you want to work with, if the shortcut uses a selection.
- Open Figma Quick Actions with Command + / on Mac or Ctrl + / on Windows.
- Search for the plugin and choose the named shortcut below.
- Enter the fields shown. Optional fields may be skipped; use Tab to edit them. Run the shortcut and check the result or complete its save dialog.
Creation shortcuts ask for names or dimensions directly. Selected-layer shortcuts use the current selection automatically. These everyday shortcuts do not ask for Target or JSON. Choose Open TinyImage for the normal plugin panel.
| Shortcut | Inputs |
|---|---|
| Compress Selected Layers (Custom Settings…) | Quality (1–100) (optional) |
| Convert Selected Layers (Custom Settings…) | Convert format, Quality (1–100) (optional) |
| Export Selected Layers as PDF | None; runs immediately |
| Export Selected Figma Motion (Custom Settings…) | Format (optional), Frames per second (optional) |
| Arrange Selected Layers (Custom Settings…) | Layout (optional), Horizontal gap (px) (optional), Vertical gap (px) (optional) |
Fixed-choice fields use readable labels. Search by the displayed label or the underlying value; agent inputs continue to use the values shown in the command reference.
Run from the context menu
Select the intended layers, right-click, and choose Plugins → TinyImage (development plugins appear under Development). Choose an action and its format or preset. A preset runs immediately when it needs no required input; finish the save dialog when one appears.
Each preset sets its named option. Omitted compatible options inherit the plugin’s saved settings; an explicit action or option takes priority over conflicting saved behavior. Only explicitly entered fields or the selected menu choice override them for that run. If a setting has never been saved, the normal setting or documented fallback applies. Export overrides are not saved back to your preferences. If a saved format is unavailable as a shortcut, choose a supported format explicitly or use the normal panel. To combine options, choose Custom Settings… within the action and enter the parameters. Actions needing text, URLs, names or dimensions still prompt for those required fields. Open TinyImage opens the normal panel.
Compress Selected Layers always keeps the original export formats, even when conversion is saved in the normal panel. Use Convert Selected Layers to choose WebP, AVIF or Tiny SVG. Conversion requires an explicit format; omitted quality and other compression preferences still inherit saved settings. An explicit quality disables saved lossless and target-size modes for that run; advanced callers can explicitly opt into those modes. Export shortcuts never downsize image fills in your Figma source layers. Arrange Selected Layers always arranges, inheriting only layout and spacing. It does not rename, sort, wrap instances or update pager text; request those operations explicitly through advanced options if needed. Create print canvases and adjust print settings in the normal panel. Motion frame rate remains available in Custom Settings.
| Menu choice | Next step |
|---|---|
| Compress Selected Layers → Use Saved Settings | Runs immediately |
| Compress Selected Layers → Compress Selected Layers (Custom Settings…) | Enter Quality (1–100) (optional) |
| Convert Selected Layers → JPG and PNG to WebP | Runs immediately |
| Convert Selected Layers → Only JPG to WebP | Runs immediately |
| Convert Selected Layers → Only PNG to WebP | Runs immediately |
| Convert Selected Layers → JPG and PNG to AVIF | Runs immediately |
| Convert Selected Layers → SVG to Tiny 1.2 SVG | Runs immediately |
| Convert Selected Layers → Convert Selected Layers (Custom Settings…) | Enter Convert format, Quality (1–100) (optional) |
| Export Selected Layers as PDF | Runs immediately |
| Export Selected Figma Motion → Use Default Settings | Runs immediately |
| Export Selected Figma Motion → Animated GIF | Runs immediately |
| Export Selected Figma Motion → MP4 Video | Runs immediately |
| Export Selected Figma Motion → WebM Video | Runs immediately |
| Export Selected Figma Motion → Export Selected Figma Motion (Custom Settings…) | Enter Format (optional), Frames per second (optional) |
| Arrange Selected Layers → Use Saved Layout and Spacing | Runs immediately |
| Arrange Selected Layers → Automatic | Runs immediately |
| Arrange Selected Layers → Rows | Runs immediately |
| Arrange Selected Layers → Columns | Runs immediately |
| Arrange Selected Layers → Arrange Selected Layers (Custom Settings…) | Enter Layout (optional), Horizontal gap (px) (optional), Vertical gap (px) (optional) |
Detailed editing
Use the normal plugin panel for detailed settings, longer content, bulk authoring and browsing components or templates. The shortcut menu contains only the everyday commands listed above.
Keep each pasted field below 150 characters: Figma desktop can truncate pasted input at that boundary. Longer input belongs in the normal panel.
If an older plugin shows Action, Target and Options instead, update it to use these named shortcuts. A Target value is a layer ID or selection, never the name of a new item.
TinyImage actions
| Action | What it does | Target |
|---|---|---|
compress | Compress selected layers without changing their Figma export formats | One or more eligible layers |
pdf | Merge selected frames into a screen PDF | One or more eligible layers |
motion | Export native Figma Motion from one source | Exactly one eligible layer |
convert | Convert selected layers to an explicitly chosen output format | One or more eligible layers |
tidy | Arrange explicit sibling layers; sorting, wrapping, renaming and pager updates require explicit options | One or more eligible layers |
compress
Compress selected layers without changing their Figma export formats. Select one or more eligible layers.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
quality | number | Fallback: 90 | Compression quality. Minimum 1; Maximum 100 |
Nested required fields apply when their parent object or array item is supplied. Omitted optional values use the existing operation’s behavior unless a default is listed.
Choose Compress Selected Layers (Custom Settings…). Enter these plain fields; no JSON is required:
- Quality (1–100):
90
Agent host input
{"command":"shortcut-compress","parameters":{"quality":"90"}}pdf
Merge selected frames into a screen PDF. Select one or more eligible layers.
This shortcut has no input fields.
Choose Export Selected Layers as PDF. It runs immediately using the current selection.
Agent host input
{"command":"shortcut-pdf","parameters":{}}motion
Export native Figma Motion from one source. Select exactly one eligible layer.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
format | string | Fallback: "GIF" | Animation format. GIF, MP4, WEBM |
fps | number | Fallback: 30 | Frames per second; native plan restrictions still apply. 10, 15, 24, 25, 30, 60 |
Nested required fields apply when their parent object or array item is supplied. Omitted optional values use the existing operation’s behavior unless a default is listed.
Choose Export Selected Figma Motion (Custom Settings…). Enter these plain fields; no JSON is required:
- Format: Animated GIF
- Frames per second: 30 fps
Agent host input
{"command":"shortcut-motion","parameters":{"format":"GIF","fps":"30"}}convert
Convert selected layers to an explicitly chosen output format. Select one or more eligible layers.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
convert | string | Required | Output conversion; use compress to keep original formats. webp, webpjpg, webppng, avif, tinysvg |
quality | number | Fallback: 90 | Compression quality. Minimum 1; Maximum 100 |
Nested required fields apply when their parent object or array item is supplied. Omitted optional values use the existing operation’s behavior unless a default is listed.
Choose Convert Selected Layers (Custom Settings…). Enter these plain fields; no JSON is required:
- Convert format: JPG and PNG to WebP
- Quality (1–100):
90
Agent host input
{"command":"shortcut-convert","parameters":{"convert":"webp","quality":"90"}}tidy
Arrange explicit sibling layers; sorting, wrapping, renaming and pager updates require explicit options. Select one or more eligible layers.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
layout | string | Fallback: "auto" | Layout direction. auto, rows, columns |
horizontalSpacing | number | Fallback: 100 | Horizontal spacing in pixels. Minimum 0; Maximum 10000 |
verticalSpacing | number | Fallback: 100 | Vertical spacing in pixels. Minimum 0; Maximum 10000 |
Nested required fields apply when their parent object or array item is supplied. Omitted optional values use the existing operation’s behavior unless a default is listed.
Choose Arrange Selected Layers (Custom Settings…). Enter these plain fields; no JSON is required:
- Layout: Automatic
- Horizontal gap (px):
100 - Vertical gap (px):
100
Agent host input
{"command":"shortcut-tidy","parameters":{"layout":"auto","horizontalSpacing":"100","verticalSpacing":"100"}}Using shortcuts with an agent
Read the machine-readable registry linked below and choose an action offered by the installed plugin’s Quick Actions list. The registry uses Hypermatic option definitions rather than standard JSON Schema: min and max constrain string length, array length or numeric value according to the field type; nested definitions use fields and item. Unknown fields are rejected.
The agent needs a host that can invoke Figma Quick Actions and observe the normal plugin result. Parameters do not add a REST or MCP launcher. The expandable examples are input data for a compatible host, not executable API calls; shortcut inputs use plain strings in parameters, including numbers and format choices. Never claim that a shortcut ran from its prepared input alone.
Verify the visible outcome: the changed Figma layers, saved export, or published page. Read the normal success/error notification and any partial-export warning. Complete native save dialogs as needed; a download starting does not prove that the file was saved. Users do not need to open developer tools or read a console.
Troubleshooting
| Symptom | Next step |
|---|---|
| Action is unavailable | Update the plugin and check its Quick Actions list; use the normal panel if the action is unavailable. |
| Options are invalid or may have been truncated | Use individual plain field values below 150 characters, with only fields accepted by that shortcut. |
| Target is missing or ineligible | Open the correct page, check the action’s layer requirements, and select the intended layers again. |
| A license or trial error appears | Complete the plugin’s normal activation flow before rerunning. |
| Download was requested but no saved file is visible | Check the native save dialog and download location. Inspect the actual file. |
| A command fails, times out or is cancelled | Check the document and remote destination before retrying; earlier changes or uploads may already exist. |
Commands have a five-minute deadline. Errors do not imply a full rollback. Automatically retrying a create, replacement or upload can duplicate or overwrite work.
Machine-readable command registry contains the same action IDs and option definitions.
Current limits
Compression uses selected layers' Figma export formats; conversion requires a chosen format. Export shortcuts do not downsize source image fills. Motion accepts one source; set frame rate in Custom Settings. Arrange changes layout and spacing only. Print canvases, logo canvases, bulk video assembly and detailed Tidy controls use the normal panel.