A preview link opens a copy of your app, as it is on this canvas right now, for anyone who has the link. No Modeinspect account is needed. Use it when a stakeholder should click through a change before it becomes a pull request.
Before you start
A canvas whose Portal shows your app. The copy is made from the app the canvas runs, so it includes every change the agent has built here.
Steps
Click Share in the canvas header. The popover shows Preview URL and, on a canvas that was never published, "Not published".
Click Create Preview Link. The button spins for a few seconds, then the toast "Preview Link Created" appears and the popover reads "Published less than a minute ago".
Click Copy. The toast reads "Copied Preview Link". Open opens the link in a new tab.
Send the link. The viewer sees your app's start page in their browser, without signing in, and can click through it.
The link works for 30 days from the moment you copy it. To hand it out after that, open Share and click Copy again: the address is the same, with a fresh 30 days.
Keep the link current
The copy is frozen: changes the agent builds after you publish do not reach it. Once the code on the canvas has changed, the popover shows Update in place of Everything up to date.
Click Update. The toast reads "Preview Link Updated", and people who already have the link see the new version the next time they open it.
Preview link or page link
Preview link | Page link | |
|---|---|---|
Shows | the app as it was when you published or updated | the app as it is now, including what the agent builds later |
Opens on | the app's start page | the page you were on |
Works for | 30 days from each copy | 7 days from each copy |
You get it from | Share in the canvas header | the Build Mode address bar or a selected Portal |
See Share a link to the page you are on for the second kind.
If it does not work
The popover says "Preview links are disabled for this organization.": your organization has preview links turned off. Contact support to have them turned on.
The toast reads "Error Creating Preview Link" or "Error Updating Preview Link": the copy could not be made. Click the button again.
The viewer sees a blank page that says "Unauthorized": the link is older than 30 days, or it was pasted without the long part after
preview_token=. Copy it again from Share and send the whole address.