This article is part of our complete Wix guide.
If you want to build a Wix app, you are building software that site owners install from the Wix App Market to add features to their own sites. That is different from adding code to one website. A Wix app is a product: it needs a clear use case, a secure way to access site data, a dashboard where owners configure it, often a widget that appears on the live site, and a listing that passes Wix’s review. This guide explains the Wix app framework at a practical level, so you can plan your build, choose the right tools and avoid the usual dead ends.
Key takeaways
- Wix apps are built and registered through the Wix developers platform at dev.wix.com, where you create the app, configure permissions and manage your listing.
- You can build Wix-hosted apps with the Wix CLI or Wix Blocks, or self-hosted apps that run on your own servers.
- Apps are made of extensions: dashboard pages, site widgets and plugins, embedded scripts, backend extensions and webhooks.
- Request only the permissions you need; they affect user trust and review.
- App Market review checks quality, listing accuracy and user experience, so plan time for feedback.
In this guide
- Wix app vs custom code on one site
- How to validate a Wix app idea
- Wix CLI, Wix Blocks or self-hosted?
- Wix app extensions explained
- Permissions, OAuth and app instances
- How to build a Wix app step by step
- Submitting to the Wix App Market
- Common mistakes when building Wix apps
- Need help building a Wix app? Let MIVAQ do it for you
- Frequently asked questions
Wix app vs custom code on one site
Before building an app, check you really need one. If the feature is for a single website, Velo custom code or a custom code embed is usually faster and cheaper. An app makes sense when the same feature should be installed on many sites, when you want to sell it by subscription, or when a client with several sites wants one central tool they can manage.
| Question | Velo on one site | Wix app |
|---|---|---|
| How many sites use it? | One | Many, installed from the App Market or privately |
| Who maintains it? | The site owner or their developer | The app developer, centrally |
| Can you charge for it? | Through your project fee | Yes, through app pricing plans |
| Review needed? | No | Yes, for public App Market listings |
| Setup effort | Low to medium | Medium to high |
How to validate a Wix app idea
The App Market rewards apps that solve a specific, painful problem for a defined group of Wix users. Before writing code:
- Search the App Market for existing apps. Read their low-star reviews; complaints are a list of features people want.
- Check the Wix forums and communities for repeated requests that Wix has not solved natively.
- Define the user. “Auto parts stores that need fitment search” is better than “online stores”.
- Confirm the data exists in Wix. If your app depends on store products, bookings or contacts, check the relevant APIs support what you need.
- Sketch the dashboard and widget on paper. If the setup takes more than a few minutes for the site owner, simplify.
At MIVAQ we followed this process for our first Wix app, a Year/Make/Model parts finder for auto parts stores, which is currently in development. Many parts sellers move between platforms and need fitment search that standard filters cannot provide. You can follow its progress on our MIVAQ apps for Wix page.
Wix CLI, Wix Blocks or self-hosted?
Wix supports several ways to build apps. Names and features evolve, so confirm details in the Wix developer documentation, but the main paths are:
Wix CLI for apps
The Wix CLI creates an app project on your computer, typically using React and TypeScript for the user interface. You add extensions with CLI commands, run a local development server against a test site, and deploy to Wix, which hosts the app. This is the most flexible Wix-hosted option for developers comfortable with modern JavaScript tooling.
Wix Blocks
Wix Blocks is a visual tool for building widgets and simple dashboard panels with Velo-style code. It suits designers and Velo developers who want to package a reusable widget without setting up a full local toolchain.
Self-hosted apps
A self-hosted app runs on your own servers and talks to Wix through REST APIs and webhooks, with OAuth for authorisation. This suits teams with an existing SaaS product, or apps that need heavy processing, their own database or integrations across several platforms, such as an app that also runs on Shopify.
Wix app extensions explained
An app is a bundle of extensions. Each extension plugs into a specific place in the Wix ecosystem:
- Dashboard pages and menu items appear in the site owner’s dashboard. This is where they configure your app, view data and manage settings.
- Dashboard plugins add panels inside existing Wix dashboard pages, such as an extra section on the orders page.
- Site widgets are elements the owner drags onto pages in the editor, with their own settings panel. A search box or product finder is a site widget.
- Site plugins slot into predefined spots inside Wix business apps, such as a product page or checkout area.
- Embedded scripts inject code into the live site, for example tracking or chat scripts.
- Backend extensions let your app provide custom logic to Wix services, such as shipping rates or additional fees, plus backend APIs and scheduled tasks.
- Webhooks and events notify your app when something happens, such as an order being paid or the app being installed or removed.
Most apps need two or three of these. A parts finder, for example, needs a dashboard page to manage vehicle data, a site widget for the search, and access to store products.
Permissions, OAuth and app instances
When a site owner installs your app, they grant it permissions (scopes) such as reading store products or managing contacts. You choose these in your app’s settings on dev.wix.com. Ask only for what you use; long permission lists put people off and draw questions during review.
Each installation has its own app instance, which identifies that site. Your app must keep each site’s data separate and respond correctly to install, upgrade and uninstall events. Self-hosted apps use an OAuth flow to obtain access tokens; Wix-hosted CLI apps handle much of this for you. Either way, never expose secrets in front-end code, and store tokens securely.
How to build a Wix app step by step
- Create a developer account and a new app on dev.wix.com.
- Create a free test site where you will install and try the app.
- Choose your path: Wix CLI, Wix Blocks or self-hosted.
- Set permissions for the Wix data your app needs.
- Build the dashboard page first, so you can configure and seed test data.
- Add the site widget or plugin with a settings panel and responsive design that works on mobile.
- Handle lifecycle events for install, uninstall and plan changes.
- Test on several templates and in both the Wix Editor and Wix Studio, including slow connections.
- Set up pricing if the app will be paid, with clear free and premium limits.
- Prepare the listing: name, short and long description, screenshots, support email, privacy policy and terms.
- Submit for review, respond to feedback and publish.
Want a team that has already been through this process? Our Wix development services cover app planning, build and submission.
Submitting to the Wix App Market
Wix reviews public apps before they appear in the App Market. Reviewers check that the app works as described, installs cleanly, has a usable dashboard, follows design and UX guidelines, requests appropriate permissions and has a complete, honest listing. Expect feedback and possibly more than one round of changes.
A strong listing explains the problem in the first line, shows real screenshots of the dashboard and widget, and makes setup sound quick. After launch, respond to reviews quickly and keep a public changelog. Ratings and active installs influence how visible your app is, so support quality matters as much as code quality.
If your app adds content to the live site, such as a widget that lists products or vehicles, make sure it outputs crawlable text, sensible headings and alt text, so it supports rather than harms the owner’s rankings. Site owners increasingly ask about this, and our SEO for Wix websites guide explains what Google needs to see. A fast, SEO-friendly widget is also a selling point you can mention in your listing.
You can also publish apps privately for specific clients rather than listing them publicly, which is useful for bespoke tools shared across a company’s sites.
Common mistakes when building Wix apps
- Building before validating demand. Months of work on an app nobody searches for is the most expensive mistake.
- Over-requesting permissions, which hurts installs and review.
- Ignoring Wix Studio and mobile, so widgets break on some layouts.
- Complicated onboarding. If owners need a manual to start, many will uninstall.
- Not handling uninstall, leaving data or billing in a messy state.
- No support plan. Slow replies lead to poor reviews.
Pre-submission checklist
- Installs and uninstalls cleanly on a fresh site
- Dashboard explains first steps clearly
- Widget responsive on desktop, tablet and mobile
- Only necessary permissions requested
- Privacy policy, terms and support contact ready
- Screenshots and description match the real app
Need help building a Wix app? Let MIVAQ do it for you
MIVAQ builds Wix apps, both our own products for the Wix App Market and custom apps for clients. We can validate your idea, design the dashboard and widget experience, choose between Wix-hosted and self-hosted architecture, build and test the extensions, prepare your listing and guide you through review. If you already have a Shopify app, we can plan a separate Wix version that fits how Wix users work.
Every project starts with a free consultation and a fixed-price quote for a clearly defined first version. Learn more on our Wix app development page and our main Wix solutions page.
- WhatsApp: message us
- Email: hello@mivaq.com
- Form: send your project details
Frequently asked questions
Do I need to know coding to build a Wix app?
Yes, for most apps. Wix Blocks lowers the barrier for simple widgets, but dashboard logic, permissions and data handling require JavaScript knowledge.
Can I sell my Wix app?
Yes. Apps on the Wix App Market can offer free and paid plans billed through Wix. Check the current developer terms on dev.wix.com for revenue details.
How long does App Market review take?
It varies with the app and the number of revision rounds. Prepare a complete listing and test thoroughly to reduce back-and-forth.
Can I convert a Shopify app into a Wix app?
Your backend logic can often be reused, but the Wix version needs its own extensions, permissions, dashboard and listing. Plan it as a separate app.
Can MIVAQ build a custom Wix app for my business?
Yes. We build public and private Wix apps with a fixed-price quote after a free consultation. Contact us on WhatsApp, by email or through our form.
Related Wix guides
- Best Wix apps for small businesses
- Velo by Wix: a beginner’s guide
- Wix CMS and dynamic pages explained
- Auto parts store on Wix with Year/Make/Model search
- Wix Editor vs Wix Studio
- The complete Wix guide
Conclusion
Building a Wix app is a product journey: validate the problem, choose the right hosting path, combine the right extensions, request minimal permissions and launch with a listing that sells. If you would like an experienced partner for any part of it, send MIVAQ your app idea for a free consultation.
