About App Components

There are two main types of component: website and dashboard. All apps must have at least one component, but you can have two or more.

You can find the Components tab in the Wix Developers Center. This is where you'll add and connect your components to the Wix system.

Click Add Component to get started.
Note:
All new apps that use an OAuth access token will need to have at least one dashboard component.

Website Components

A website component is an element on the user’s live site, and its purpose is to help Wix users engage with site visitors.

Page

This is a full-page element that's added to the user's live site. It appears in the main navigation menu and behaves just like any other page. 

A page component can have internal pages, each with its own URL – so it’s ideal for apps that use deep linking (like a blog, forum, or e-commerce store). To build a page component you'll need to create an App Settings panel.

Want to know more about adding page components? Read this article.

Worker

A worker component is a hidden iframe that allows you to run background JavaScript on each page of a live site. This lets you track site visitor activity and manage background tasks.

This invisible iframe is added to both the Wix Editor and the live site. As users can’t see this component, you need to combine it with a visible component, like a widget or dashboard. You'll need to create a new endpoint, and add a reference to our SDK.

Widget

Note:
This functionality isn't available for all users right now. If you'd like to request access you can submit a proposal.
A small element that can be added to any or all pages of an existing website. Standard widgets can be placed anywhere on a page; pinned widgets are automatically placed in a specific location on a page. Want to learn more about widget components? Read this article.

Embedded Script

This lets your app insert custom script tags to the <head> tag of your users' websites. They can only be added by the owners of Premium Wix sites with connected domains.

Want to know more about adding embedded scripts? Read this article.

Dashboard Components

These are back-office services that can help users manage their business or website. They won't be seen on the user's live site.

Internal

A component iframe that's available in the user's Wix dashboard. The dashboard component isn’t part of the live site, so only Wix users can see it (not site visitors). You'll need to create a new endpoint, and we recommend that you add a reference to our SDK (this is optional).

External

An external dashboard hosted in your platform or site, with a link from the user's Wix dashboard.

Extension

A Wix dashboard extension is an app that integrates with an existing Wix app's dashboard page (e.g., Wix Stores). There are two types of dashboard extension:
  • iFrame widget: your app will be rendered in a container with a Wix app's dashboard page.
  • Menu item: your app will appear in a Wix app's dashboard menu, linking out to your app.
Want to know more about building dashboard components? Read this article.

Next steps

Now you know a bit about the types of components you can build for Wix, you may want to check out how to set up the relevant OAuth, webhooks, and APIs for your app.

Related Content