About Editor URLs

On occasion, your app might want to redirect a site builder to their site's editor or to preview their site with any unpublished changes - for example, to lead them to make changes in your app's settings panel in the editor, or to review changes to the app or the site.

Before you begin

It’s important to note the following points before starting to code:

• Embedded script extensions won't be displayed in the preview.

Use cases

• Direct site builders to their site editor.
• Direct site builders to preview the latest changes.

Terminology

• Editor: The platform site builders' use to build and edit their sites. Wix offers 3 editors for site builders:
  • Wix Studio
  • Wix Editor
  • Editor X - partially deprecated
• Preview: A feature that enables site builders to see what any changes made on their site (in the editor, or in your app) will look like to visitors, without publishing the site. Wix recommends that site builders preview their sites to test how new changes and updates look before publishing them.

Sample flows

This article shares some possible use cases your app could support, as well as an example flow that could support each use case. You're certainly not limited to these use cases, but they can be a helpful jumping off point as you plan your app's implementation.

Direct site builders to their site editor

You might choose to direct site builders from within your app to the site editor, for example to place a visual extension in the site.

1. Include a call to action that redirects to the editor - for example, a button.
2. Whenever the site builder clicks the button, call the Get Editor URLs endpoint.
3. Redirect the site builder to the URL provided in the editorUrl parameter.

Direct site builders to preview the latest changes

If a site builder makes changes to the app's behavior or UI, you might choose to direct them to preview those changes using Wix's site preview feature. This flow is equally relevant if you choose to direct them to preview changes made directly in the site editor.

1. Include a call to action that redirects to preview the site - for example, a button.
2. Whenever the site builder clicks the button, call the Get Editor URLs endpoint.
3. Redirect the site builder to the URL provided in the previewUrl parameter.