Install Aisleza
What you need and how to install Aisleza on WooCommerce, Shopify, Wix, BigCommerce, Magento or Squarespace.
Aisleza is the same walk-in store on every platform. Pick yours below; the docs remember your choice on every page.
Requirements#
WooCommerce
| What | Version |
|---|---|
| WordPress | 6.5 or later |
| WooCommerce | Active, with at least one product category |
| PHP | 7.4 or later |
| Browser (shoppers) | Any modern browser. 3D needs WebGL; without it shoppers get the shelf wall view automatically |
Aisleza needs no external service, account or API key. Everything, including the 3D engine, ships inside the plugin and runs on your site.
Shopify Coming soon
| What | Needed |
|---|---|
| Shopify | Any plan with the Online Store |
| Theme | An Online Store 2.0 theme (app blocks), such as Dawn or any current theme |
| Collections | At least one collection with products: collections become the aisles |
| Browser (shoppers) | Any modern browser. 3D needs WebGL; without it shoppers get the shelf view automatically |
The Shopify app is built and coming soon to the Shopify App Store.
Wix
| What | Needed |
|---|---|
| Wix site | Any Wix or Wix Studio site |
| Wix Stores | Installed, with products in at least one category: categories become the aisles |
| CMS | Used for your merchandising settings; Wix adds it with the app |
| Browser (shoppers) | Any modern browser. 3D needs WebGL; without it shoppers get the shelf wall view automatically |
Both Wix Stores catalogues (the newer one and the older one) are supported.
BigCommerce Coming soon
| What | Needed |
|---|---|
| BigCommerce | Any plan, with a Stencil theme (Cornerstone or any theme built on it) |
| Categories | At least one category with products: categories become the aisles |
| Page Builder | Used to place the store on a page (Storefront → Themes → Customize) |
| Browser (shoppers) | Any modern browser. 3D needs WebGL; without it shoppers get the shelf wall view automatically |
The BigCommerce app is built and coming soon to the BigCommerce App Marketplace.
Magento
| What | Needed |
|---|---|
| Magento | Magento Open Source or Adobe Commerce 2.4.6 or later, with the Luma theme or one built on it |
| PHP | 8.1 or later (what your Magento version needs) |
| Categories | At least one category with products: categories become the aisles |
| Access | Shell access to run bin/magento, or a host that installs modules for you |
| Browser (shoppers) | Any modern browser. 3D needs WebGL; without it shoppers get the shelf wall view automatically |
Download the free module from aisleza.com (version 1.0.1). Aisleza Pro for Magento is in your Aisleza account after you buy a plan.
Squarespace
| What | Needed |
|---|---|
| Squarespace | A site with a shop page (Commerce), on a plan that runs JavaScript in Code Blocks (any plan above Personal) |
| Products | Products in your shop page, ideally in categories: categories become the aisles |
| Browser (shoppers) | Any modern browser. 3D needs WebGL; without it shoppers get the shelf wall view automatically |
Put the Code Block in a section below your header: themes with a sticky header would otherwise cover the top of the store.
Install#
WooCommerce
- Get the plugin. Download the free plugin (a ZIP file).
- Upload it. In wp-admin go to Plugins → Add New → Upload Plugin, choose the ZIP and press Install Now.
- Activate. Press Activate. A new Aisleza menu appears in the admin menu, just below WooCommerce.
- Open the settings. Go to Aisleza → Settings. The setup card at the top shows five steps and how many are done.
What activation does:
- Adds the Aisleza admin menu with its Settings page.
- Registers the
[aisleza]and[aisleza_link]shortcodes. - Loads nothing on your front end until a page contains the store.
Shopify Coming soon
- Install the app from the Shopify App Store (coming soon) and approve it for your shop.
- Open the app. Go to Apps → Aisleza 3D Store in your Shopify admin. The settings page shows your plan and the setup steps.
- Add the store to a page. Press Add to a page in the theme editor: Shopify opens your theme with the Aisleza 3D store block being added. Save the theme.
The app adds nothing to your theme until you add the block, and uninstalling leaves no theme code behind.
Wix
- Install the app. Open Aisleza on the Wix App Market, press Add to Site and choose your site. Wix asks you to approve the app’s permissions.
- Open the app’s page. In your site’s dashboard go to Apps → Aisleza 3D Store. It shows your plan and how to add the store.
- Add the store to a page. In the editor go to Add Elements → App Widgets → Aisleza 3D Store and drag it onto a page. Then publish.
The app shows nothing on your site until you add the store element. If your site has no Wix Stores yet, the app’s dashboard page and the editor say so.
BigCommerce Coming soon
- Install the app from the BigCommerce App Marketplace (coming soon) and confirm the permissions it asks for.
- Open the app. In your control panel go to Apps → My apps → Aisleza 3D Store. The settings page shows your plan and how to add the store.
- Add the store to a page. Open Storefront → Themes → Customize (Page Builder), choose a page, scroll the widget list to Custom and drag Aisleza 3D Store onto the page. Then Publish.
The app shows nothing on your storefront until you add the widget, and once you uninstall it the widget shows nothing at all.
Magento
- Download the free module (and Aisleza Pro from your Aisleza account if you have a licence).
- Unzip each ZIP at your Magento root. They unpack into
app/code/CodeSolz/Aislezaandapp/code/CodeSolz/AislezaPro. - Run
bin/magento module:enable CodeSolz_Aisleza CodeSolz_AislezaProandbin/magento setup:upgrade. In production mode also runbin/magento setup:di:compile,bin/magento setup:static-content:deploy -fandbin/magento cache:flush. - Open Aisleza → Settings in the Magento admin and choose your aisles. With Pro, enter your licence key under Aisleza → Pro.
Nothing shows on your storefront until you insert the Aisleza 3D Store widget on a page. To remove Aisleza, disable the modules with bin/magento module:disable and delete the two folders.
Squarespace
There’s nothing to install: Aisleza runs from a snippet.
- Edit a page in Squarespace and add a Code block where the store should be.
- Paste the snippet below into the block (change
/shopif your shop page has another address). - Save and open the page on your live site.
<div data-aisleza data-shop="/shop"></div>
<script src="https://sq.aisleza.com/v1/aisleza.js" defer></script>
To remove Aisleza, delete the Code Block.
Installing never changes your shop, menus or checkout. The store only appears on a page you choose.
Next#
Follow Your first store in 10 minutes.