Stores

Information on Umbraco Commerce Stores

Stores represent a single shop / commercial entity and contain all the settings a configuration specific to that particular store. They are the root entity from which all other Umbraco Commerce entities are connected. They are also able to be linked to content nodes to connect a store to a site.

Store Settings

General settings for a store can be accessed via the UI by clicking on a store node in the Settings > Commerce section.

General

Name
Description

Base Currency

Defines the base currency a store operates in and for which all order values will be converted for the basis of reporting and analytics.

Default Location

Defines the main location of the store and is used by shipping calculators to work out shipping rates.

Default Country

Defines the default country of the store and is used to set the default payment/shipping country of newly created orders.

Default Order Status

Defines the order status to assign newly created orders to.

Error Order Status

Defines the order status to assign orders to when an error occurs during order processing.

Measurement System

Defines whether to use a Metric or Imperial measurement system when capturing product measurement.

Prices Include Tax

Defines whether all prices entered into the system are inclusive or exclusive of tax.

Use Cookies

Defines whether cookies should be used for tracking a customer's current order, allowing them to last between browser sessions.

Cookie Timeout

If using cookies, define the length of time in minutes the cookie should be persisted for.

Notification Settings

Name
Description

Confirmation Email

Defines the email to send to customers when an order is successfully completed.

Error Email

Defines the email to send to customers when an error occurs when completing their order.

Order Settings

Name
Description

Cart Number Template

Defines a string formatting template to use when generating a Cart Number, eg: 'CART-{0}'.

Order Number Template

Defines a string formatting template to use when generating an Order Number, eg: 'ORDER-{0}'.

Order Rounding Method

Defines At what level in the order calculation process prices should be rounded. Can be either Unit where prices are rounded at the item level, Line where prices are rounded at the order line level after quantity multiplication or Total where prices are rounded at the order total level.

Product Settings

Name
Description

Product Property Aliases

Defines a comma-separated list of property aliases to be copied to the order line when added to the cart. For more details, see the Automatic Properties section.

Product Uniqueness Property Aliases

Defines a comma-separated list of property aliases to be used to define product uniqueness. For more details, see the Product Uniqueness Properties section.

Gift Card Settings

Name
Description

Code Length

Defines the length of a gift card code when auto-generated.

Code Template

Defines a string formatting template to use when auto-generating a gift card code, eg: 'GIFTCARD-{0}'.

Valid For

Defines the number of days gift cards should be valid for by default.

Gift Card Property Aliases

Defines a comma-separated list of property aliases to be copied to the gift card from the order line.

Activation Method

Defines the method by which gift cards become active. Can be Manual where the store owner must manually active the gift card, Automatic where the gift card automatically becomes active after purchase or Order Status where the gift card becomes active when the purchase order moves into a specific order status.

Activation Order Status

When the activation method is Order Status, it defines the order status that activates the gift card.

Default Gift Card Email

Defines the email to be sent to customers if an order contains a gift card item.

Store Configuration

Further store configuration can be achieved by setting up different categories of configuration that can be accessed as child nodes to the store node.

The available configuration options are:

  • Locations - Defines different locations for a store. See Locations reference documentation for more details.

  • Order Statuses - Defines the order statuses to be used by a store.

  • Shipping Methods - Defines the different shipping options available in the store. See Shipping reference documentation for more details.

  • Payment Methods - Defines the different payment options available in the store.

  • Countries - Defines the different shipping countries supported by the store.

  • Currencies - Defines the different currencies accepted by the store.

  • Taxes - Defines the different rates supported by the store.

  • Templating - Defines the different email, print, and export templates available to the store.

Store Permissions

When editing a store, the permissions app allows you to control who can access the store management interface. The options are:

  • User Groups - A set of toggles to allow/deny access to members of a particular user group.

  • Users - A set of toggles to allow/deny access to explicit individuals.

In both cases, a positive access control will always override a deny control setting.

Last updated