Get the site's editor link
get_editor_linkReturn a link to the site owner's own visual editor, optionally opening straight to one page or collection item. Give this to the person whenever the next step is theirs rather than yours:
They want to use THEIR OWN image. Pass
image_targetnaming the spot and they get a one-time photo link instead of the editor: one page, one drop, placed on that spot in the draft, no sign-in. Without a spot they get the editor. This is the dividing line for every image on the site, sections and collection items alike: you source pictures withfind_images,replace_images_from_searchandupload_image (with url)and place them yourself, but a file that exists only on their device — their logo, their team photo, their product shots — comes in through the editor. Point them at the exact page or item (page_slugtakes 'blog/my-post' as happily as 'about') rather than the site root.They want to make a change themselves, or asked where to edit something.
They asked to see their site, or seem unaware there is a visual builder at all — many people who connect this connector never find out.
The link opens their editor signed in as them. Do not promise they are already signed in: the session cookie may not exist on the device they open it from, in which case they are sent to sign in first and land in the editor afterwards. share_with_user is worded for that.
The editor link is nothing secret — an ordinary product URL, authenticated by the person's own account. A photo link is a one-time capability for that one spot (30 minutes, one upload, draft only): give it to the person and to no one else.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alt | No | With image_target: alt text for the photo, if they told you what it shows. Omit to keep the spot's current alt text. | |
| task | No | What the person is going there to do, so the instructions match the actual UI. 'image' — they are supplying their own photo; the steps differ between a standalone image and a background and neither is guessable. 'edit' — any other change they make themselves. Omit only if you genuinely don't know. | |
| site_id | Yes | The site UUID whose editor link should be returned. | |
| page_slug | No | Optional path to open directly. A page slug ('about'), or a collection item's full path ('blog/my-first-post', 'projects/harbour-house') — nested paths are fine. Omit for the home page. Send them to the exact thing they need to change; 'it's in the editor somewhere' is how people give up. | |
| image_target | No | The ONE spot their own photo goes: { node_id } for an image or a section's background photo, or { content_type, item_slug, field } for a collection item's photo. With this, the person gets a one-time link to a page that does only that: they drop the file and it is placed on that spot in the draft. No sign-in, no editor, nothing to save. Use it whenever they have their own photo for a spot you can name. |