Run common Weblify tasks from Figma Quick Actions without opening the plugin panel. Choose a named shortcut below. The advanced reference covers additional settings and structured bulk inputs.
Run a keyboard shortcut
- 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 Weblify for the normal plugin panel.
| Shortcut | Inputs |
|---|---|
| Create New Page | Page name |
| Export Website | Export name |
| Repair Selected Layouts | None; runs immediately |
| Update Selected Image | URL, Alternative text (optional) |
Advanced shortcuts
Use the clearly labelled Advanced Shortcuts menu for bulk structured inputs or additional export settings. Each entry is tied to one operation; it never asks you to choose an action again. JSON appears only in these advanced entries. Prefer the normal panel for longer content or when you need to browse components or templates.
Advanced entries that use layers accept optional exact node IDs; skipping Target uses the current selection. Creation and whole-site entries have no Target field. Enter only the options documented for that operation below. Keep each pasted field below 150 characters: Figma desktop can truncate pasted input at that boundary. Longer input belongs in the normal plugin panel. The internal parser limit is not a Quick Actions paste allowance.
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.
Weblify actions
| Action | What it does | Target |
|---|---|---|
page | Create a named Weblify page | No layer target |
export | Export the current Weblify site as a static ZIP | No layer target |
responsive | Save tablet or mobile layout policies on selected Weblify layouts | One or more eligible layers |
repair | Repair metadata in selected subtrees without falling back to the whole page | One or more eligible layers |
image | Update the selected placeholder image URL and alt text using the existing image workflow | Exactly one eligible layer |
page
Create a named Weblify page. This action does not take targets.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
name | string | Required | Name of the new item. Minimum 1 character; Maximum 120 characters |
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 Create New Page. Enter these plain fields; no JSON is required:
- Page name:
Home
Agent host input
{"command":"shortcut-page","parameters":{"name":"Home"}}For the full option set, choose Advanced: Create New Page and enter this Advanced options (JSON) value:
{"name":"Home"}Agent host input
{
"command": "advanced-page",
"parameters": {
"options": "{\"name\":\"Home\"}"
}
}export
Export the current Weblify site as a static ZIP. This action does not take targets.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
name | string | Required | Name of the new item. Minimum 1 character; Maximum 120 characters |
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 Website. Enter these plain fields; no JSON is required:
- Export name:
My Website
Agent host input
{"command":"shortcut-export","parameters":{"name":"My Website"}}For the full option set, choose Advanced: Export Website and enter this Advanced options (JSON) value:
{"name":"My Website"}Agent host input
{
"command": "advanced-export",
"parameters": {
"options": "{\"name\":\"My Website\"}"
}
}responsive
Save tablet or mobile layout policies on selected Weblify layouts. Select one or more eligible layers.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
tablet | object | Optional | Responsive breakpoint policy |
tablet.behavior | string | Required | Layout behavior. stack, columns, preserve |
tablet.columns | number | Optional | Column count for columns behavior. 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 |
mobile | object | Optional | Responsive breakpoint policy |
mobile.behavior | string | Required | Layout behavior. stack, columns, preserve |
mobile.columns | number | Optional | Column count for columns behavior. 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 |
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.
For the full option set, choose Advanced: responsive, set Target to selection and enter this Advanced options (JSON) value:
{"mobile":{"behavior":"stack"}}Agent host input
{
"command": "advanced-responsive",
"parameters": {
"target": "selection",
"options": "{\"mobile\":{\"behavior\":\"stack\"}}"
}
}repair
Repair metadata in selected subtrees without falling back to the whole page. Select one or more eligible layers.
This shortcut has no input fields.
Choose Repair Selected Layouts. It runs immediately using the current selection.
Agent host input
{"command":"shortcut-repair","parameters":{}}image
Update the selected placeholder image URL and alt text using the existing image workflow. Select exactly one eligible layer.
| Option | Type | Required / default | Meaning and accepted values |
|---|---|---|---|
url | string | Required | Absolute HTTP or HTTPS image URL without embedded credentials. Minimum 1 character; Maximum 2048 characters |
alt | string | Optional | Alternative text. Maximum 2000 characters |
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 Update Selected Image. Enter these plain fields; no JSON is required:
- URL:
https://example.com/image.png - Alternative text:
Product photo
Agent host input
{"command":"shortcut-image","parameters":{"url":"https://example.com/image.png","alt":"Product photo"}}For the full option set, choose Advanced: Update Selected Image, set Target to selection and enter this Advanced options (JSON) value:
{"url":"https://example.com/image.png","alt":"Product photo"}Agent host input
{
"command": "advanced-image",
"parameters": {
"target": "selection",
"options": "{\"url\":\"https://example.com/image.png\",\"alt\":\"Product photo\"}"
}
}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; everyday shortcuts use plain strings in parameters; only advanced entries use a JSON-encoded parameters.options string. 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 compact JSON below 150 characters, with only fields accepted by that action. |
| 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. The internal JSON parser has a 16,384-character ceiling, but that is not a Quick Actions paste allowance.
Machine-readable command registry contains the same action IDs and option definitions.
Current limits
Component composition and publishing remain interactive. Responsive accepts tablet and/or mobile policies; columns behavior requires a column count, and other behaviors reject it. Repair is selection-scoped. Use the normal Weblify panel for audit, tokens and placeholder inspection. Export operates on the current Weblify site rather than the selection.