About the Wix JavaScript SDK


New Release
Our freshly launched SDK is ready for your feedback! Please feel free to reach out to us via email with any comments, suggestions, or concerns. Join the Wix Headless Discord community to discuss features, ask questions, and share ideas with our growing community of developers.

Wix's JavaScript SDK provides npm packages that enable you to access and manage Wix functionality through API calls in your JavaScript code.


The Wix JavaScript SDK can be used with:

  • Wix Headless: Take advantage of Wix functionality from any app or site you create, on any platform.

    You can use the SDK to code external sites or apps that access an existing Wix site's business data, or you can create a new project on Wix that takes advantage of Wix's advanced business solutions for managing bookings, eCommerce, events, and more.

    With Wix Headless, several apps and sites can be connected to the same Wix project, with or without a Wix site created in the Wix Editor.

    Learn more about Wix Headless.

  • Wix Apps: Develop an app that can be installed on Wix sites.

    You can use the SDK to code a Wix App that communicates with sites it's installed on and can access and manage the business solutions installed on the site.

    To use Wix APIs in Apps, site owners must grant you explicit permission for the operations you perform, either when installing the app on their site, or by providing an API key.

    Important: Use of Wix APIs when building Wix Apps are subject to the Wix App Market Guidelines.

    Learn more about building an app.

SDK Packages

The SDK includes a universal npm package @wix/api-client which manages authentication and communication with the Wix platform.

Each domain, such as Contacts or Stores, also has its own npm package, with the naming convention @wix/{domain}. To work with any domain, you need both the universal SDK package and the package for the domain you wish to work with. For example, to work with Contacts, you need both @wix/api-client and @wix/contacts.

These packages are fully typed, making the structure of parameters and fields predictable and easy to work with. Package versioning follows SemVer convention, for convenient dependency management.

Was this helpful?