Umbraco Commerce
CMSCloudHeartcoreDXP
14.latest
14.latest
  • Umbraco Commerce Documentation
  • Release Notes
    • v14.0.0
    • v14.0.0-Alpha
  • Commerce Products
    • Commerce Packages
    • Commerce Payment Providers
    • Commerce Shipping Providers
  • Getting Started
    • Requirements
    • Installation
    • Licensing
    • Configuration
    • User Interface
  • Upgrading
    • Upgrading Umbraco Commerce
    • Version Specific Upgrade Notes
    • Migrate from Vendr to Umbraco Commerce
      • Migrate Umbraco Commerce Checkout
      • Migrate custom Payment Providers
  • How-To Guides
    • Overview
    • Configure SQLite support
    • Limit Order Line Quantity
    • Use an Alternative Database for Umbraco Commerce Tables
    • Add item to Cart
    • Update Cart
    • Delete item from Cart
  • Key Concepts
    • Get to know the main features
    • Base Currency
    • Calculators
    • Currency Exchange Rate Service Provider
    • Dependency Injection
    • Discount Rules / Rewards
    • Events
      • List of validation events
      • List of notification events
    • Fluent API
    • Order Calculation State
    • Payment Forms
    • Payment Providers
    • Pipelines
    • Price/Amount Adjustments
    • Price Freezing
    • Product Adapters
    • Product Bundles
    • Product Variants
      • Complex Variants
    • Properties
    • ReadOnly and Writable Entities
    • Sales Tax Providers
    • Search Specifications
    • Settings Objects
    • Shipping Package Factories
    • Shipping Providers
    • Shipping Range/Rate Providers
    • Tax Sources
    • UI Extensions
      • Analytics Widgets
      • Entity Quick Actions
      • Order Properties
      • Order Collection Properties
      • Order Line Properties
      • Store Menu Items
    • Umbraco Properties
    • Unit of Work
    • Umbraco Commerce Builder
    • Webhooks
  • Reference
    • Stores
    • Shipping
      • Fixed Rate Shipping
      • Dynamic Rate Shipping
      • Realtime Rate Shipping
    • Taxes
      • Fixed Tax Rates
      • Calculated Tax Rates
    • Storefront API
      • Endpoints
        • Order
        • Checkout
        • Product
        • Customer
        • Store
        • Currency
        • Country
        • Payment method
        • Shipping method
        • Content
    • Management API
    • Go behind the scenes
    • Telemetry
  • Tutorials
    • Overview
    • Getting started with Umbraco Commerce: The Backoffice
Powered by GitBook
On this page
  • Introduction
  • Prerequisites
  • Setting Up an Umbraco Project
  • Installing Umbraco Commerce
  • Configuring Umbraco Commerce
  • Accessing the Umbraco Backoffice
  • Setting Up a Store
  • Setting up a Location
  • Setting up Order Status
  • Setting up Payment Methods
  • Setting up Shipping Methods
  • Setting up a Country
  • Setting up a Currency
  • Setting up Taxes
  • Setting up Templates
  • Configuring the Store Settings
  • Built-in Property Editors
  • Accessing Store Permissions in Umbraco Commerce
  • Conclusion

Was this helpful?

Edit on GitHub
Export as PDF
  1. Tutorials

Getting started with Umbraco Commerce: The Backoffice

A guide to setting up Umbraco Commerce, including an introduction to basic concepts and configuration.

PreviousOverview

Last updated 8 months ago

Was this helpful?

This tutorial focuses exclusively on setting up Umbraco Commerce, introducing key concepts, and the configuration process in the Backoffice. It has been tested on the latest releases of Umbraco CMS version 14 and Umbraco Commerce version 14.

This tutorial does not provide instructions for building a complete eCommerce website. It focuses solely on the setup through the Umbraco Backoffice.

Introduction

Umbraco Commerce is an eCommerce platform that integrates seamlessly with Umbraco CMS. It provides features such as product management, order processing, and payment integrations. This guide will walk you through the setup of Umbraco Commerce so you can hit the ground running.

Prerequisites

To follow this tutorial, you'll need the following:

  • Visual Studio Code or your preferred IDE

  • SQL Database (LocalDB or any SQL server)

Setting Up an Umbraco Project

To set up your Umbraco project, see the article.

Installing Umbraco Commerce

Configuring Umbraco Commerce

Accessing the Umbraco Backoffice

You can access the backoffice by adding /umbraco at the end of your website URL. For example: https://mywebsite.com/umbraco.

Setting Up a Store

A store is an online platform where products or services are listed for customers to browse, purchase, and complete transactions over the internet.

To set up a store:

  1. Navigate to the Settings section.

  2. Click + next to Stores.

  3. Enter a Name for the Store (For example: Umbraco Swag Store).

  1. Click Create.

  2. Click Save.

Setting up a Location

If your business operates in multiple regions, setting up locations helps:

  • Configure stores for different locations with their own language, shipping addresses, regional offers, local regulations, and payment gateways.

  • Ship products from different locations. The system can be set up to route orders to the nearest warehouse based on the customer’s location.

To set up a location:

  1. Select your store from the Stores menu in the Settings section. In this case, Umbraco Swag Store.

  2. Go to Locations under the Store.

  3. Click Create Location.

  4. Enter the Name for the Location. For example: Denmark

  5. Provide the necessary address details.

  1. Click Save.

Setting up Order Status

Order status tracks the progression of an order. It helps both the store owner and customers track the progress of the order from the moment it is placed until itis delivered (or returned).

When you first set up Umbraco Commerce, it comes with predefined order statuses to help manage the order lifecycle. These statuses include New, Completed, Cancelled, and Error. These statuses can be customized based on your specific business requirements.

To create an order status:

  1. Go to Order Statuses under the Store.

  2. Click Create Order Status.

  3. Enter a Name for the order status. For Example: Processing

  4. Select a Color for the order status.

  1. Click Save.

Setting up Payment Methods

Payment Methods define the payment options available in the store. By default, Umbraco Commerce includes basic providers like Invoicing and Zero Value to get started.

To set up a payment method:

  1. Go to Payment Methods under the Store.

  2. Click Create Payment Method.

  3. Select a payment provider from the list. For example: Zero Value.

  4. Enter a Name for the payment method. For example: Zero Payment.

  5. Configure the payment method as per your requirements.

  1. Click Save.

Setting up Shipping Methods

Shipping methods determine how customers receive their orders. Setting up shipping methods effectively is crucial, as it impacts customer satisfaction, fulfillment costs, and overall operational efficiency.

To create a shipping method:

  1. Go to Shipping Methods under the Store.

  2. Click Create Shipping Method.

  3. Choose the shipping provider from the list. For Example: DHL.

  4. Enter a Name for the shipping method. For example: DHL.

  5. Configure the shipping method as per your requirements.

  1. Click Save.

Setting up a Country

Setting up a country involves configuring settings related to shipping, payment methods, tax rates, localization, legal compliance requirements, and so on for that specific country.

To set up a country:

  1. Go to Countries under the Store.

  2. Click Create Country.

  3. Choose an item from the list. For Example: Create Country from ISO 3166 preset.

  4. Select a country from the list. For example: Denmark.

  5. Configure the country details as per your requirements.

  1. Click Save.

Setting up a Currency

To set up a currency:

  1. Go to Currencies under the Store.

  2. Click Create Currency.

  3. Enter a Name for the currency. For Example: DKK.

  4. Configure the currency details as per your requirements.

  1. Click Save.

Setting up Taxes

To set up taxes:

  1. Go to Taxes under the Store.

  2. Click Create Tax Class.

  3. Enter a Name for the tax class. For Example: Custom.

  4. Configure the tax rates as per your requirements.

  1. Click Save.

Setting up Templates

Defines the different Email, Print, and Export templates available for the store. These templates help maintain consistency and professionalism in communication with customers and facilitate data handling.

To create an Email Template:

  1. Expand the Templates folder under the Store.

  2. Go to Email Templates.

  3. Click Create Email Template.

  4. Enter a Name for the Email template. For Example: Shipping Notification.

  5. Configure the email details as per your requirements.

  1. Click Save.

Similarly, you can create custom Print and Export Templates.

Configuring the Store Settings

Built-in Property Editors

Umbraco Commerce includes default property editors that help manage and configure eCommerce functionalities within the Umbraco backoffice.

The available property editors include:

  • Price: Used to manage and define product pricing.

  • Store Picker: Allows selection of a specific store for products or configurations.

  • Store Entity Picker: Used for selecting entities like products or categories within a store.

  • Stock: Helps manage stock levels for products.

  • Measurements: Allows the configuration of product dimensions and weight.

  • Variants Editor: Used for managing product variants, such as sizes or colors.

Accessing Store Permissions in Umbraco Commerce

When editing a store in Umbraco Commerce, the Permissions tab allows you to control who can access the store's management interface. This ensures that only authorized individuals or user groups can make changes or view store data.

The Permissions tab contain the following options:

  • User Groups: You can assign permissions to entire user groups. A toggle is provided to either allow or deny access to specific user groups. This is useful for assigning store management roles to groups like "Store Managers" or "Editors" without setting permissions for individual users.

  • Users: In addition to groups, you can assign permissions to individual users. This feature lets you grant or deny store access to specific individuals based on their role in the organization. Like the user group settings, toggle allows you to control what each user can access.

If both a user group and an individual user have conflicting permissions, the "Allow" control will always take priority. For example: "Deny" at the group level and "Allow" at the user level. This ensures that users explicitly granted access will not be denied by group-level settings.

Conclusion

We have now covered the essential steps to set up Umbraco Commerce - from installation to store configuration.

Umbraco Commerce provides a flexible solution for creating and managing eCommerce websites directly within Umbraco CMS. While this tutorial helps you get started, feel free to explore advanced configurations to extend your store's functionality based on your business needs.

Once your Umbraco site is up and running, you can install the .

If you installed Umbraco CMS using an SQLite database, you may encounter errors after installing Umbraco Commerce. To resolve these, follow the instructions in the article.

To access the Commerce section, additional configuration is needed. For detailed steps, see the article.

Setting up a store allows you to manage both the content and commerce aspects of your site. It allows you to create a custom and scalable online shopping experience. For more information, see the article.

Umbraco Commerce also supports the integration of different third-party payment gateways. For more information, see the .

By default, Umbraco Commerce comes with the basic Pickup option. For more information on the integration for different providers, see the .

Setting up currency is essential for ensuring that prices are displayed and transactions are processed accurately. For information on configuring an exchange rate service, see the article.

Tax setup is crucial for compliance with local regulations and for ensuring that your pricing is accurate and transparent. You can set up tax rates for each jurisdiction where you need to collect tax. For more information, see the article.

You can customize your Store's currencies, countries, locations, shipping, tax calculations, and so on. Additionally, you can set Notification, Order, Product, and Gift Card Settings. For detailed settings, see the article.

Umraco CMS Requirements
Umbraco CMS Installation Guide
Umbraco Commerce package
Installation
Umbraco Commerce package
Configure SQLite support
Configuration
Stores
Umbraco Commerce Payment Providers Documentation
Umbraco Commerce Shipping providers Documentation
Currency Exchange Rate Service Provider
Tax Sources
Stores
Create Store
Create Location
Create Order Status
Create Payment Method
Create Shipping Method
Create Country
Create Currency
Create Tax Class Rate
Create Email Template
Built-in Property Editors
Store Permissions