# Installation

In this article, you will learn how to install Umbraco Commerce into your Umbraco CMS implementation.

## Prerequisites

For system requirements, see the [Requirements](https://docs.umbraco.com/umbraco-commerce/getting-started/requirements) article.

## Umbraco Commerce Installation

There are different ways to install Umbraco Commerce:

* [NuGet Package Installation](#nuget-package-installation)
* [Visual Studio Installation](#visual-studio-installation)

### NuGet Package Installation

Umbraco Commerce is available via [NuGet.Org](https://www.nuget.org/packages/Umbraco.Commerce/).

To install Umbraco Commerce via NuGet:

1. Run the following command in the NuGet Manager Console window:

   ```bash
   dotnet add package Umbraco.Commerce
   ```
2. Restart the application using the following command:

   ```bash
   dotnet run
   ```

### Visual Studio Installation

To install via Visual Studio, follow these steps:

1. Open your project in Visual Studio.
2. Go to **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution...**
3. Browse for **Umbraco.Commerce**.

   ![Installing Umbraco Commerce via the NuGet Package Manager](https://3343668521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlHETtFOx4I72xhuc27Kt%2Fuploads%2Fgit-blob-d384d28cfda5ebe195793890c2909b15198c8c78%2Fnuget-package-overview.png?alt=media)
4. Select the appropriate version from the **Version** drop-down depending on the Umbraco version you are using.
5. Click **Install**.
6. Ensure that the package reference is added to the **.csproj** file once the installation is complete:

   ```cs
   <ItemGroup>
   <PackageReference Include="Umbraco.Commerce" Version="xx.x.x" />
   </ItemGroup>
   ```

For most projects, you only need a single package to install Umbraco Commerce. But if your solution is more complex with multiple projects, Umbraco Commerce provides sub-packages to match different dependencies.

<table><thead><tr><th width="282">Sub-package</th><th>Description</th></tr></thead><tbody><tr><td><strong>Umbraco.Commerce.Common</strong></td><td>A shared project of common, non-Commerce-specific patterns and helpers.</td></tr><tr><td><strong>Umbraco.Commerce.Core</strong></td><td>Core Commerce functionality that doesn't require any infrastructure-specific dependencies.</td></tr><tr><td><strong>Umbraco.Commerce.Infrastructure</strong></td><td>Infrastructure-specific project containing implementations of core Commerce functionality.</td></tr><tr><td><strong>Umbraco.Commerce.Persistence.SqlServer</strong></td><td>Persistence-specific project containing implementations of core Commerce persistence functionality for SQL Server.</td></tr><tr><td><strong>Umbraco.Commerce.Persistence.Sqllite</strong></td><td>Persistence-specific project containing implementations of core Commerce persistence functionality for SQLite.</td></tr><tr><td><strong>Umbraco.Commerce.Web</strong></td><td>Core Commerce functionality that requires a web context.</td></tr><tr><td><strong>Umbraco.Commerce.Cms</strong></td><td>Core Commerce functionality that requires an Umbraco dependency.</td></tr><tr><td><strong>Umbraco.Commerce.Cms.Web</strong></td><td>The Commerce functionality for the Umbraco presentation layer.</td></tr><tr><td><strong>Umbraco.Commerce.Cms.Web.Api</strong></td><td>A shared project of common API specific functionality.</td></tr><tr><td><strong>Umbraco.Commerce.Cms.Web.Api.Management</strong></td><td>The backoffice Management API layer.</td></tr><tr><td><strong>Umbraco.Commerce.Cms.Web.Api.Payment</strong></td><td>The Payment handling API layer.</td></tr><tr><td><strong>Umbraco.Commerce.Cms.Web.Api.Storefront</strong></td><td>The frontend Storefront API layer.</td></tr><tr><td><strong>Umbraco.Commerce.Cms.Web.UI</strong></td><td>The static Commerce assets for the Umbraco presentation layer.</td></tr><tr><td><strong>Umbraco.Commerce.Cms.Startup</strong></td><td>The Commerce functionality for registering Commerce with Umbraco.</td></tr><tr><td><strong>Umbraco.Commerce</strong></td><td>The main Commerce package entry point package.</td></tr></tbody></table>

{% hint style="info" %}
If you encounter an SQLite error after installing Umbraco Commerce, you may need to enable SQLite support. For more information, see the [Configure SQLite support](https://docs.umbraco.com/umbraco-commerce/how-to-guides/configure-sqlite-support) article.
{% endhint %}

## Installing a License

For details on how to install a license, see the [Licensing](https://docs.umbraco.com/umbraco-commerce/getting-started/the-licensing-model) article.

## Using Umbraco Commerce

Once Umbraco Commerce is installed, you can find it in the Umbraco backoffice under the **Settings** and **Content** sections. To access the **Commerce** section, additional configuration is required. For more details, see the [Configuration](https://docs.umbraco.com/umbraco-commerce/getting-started/umbraco-configuration) article.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-commerce/getting-started/install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.