App Installation Flow
When deciding how to design your app, it’s important to know how users will add and use it. Understanding this basic user flow will help you design an app that integrates seamlessly with our platform. The best way to do this is to try it yourself, so we’ll recommend relevant apps in each section to add to your Wix site.
Website apps
Here’s the basic flow of how users add website apps, or website extensions that are part of a multiextension app.
- Users can browse the App Market and add your app. When users choose to add your app and approve the required permissions, it opens in the Editor.
- Show demo data so that they can quickly get a sense of what your app does.
- Users open the App Settings panel to set up and customize your app.
Keep in Mind:
If your app includes more than one website extension, only the default extension will be added automatically. Users will be able to add the other app extensions, as extensions, from the App Settings of each website extension- so each extension needs its own name, description, and icon (see Multiextension apps below).
- Once the site is published, site visitors can see and interact with the app.
Example: Wix Events app
Preview mode
As Wix users edit their site in the Wix Editor, they can switch from “editing mode” to “preview mode” to see what their live site will look like. Make sure your app looks the same in “preview mode” as it does in the live site.
Note:
You can detect when the user is in preview mode – listen for the EDIT\_MODE\_CHANGE event in the addEventListener method. Then just display your app the same way you do in the live site.
Deleting website apps
When a user deletes a website extension app, their permissions are revoked.
Note:
If a user removes one extension of a multiextension app, the permissions will remain.
Dashboard apps
Here’s the basic flow of how users add dashboard apps, or dashboard extensions that are part of a multiextension app. (You can learn more about the user flow for multiextension apps, below.)
- Users can browse the App Market and add your app to their site’s dashboard. When users choose to add your app and approve the required permissions, the app opens in their dashboard.
- Users can then set up your app, manage it, etc.
Example: Site Booster
Note:
If your app also includes a website extension, the user will receive a notification that the app needs to be added to their website from the Editor App Market as well (see Multiextension apps below).
Delete Dashboard apps
When a user deletes a dashboard app, their permissions are revoked.
Note:
If the user removes the dashboard extension of a multiextension app, the permissions will remain.
Multiextension apps
When users add a website extension that’s part of a multiextension app, the basic flow is a little different.
- Apps with multiple website extensions: When users add your app and approve the required permissions, only the default and essential website extensions are added automatically (you’ll define this in the Wix Developers Center). Users can add the other website extensions from your app’s settings panel.
- Apps with a website extension and a dashboard extension: Users can add your app from the editor or the dashboard (for example, see the Wix Bookings app):
- When users add your app from the editor, the website extension opens. However, the dashboard extension is added as well, and users will see it next time they go to their dashboard.
- When users add your app from the dashboard, the dashboard extension is added right away, and they’ll see a notification telling them to add your website extension.
- Apps with a tracking extension: When users add your app, your app’s dashboard extension opens. The tracking extension is also added, but users can’t see it since it’s invisible.
Example: the Visitor Analytics app
Delete a Multiextension app
Deleting one extension of the app will remove that extension from their site, but will not affect the user permissions. To delete the app completely and revoke the user permissions, the user must delete all the app extensions.