App Instance Object


An app instance is a specific occurrence of an app on a Wix site. When a Wix user installs an app, a unique instance is generated for that specific site. Use the instanceId to keep track of the individual data associated with each app instance.

Properties
instanceIdstring

App instance ID. Useful to keep track of the data that's associated with the specific instance of your app installed on a Wix site.


appNamestring

App name, as you entered it in the App Dashboard.


appVersionstring

Version of your app that's installed on the Wix site.


isFreeboolean

Whether the Wix user has installed a free or paid version of your app on their site.


billingBilling

Billing information for the app instance. Available only in case {"isFree": false}.


permissionsArray <string>

List of permissions that the Wix user has granted your app. You set the list of permissions that your app requires from the Wix user in your app's Permissions page.


availablePlansArray <AvailablePlan>

Plans available to this app instance.


originInstanceIdstring

ID of the Wix site from which the instance of your app has been cloned. Available only when {"copiedFromTemplate": true}. All visual settings of the Wix site and app data are duplicated during the cloning process. Wix also notifies you in case there is any additional external functionality for the original site.


isOriginSiteTemplatebooleandeprecated

Deprecated. This parameter will be removed on March 30, 2023. Use copiedFromTemplate instead.


copiedFromTemplateboolean

Whether this app instance was created when another Wix site was cloned.


freeTrialAvailableboolean

Whether this app instance includes a free trial that hasn't started yet.

Did this help?

GET

Get App Instance


Retrieves data about the instance of your app that's installed on a Wix site and data about the site itself. For example, to check whether the Wix user has installed a free or paid version of your app, or to check which apps made by Wix are installed on the site.

You must authenticate this method as a Wix app (REST | SDK).

To retrieve site.ownerInfo in the response, you must have the READ SITE OWNER EMAIL permission scope in addition to MANAGE YOUR APP.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Your App
Read site, business, and email details
Learn more about app permissions.
Endpoint
GET
https://www.wixapis.com/apps/v1/instance

Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?

App Instance Installed


Triggered when an instance of your app is installed on a Wix site.

Event BodyEvent Body Event data is received as a JSON Web Token (JWT). It may be delayed. Be sure to verify the data was sent by Wix.
Event Data
appIdstring

Unique identifier of the app within the website.


originInstanceIdstring

Instance ID of the app in the original website (relevant only when this site was duplicated from another site).

Did this help?

App Instance Removed


Triggered when an instance of your app is uninstalled from a Wix site.

Event BodyEvent Body Event data is received as a JSON Web Token (JWT). It may be delayed. Be sure to verify the data was sent by Wix.
Event Data
appIdstring

Unique identifier of the app within the website.

Did this help?