Installation

Before downloading Merchello, review the following Umbraco to Merchello compatibility matrix.

Umbraco Version	Merchello Version
Umbraco 7.0.x & 7.1.x	1.1.x to 1.5.1
Umbraco 7.2.x	1.6.0 to 1.12.0
Umbraco 7.3.x	1.13.x to current

❗️

Umbraco Beta and Pre-Release Version

Merchello's development process often lags behind Umbraco's ongoing development, largely because the project itself is completely dependent on Umbraco. As a result we cannot immediately confirm Merchello will work flawlessly with every Umbraco version - especially major release versions.

If you would like to verify the compatibility of the two products, please post a question in the forum.

Download Merchello from http://our.umbraco.org/projects/collaboration/merchello.

Package Files	Description
Merchello-[VERSION].zip	Main package file. Installs Merchello into an Umbraco instance. Intended to be uploaded through Umbraco's package manager.
Merchello.Bazaar.StoreOnly_[VERSION].zip	Starter kit only. Installs ONLY the Bazaar store front end and REQUIRES that Merchello has been previously installed.
Merchello.Bazaar.CombinedInstall_[VERSION].zip	Package file. Installs BOTH Merchello and the Bazaar starter kit from a single package install. Intended to be uploaded through Umbraco's package manager.

📘

Alternatively

You can install Merchello from the Umbraco package Repository in the back office, search for "Merchello." And install from there. This option will install Merchello without a starter kit.

In the Umbraco backend go to the Developer section. In the Developer/Packages section, select Install local package .

Click the Accept License check box and select Install Package for the Merchello file you just downloaded.

When the installation is done, you will see the Package is Installed screen.

Installation for a Class Library or non-website project

When you only need the Merchello Core binaries, use Nuget to pull in "Merchello.Core."

PM> Install-Package Merchello.Core

❗️

1.13.2 - UaaS Installation (Experimental)

The install for Merchello has been updated to be more compatible with Umbraco as a Service.

A supplemental zip file can be downloaded that contains the configuration transforms needed to run Merchello on UaaS. The web.config transforms should go in the root. The Umbraco specific config transforms should be placed in the /Config folder.