Welcome to Shuup Guide!

Contents:

Using the Shuup Admin

Sorting and Filtering Tables

Different pages in the Shuup Admin may contain a table of different items (such as customers, orders, or products). Rows within this table may be sortable or filterable, depending on the section.

If a column is sortable, you will be able to change the sorting behavior (unsorted, alphabetical, or reverse alphabetical) by clicking the name of the column.

If a column is filterable, a text box or other filter fields will be available to adjust the filters. Rows that do not match the filter will not be displayed.

Products

Adding Products

The Shuup Admin provides a simple interface for adding products to your shop.

To navigate to the Products section of the Shuup Admin, open the Admin menu and select the Products section under the Products category.

_images/products-menu.png

On the Products page, you will see a list of all of the products currently in your shop. In the upper right-hand corner there is a button labelled New product for creating new products. Clicking this will take you to the new product form, where you can enter information about your new product.

_images/new-product-button.png

New Product Form

_images/new-product-form.png

Like other Shuup Admin forms, required fields are marked with a red asterisk and missing or invalid fields will be highlighted red upon form submission.

The left side of the form contains a number of sections of the form (shown as tabs), and selecting a tab will present the different fields and options for that section.

Base Product Tabs

The top section of the form contains most of the basic product information and settings.

General Information
General information about the product, including product type, name, and product description.
Additional Details
Miscellaneous information regarding the product, such as the product’s stock and shipping mode, barcode information, and relevant keywords.
Accounting
Bookkeeping-related information.
Physical Properties
Physical dimensions and unit information for the product.
Manufacturer
Selection choice for the product’s manufacturer.
Shop-Specific Tabs

Following the base product section are the following shop-specific tabs. The names of these are preceeded by the relevant shop’s name (initially Default):

Visibility
Front-end visibility settings for a specific shop.
Purchasing
Pricing, supplier, and multiple-purchase settings.
Shipping & Payment
Shipping and payment service-related settings (used to limit customer shipping and payment choices on checkout).
Media Tabs

These sections are for managing the image and digital media content related to the product.

Product Media
Product-related file uploader and selector.
Product Images
Product image uploader and selector.

Tip

Advanced Product Media settings can be configured to deliver digital and downloadable content.

Customer Group Pricing Tab

Pricing settings based on customer groups. If a customer belongs to multiple groups, they will be presented the lowest price of the groups to which they belong.

Note

Customer Group pricing is currently not configurable for specific shops.

Saved Product Form

Once the product has been successfully saved, additional options will be available from the product edit form.

Attributes Tab

See Attributes.

Stock Management Tab

For stocked product, this should display any stock-related management tasks depending on the product’s supplier settings.

Orders Management Tab

Show recent orders containing the product.

Product Types

Product Types define classes products and are used to associate different sets of attributes to a particular product, depending on its product type.

For example, a product of type Book might require specific information such as author, ISBN, publisher, etc, while a product of type Clothing might require size, color, or other custom attributes.

Attributes

Shop owners can define their own attributes for Product Types from the Attributes Admin.

  1. Select the Attributes category from the Shuup Admin menu
  2. Click the New attribute button in the upper right-hand corner
  3. Enter a name and unique identifer for the attribute, and select the type, visibility mode, and searchability for the attribute
  4. Select the Product Type page (under the Products category) from the Shuup Admin menu
  5. Select the Product Type from the menu
  6. Under the Attributes tab, check the box next to the attribute name for your new attribute.

Tip

By default, new attributes are displayed on the product page, but there are multiple visibility options that can be selected form the Attributes edit page.

Cross-Selling

Adding Cross-Sells

Related products can be sold together on Shuup’s storefront by using Shuup’s cross-selling feature. These relationships can be managed from the Shuup Product admin.

To add a relationship for a particular product, navigate to the product’s page and select Manage Cross-Selling from the Actions menu.

_images/action-menu.png

Products can be selected by clicking the Browse button and clicking on the desired product from the product list.

_images/cross-sells-add-relationship.png

Once the product has been selected, the relationship’s weight can be set.

The relationship weight is used when calculating which products will be displayed together on the shop front. The higher the relationship weight the more likely the products are to be displayed together.

Finally, you can select one of the following relationship types:

Recommended
Products are recommended to be bought together.
Related
Products are related.
Computed
Primarily reserved for use by add-ons.
Bought With
Primarily reserved for internal use. These relationships are automatically calculated by automated Shuup tasks, however if these tasks have not been configured by the server administrator, they can be defined manually here.

Note

Only five relationships can be added at once. However, more can be added once these relationships have been savd. This can be repeated as necessary.

Displaying Cross-Sells

Once defined in the Product admin, cross-sell relationships can be displayed on the store front using the Xtheme Cross-Sells plugin.

_images/cross-sells-displayed.png

Follow the following steps to display a relationship type on the store front:

  1. Make sure you are logged in as an administrator and navigate to the store front.
  2. Navigate to any product page.
  3. Click on the Edit Page button in the lower right-hand corner of the page.
  4. Select one of the Xtheme placeholder boxes.
  5. Add a new row or new column for your plugin.
  6. Select Product Cross Sells from the plugin dropdown menu.
  7. Add a title if desired, select the relationship type, and set the count as the number of products to be displayed at once. You can also select whether or not to hide out-of-stock or unorderable items.
  8. Save the plugin.
  9. Publish your changes.
  10. Click the Exit Edit button in the lower right-hand corner of the page
  11. Your products should now appear in the placeholder on the product’s page.

Note

Cross-sell relationships are only one-way and must be manually added to any related product you would like to relate back to the original product.

Note

If there are no relationships of the selected type for a particular product, the plugin will not be displayed.

Package Products

Package products are used to package a number of related products to be sold as a single product package.

These products are stored a single package parent, which can be linked to multiple package children.

Stock for child products is automatically updated when the package is purchased. Pricing, discounts, etc, of the parent product can be managed like any other product.

To convert a product to a package parent:

  1. Navigate to the parent product’s edit page and select Convert to Package Parent from the Actions dropdown menu.

    _images/convert-to-package-parent-dropdown.png
  2. Click the Browse button to add child products to the package. Enter the quantity of each product to include in the package.

    _images/package-products-form.png
  3. Click Save to save the package’s child product informatino.

Variation Products

Some products may be available to customers in a number of different variations, and customers should be able to choose from these different available options when adding products to their cart.

Shuup provides two different types of product variations, simple variations and variable variations.

Simple Variations

Simple variations are general variations that are displayed on the product page as a simple drop-down menu where the user can select from any of the available variation product choices.

Variable Variations

Variable variations allow you to define child products based on a specific variable. For example, a product might have variables such as size or colors, with different options for each, and the customer should be able to select from a combination of these options.

To add variable variations:

  1. Navigate to the parent product’s edit page and select Convert to Variation Parent from the Actions menu.
  2. Select Variables from the left-hand menu
  3. Click Add new variable to add a new variable form
  4. Enter the variable name
  5. Click Add new value
  6. Enter names for possible values
  7. Continue for other variables/values as needed
  8. When finished, click Save in the toolbar
_images/variable-product-selector.png

Once these variables have been added, “child” products can be linked for each combination of variables. For example, if there are 3 size values and 2 color values, there will be 6 child products, one for each size, color combination.

Tip

Names for child products should follow a consistent naming scheme indicating the variable value for each product.

Tip

Variable variations can be converted to simple variations by clicking Convert to simple variation on the Variation view toolbar. However, all variable and value information will be lost.

Managing Variations

Once a product has been converted to a simple or variable variation parent, it can be managed by selecting Manage Variations from the Actions menu for either the variation parent’s admin page or the admin page for any of the child variation products.

Using Themes

Installing Themes

Shuup Themes (or Xthemes) are downloaded and installed like other addons.

See Addons for general addon installation instructions.

Activating Themes

When a shop is first set up, visitors will see the following notice until a theme for the shop has been activated.

_images/no-theme-selected.png

To active a theme, go to the Shuup Admin and click Themes under the Storefront category from the Shuup Admin menu.

_images/themes-menu.png

From here, themes can be activated or configured.

_images/activate-theme.png

Clicking Activate will activate the theme, and by clicking Configure, you can configure any custom theme settings.

Editing a Page

To edit a page:

  1. Log in as an administrative user.

  2. Navigate to the page on the shop front you want to edit.

  3. Click the Edit Page button in the lower right hand core to enter edit mode.

    _images/edit-page-button.png
  4. Once in edit mode, placeholders will appear as blocks surrounded by dotted outlines.

    _images/edit-mode.png
  5. When finished editing, click the Exit Edit button to return to normal mode.

    _images/exit-edit-button.png

Placeholders

Placeholders define the regions that a plugin may be included on a page. The theme source code defines where in the shop’s pages placeholders will appear.

To edit placeholders, enter edit more and click the placeholder you wish to edit.

See Editing a Page for more information.

Note

Changes to regular placeholders only affect a single page or view.

However, if a placeholder is a global placeholder, any changes will be reflected site-wide. Typically, these are used in areas such as headers or footers.

Refer to your theme documentation regarding which placeholders are global placeholders.

Plugins

Shuup Xtheme plugins provide an easy way for merchants to customize their shop frontend.

Shuup comes with a selection of default plugins, or plugins may be provided by themes or addons.

Adding Plugins

To add a plugin:

  1. Enter edit mode and click the placeholder to which you want to add plugins.

  2. Click Add new row button to add a new row of cells, or to add a column to an existing row click the new cell button add a column cell.

    _images/add-new-row-button.png _images/add-new-row-button.png
  3. Blank plugin cells will be labelled as None and existing cells will be labelled with their plugin type. Select the None cell to configure the plugin settings.

    _images/blank-plugin.png
  1. Select a plugin from the Plugin dropdown and enter any required plugin settings.

    _images/plugin-dropdown.png
  2. Click the Save Plugin button at the bottom of the Xtheme edit window to save the plugin settings.

    _images/save-plugin-button.png

    Note

    While in edit mode, placeholder changes will be visible. However, they will not be visible outside edit mode until they have been published.

  3. Click the Publish Changes button at the top of the Xtheme edit window to save the placeholder settings.

    _images/publish-changes-button.png

Payment and Shipping

In Shuup, payment and shippings choices are associated with particular service providers. These may be provided by Shuup’s build-in carriers or payment process, or may be provided by payment or shipping-related addons.

Service Providers

Creating a Payment/Service Provider

  1. Navigate to the Service Providers admin page by clicking Service Providers under the Settings category from the Shuup Admin menu.

    _images/service-providers-menu.png
  2. Click the New service provider button in the Service Providers admin toolbar

    _images/new-service-provider-button.png
  3. Select the provider type from the dropdown.

    _images/new-service-provider.png

    Note

    Some classes of providers may require extra fields. If so, these should appear when you select the provider from the dropdown.

  4. Enter the name, logo, enabled status, and any additional fields.

    _images/new-carrier.png
  5. Click Save to create the service provider.

  6. Once saved, click Create payment method or Create shipping method to create a payment or shipping method associated with this payment provider.

    See Creating a Payment Method and Creating a Shipping Method.

    _images/create-payment-method.png

Payment Methods

Creating a Payment Method

  1. Navigate to the Payment Method admin by clicking Payment Methods under the Settings category from the Shuup Admin menu.

    _images/payment-methods-menu.png
  2. Click the New payment method button in the Payment Methods admin toolbar.

    _images/new-payment-method-button.png
  3. Select a payment provider from the payment processor dropdown as well as a payment service from the service dropdown.

    _images/select-payment-method-provider.png
  4. Enter the remaining information for the method.

    _images/new-payment-method.png
  5. Click Save to create the payment method.

Shipping Methods

Creating a Shipping Method

  1. Navigate to the Shipping Method admin by clicking Shipping Methods under the Settings category from the Shuup Admin menu.

    _images/shipping-methods-menu.png
  2. Click the New shipping method button in the Shipping Methods admin toolbar.

    _images/new-shipping-method-button.png
  3. Select a shipping provider from the carrier dropdown as well as a shipping service from the service dropdown

    _images/select-shipping-method-provider.png
  4. Enter the remaining information for the method.

    _images/new-shipping-method.png
  5. Click Save to create the shipping method.

Behavior Components

When a customer checks out, they are presented the choice of any available payment methods for their order.

Whether a particular payment method is applicable to an order depends on its behavior, which is comprised of any number of behavior components.

Behavior components are essentially just individual components that, when taken together, define.

  1. Whether a payment method is available for an order
  2. The amount to charge for that payment method, if available

Shuup also ships with the following basic components (although behavior components can also be added by Addons):

Fixed cost
Add a fixed cost.
Waiving cost
Add a cost that is only applied up to a price limit.
Weight limits
Limit availability of the service based on total weight of products.
Weight-based pricing range
Add a cost to the order if it is within a specific weight range

Note

If there are multiple valid weight-based pricing ranges for an order, the cheapest-option will be selected.

Adding a Behavior Component to a Method

  1. Navigate to the Shipping or Payment Methods admin by clicking Shipping Methods or Payment Methods under the Settings category from the Shuup Admin menu.

    _images/payment-methods-menu.png
  2. Select the shipping or payment method to which you want to add behavior components.

    _images/select-payment-method.png
  3. Click the Behavior tab on the left-hand side of the screen.

    _images/behavior-tab.png
  4. Select behavior component type from the Behavior component type dropdown and press the Add component button to add a blank form for the selected behavior component.

    _images/add-component.png
  5. Enter the behavior component settings, repeat as necessary to add more behavior components.

  6. Click Save to save the behavior components for the selected method.

Domains

Feature coming soon!

Tax Settings

Taxes

Creating a New Tax

To create a new tax:

  1. Navigate to the Taxes admin page by clicking Taxes under the Settings category from the Shuup Admin menu.

    _images/taxes-menu.png
  2. Click the New tax button in the Taxes admin toolbar.

    _images/new-tax-button.png
  3. Enter values for new tax, including a tax rate as a percentage (i.e., for a tax rate of 7.5%, enter 7.5 as the tax rate value).

    _images/new-tax.png
  4. Click Save to save the new tax.

Tax Rules

Creating a New Tax Rule

  1. Navigate to the Taxes admin page by clicking Tax Rules under the Settings category from the Shuup Admin menu.

    _images/tax-rules-menu.png
  2. Click the New tax rule button in the Tax Rules admin toolbar.

    _images/new-tax-rule-button.png
  3. Enter the criteria for the new tax rule.

    _images/new-tax-rule.png
  4. Click Save to save the new tax rule.

Customer Tax Groups

Creating a New Customer Tax Group

  1. Navigate to the Taxes admin page by clicking Customer Tax Groups under the Settings category from the Shuup Admin menu.

    _images/customer-tax-groups-menu.png
  2. Click the New customer tax group button in the Tax Groups admin toolbar.

    _images/new-customer-tax-group-button.png
  3. Enter a name for the new tax group.

    _images/new-customer-tax-group.png
  4. Click Save to save the new customer tax group.

Tax Classes

Creating a New Tax Class

  1. Navigate to the Tax Classes admin page by clicking Tax Classes under the Settings category from the Shuup Admin menu.

    _images/tax-classes-menu.png
  2. Click the New tax class button in the Tax Classes admin toolbar.

    _images/new-tax-class-button.png
  3. Enter information for the new tax class.

    _images/new-tax-class.png
  4. Click Save to save the new customer tax class.

Display Settings

Shop Settings

Note

Tax display settings can only be configured for a shop if there are no orders in the system.

Once an order has been placed, you will no longer be able to change the tax display settings.

  1. Navigate to the Shops admin page by clicking Shops under the Storefront category from the Shuup Admin menu.

    _images/shops-menu.png
  2. Select the shop whose tax display settings you would like to modify.

    _images/select-shop.png
  3. Check or uncheck the Prices include tax field to enable or disable tax display for shop.

    _images/prices-include-tax.png
  4. Click Save to save the shop settings.

Contact Group Settings

  1. Navigate to the Contact Groups admin page by clicking Contact Groups under the Contacts category from the Shuup Admin menu.

    _images/contact-groups-menu1.png
  2. Select the contact group whose tax display settings you want to configure.

    _images/select-contact-group1.png
  3. Set the price-display mode for the contact group.

    _images/contact-group-price-display-mode.png
  4. Click Save to save the price-display settings for that contact group.

Orders

Creating an Order

Orders can be made in one of two ways–by a customer through the shop front or by a merchant through the Shuup Admin.

To create an order through the Shuup Admin:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Click the New order button on the Order admin toolbar

    _images/new-order.png
  3. Under the Customer details section, click Select Existing Customer to launch the customer selection popup, or leave choice as New Customer to create a new customer along with the order.

    _images/customer-details.png

    Enter any required or missing address information.

  4. Under the Order contents section, click Add new line to add blank order lines to the order.

    These can either be of type product, other, or text/comment.

    If adding a product, clicking Select product will launch the product browser window.

    _images/add-new-line.png

    Here are the types of lines you can create in an order:

    Product line

    A product, quantity, and any pricing or discount information

    Other line

    A miscellaneous priced line

    Text/Comment line

    A non-priced text line

  5. Optionally, the Quick add product line form can be used to quickly add product lines to the order. For example, this can be used when adding products using a barcode scanning device.

    To quick add products:

    1. Enter a product name, sku, or barcode number and select desired product from the dropdown results.

    2. Press the plus button to add the product line to order, or press the trash button to clear the input and select a new product.

      _images/quick-add.png
  6. Select shipping and payment methods for the order from the Shipping and Payment Methods dropdowns.

    _images/shipping-and-payment-methods.png
  7. Click the Proceed button to create the order.

    _images/proceed-button.png

Note

You must select shipping and payment methods for each order.

Note

Method rules, taxes and possible extra discounts are calculated after proceeding.

Editing an Order

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order that you wish to edit.

    _images/select-order.png
  3. Click Edit Order in the order toolbar.

    _images/edit-order-button.png
  4. Make any desired changes to the order contents as done when Creating an Order.

    _images/edit-order-contents.png
  1. Click the Proceed button to save the order contents.

    _images/proceed-button.png

Order Shipments

Creating an Order Shipment

To create an order shipment:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order for which you want to create a shipment.

    _images/select-order.png
  3. Click Create Shipment in the order toolbar.

    _images/create-shipment-dropdown.png
  4. For each product, select the quantity of that product to include in the shipment. To easily select all remaining unshipped quantities, click Set All Products To Ship.

    _images/create-shipment.png
  5. Select a product supplier from the dropbown menu.

    _images/supplier.png
  6. Click the Create Shipment button to create the shipment.

Printing a Delivery Slip

To print a delivery slip for an order shipment:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order whose delivery slip you want to print

    _images/select-order.png
  3. If you haven’t already done so, create an order shipment.

    See Creating an Order Shipment

  4. Click Print in the Orders admin toolbar

    _images/print-button.png
  5. Select Get Delivery Slip for the order shipment you would like to print (there will be one available for each shipment).

    _images/get-delivery-slip.png
  6. You will now be taken to a PDF of the delivery slip, which you can either print or save to your computer from your browser menu

    _images/delivery-slip.png

Order Payments

Viewing Order Payments

To view all payments for an order:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order whose payments you want to view

    _images/select-order.png
  3. Click the Payments tab on the left-hand side of the screen

    _images/payments-tab.png
  4. Details will be listed for all payments associated with that order

    _images/payments.png

Creating an Order Payment

To create an order payment:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order for which you want to create a payment

    _images/select-order.png
  3. Click Create Payment in the order toolbar.

    _images/create-payment-dropdown.png
  4. Enter the amount of the payment in the Payment amount field or click Get Remaining Total to automatically fill will remaining unpaid total.

    _images/create-payment.png
  1. Click the Create Payment button to create the payment.

Order Refunds

Note

Orders can only be refunded once at least one payment has been created for the order.

However, refund amounts are not restricted by existing payment amounts, meaning it is possible to refund more than has been actually payed.

If an order cannot be refunded, it will not be visible in the Actions dropdown menu.

Note

Once a refund has been created, it will appear as a refund line in the Order Contents tab.

To create a partial refund for a particular amount or to refund particular order line amounts:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order for which you want to create a refund.

    _images/select-order.png
  3. Click Create Refund in the Actions dropdown in the admin page’s toolbar.

    _images/create-refund-dropdown.png
  4. To create a refund for a particular line, select the matching line number from the Line number dropdown field.

    _images/refund-line-form.png

    When refunding a product line, a field will appear to enter the quantity, as well as whether to restock the refunded products.

    Note

    A separate refund line will be created if returning both a quanity and an amount for a particular line.

  5. Click the Add More Refunds button to add additional refund forms.

    _images/add-more-refunds-button.png
  6. Click the Create Refund to add the entered refund amounts to the order.

To create a full refund for an order:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order for which you want to create a refund.

    _images/select-order.png
  3. Click Create Refund in the Actions dropdown in the admin page’s toolbar.

    _images/create-refund-dropdown.png
  4. Click the Refund Entire Order button in the admin page’s toolbar.

    _images/refund-entire-order-button.png
  5. Review the order and refund amount information. To restock returned products, make sure the Restock products checkbox is selected.

  6. Click the Confirm Refund to create a refund in the full amount.

Canceling an Order

Note

Only unpaid and unshipped orders can be canceled.

If an order has been fully paid or fully shipped, the Cancel Order button will be disabled and you will not be able to cancel the order.

To cancel an order:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order that you want to cancel

    _images/select-order.png
  3. Click Cancel Order in the order toolbar

    _images/cancel-order-button.png

The order will now be marked as canceled in the Orders admin list.

Completing an Order

Once an order has been shipping, it can be marked as completed.

To set an order as complete:

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order you want to set complete

    _images/select-order.png
  3. Click Set Complete in the order toolbar

    _images/set-complete-button.png

The order will now be marked as completed.

Note

If the order cannot be completed (not all items have been shipped), the Set Complete button will be disabled and you will not be able to complete the order.

Printing an Order Confirmation

  1. Navigate to the Orders admin page by clicking Orders under the Orders category from the Shuup Admin menu.

    _images/orders-menu.png
  2. Select the order whose confirmation you want to print

    _images/select-order.png
  3. Click Print in the order toolbar

    _images/print-button.png
  4. Select Get Order Confirmation from the dropdown menu

    _images/get-order-confirmation.png
  5. You will now be taken to a PDF of the order confirmation, which you can either print or save to your computer from your browser menu

    _images/order-confirmation.png

Campaigns

Shuup Ecommerce platform comes built in with customized and easily extendable campaign management system. Shuup’s modular campaign management structure allows extending the feature to most innovative campaign models and even integrations.

Campaign Types

Shuup has two different types of campaigns:

Basket Campaign
A campaign that is offered or fulfilled in Shuup shopping basket. For example, a customer may be given a 5% discount off their total order if their basket contains at least 10 products.
Catalog Campaign
A campaign that is offered shop-wide based on the customer, product, product type, or other such conditions.

Creating a Campaign

  1. Navigate to either the Basket Campaigns or Catalog Campaigns admin page by clicking Basket Campaigns or Catalog Campaigns under the Campaigns category from the Shuup Admin menu.
_images/basket-campaigns-menu.png
  1. Click either the Create a new Basket Campaign or Create a new Catalog Campaign button in the admin page toolbar.
_images/create-new-basket-campaign-button.png
  1. Enter general information regarding the campaign, such as the name, public name, basket line text, start/end dates, and any coupons to be associated with the campaign.

    _images/campaign-general-information.png
    Field Use Mandatory
    Name Name of the campaign (not visible on the shop front-end) Yes
    Public name Public name of the campaign to be presented in the shop front-end, when the campaign name is displayed Yes
    Shop Shop selector for multi-shop setup. Shop where the campaign is active Yes
    Start date and time Setting start date for the campaign using datepicker No
    End date and time Setting end date for the campaign using datepicker No

    Note

    If no start date is provided, it will take effect immediately.

    If no campaign end date is provided, the campaign will stay in effect indefinitely.

  2. Click Save to create the campaign. Once a campaign has been saved, rules and effects can be added to define its behavior.

Tip

Try setting up a cross-selling basket campaign by offering a discount on one product when a customer purchases a related product.

Tip

Try setting up a simple catalog campaign with a 5% discount for a particular product.

Rules and Effects

Whether or not a campaign be applied to a particular order and how it will be applied depends on its Rules and Effects.

Rules
The conditions or criteria that an order must meet before a campaign will be applied. These may include having a basket with a certain total value (for a basket campaign) or requiring the customer to belong to a specific customer group (for a catalog campaign). Different rules will be available depending on whether they are being applied to a basket campaign or a catalog campaign.
Effects
If a customer’s order meets the requirements of all of the campaign’s rules, any enabled effects will be applied to their order. These are usually discounts applied to the order, such as discounts on the total basket value, discounted or free quantities of a particular product, or other various types of discounts.
Coupons
Used to limit usage of a basket campaign to only holders of a valid coupon code.

Adding Rules and Effects

Once a campaign has been created, Rules and Effects can be added from the campaign’s admin page.

To add rules and effects:

  1. Click either the Rules or Effects tab on the left hand side of the screen.

    _images/rules-tab.png
  2. Select the rule or effect type from the dropdown menu and click either the Add rule or Add effect button below to add a new rule or effect form.

    _images/add-rule-button.png
  3. Enter any required values in the rule or effect form, and click Save to attach the rules or effects to the campaign.

    _images/rule-form.png

Basket Rules

The following rules are available to basket campaigns:

Basket product count
Limit to baskets containing at least the specific number of products
Basket maximum product count
Limit to baskets containing at most the specific number of products
Basket total value
Limit to baskets containing at least the specified total amount
Basket maximum total value
Limit to baskets containing at most the specified total amount
Products in basket

Limit to baskets containing a certain quantity of the selected product(s)

Note

This rule applies if a basket contains any of the selected products (i.e., a certain number of product A or a certain number of product B).

In order to require product A and product B, create a separate rule for product A and product B.

Contact Group
Limit to customers belonging to a specific contact group
Contact
Limit to selected customer contacts

Catalog Rules

Contact
Limit to seleclted customer contacts
Contact Group
Limit to customers belonging to a specific contact group
Product
Limit to a specific product
Product Category
Limit to products belonging to a specific category
Product Type
Limit to products of a specific type

Basket Effects

Campaign Effects

Creating a Coupon Code

  1. Navigate to the Coupons admin page by clicking Coupons under the Campaigns category from the Shuup Admin menu.
_images/coupons-menu.png
  1. Click Create new Coupon button in the admin page toolbar.
_images/create-new-coupon-button.png
  1. Either type the desired coupon code you want your customers to enter, or click the Generate button to randomly generate a coupon code.
_images/generate-coupon-button.png
  1. Enter general information regarding the coupon, such as the usage limit per customer and the over usage limit (or total number of redeemable coupon codes).
_images/coupon-general-information.png

Tip

As coupon codes are redeemed through the store, the total number of used coupon codes will be visible through the coupon’s admin page.

Stock Management

Shuup comes with built in stock management system. The stock management isn’t activated in shop admin by default, but the activation can be done by merchant in a few easy steps. The Stock management setup process is guided process in the Shuup shop admin.

Since all products aren’t always stocked (like downloadable products) a good thing to keep in mind is, that to be able to manage product stock, a product must be first set as Stocked. Also to have a stock, it’s required to have at least one Supplier. Stock can be easily managed in Shuup shop admin through any of the Stocked products, or in dedicated Products / Stock management view.

Activating Stock management

Set supplier stock managed:

  1. Login into Shuup shop admin at https://youshopurl.com/sa
  2. Open up the menu bar on top left hand side
  3. Select Products / Suppliers and open up Simple supplier-module from Suppliers -table
  4. Check on Stock Managed and Save

Tip

Shuup is prepared to use several supplier modules and each of them can have their own stock

Set product as stocked

Next, let Shuup know, which of your products are actually stocked. Decide which products stock you want to manage. Find these product in Products / Products

Open up the product you want to manage and check that the product has it’s stock managed at Additional details. Set the option stock as Stocked.

Tip

This will activate Stock Management for the product. From now on the stock of this particular product can be managed in Stock management

Managing stock

Managing stock in Shuup is simply clean. Stock managing is available through each specific product at Products or at it’s own Stock management-views in shop admin.

Whether the merchant needs to manage only one product, or several product stocks at a time, in both of the use case variations the stock management behaviour is the same. The only difference is, that in Stock Management view a merchant may easily view all the products at one glimpse and manage their stocks. In product settings view the stock is managed only for one particular product.

This way the stock management is easy whether merchant is browsing for a single product and has a sudden need to manage it’s stock, or adding various products to the stock at once.

Tip

When adding stock, it’s good to notice, that merchant should always include information of product purchase price in shop currency, and the quantity to add to the stocks. These will affect in stock reports.

How to manage stock on a product

  1. Decide which products stock you want to manage, find the product in Products
  2. Open up the product and scroll down for Stock management tab

Tip

Before trying to manage stock on a product make sure, that the Supplier and product has stock setting set as Stocked

Add stock: Input your product purchase price and quantity and select Add stock Remove stock: Input a negative value of how many products you want to remove, input product purchase price and quantity and select Remove stock

Tip

Your stock physical count, logical count, value per unit and total value is automatically updated after each time you add or remove stock

How to manage stocks in general

  1. Navigate to Stock Management in shop admin, through the menu Products / Stock management
  2. Locate the product you want to manage the stock for

Tip

Before trying to manage stock on a product make sure, that the Supplier and product has stock setting set as Stocked

Add stock: Input your product purchase price and quantity and select Add stock Remove stock: Input a negative value of how many products you want to remove, input product purchase price and quantity and select Remove stock

Tip

Your stock physical count, logical count, value per unit and total value is automatically updated after each time you add or remove stock

Customers and Users

Users

Creating a User

  1. Navigate to the Users admin page by clicking Users under the Settings category from the Shuup Admin menu.

    _images/users-menu.png
  2. Click the New User button on the Users admin toolbar.

    _images/new-user-button.png
  3. Enter a valid username and password for the user as well as any other user information, then click the Save button in the to create the user account.

    _images/new-user.png

Note

A user won’t automatically receive notice that an account has been created for them.

Instead, if you would like to notify a user, send a password-reset email.

See Sending Password-Reset Emails.

Creating a User From a Saved Contact

  1. Navigate to the Contacts admin page by clicking Contacts under the Contacts category from the Shuup Admin menu.

    _images/contacts-menu.png
  2. Select the contact for which you want to create a user account.

    _images/select-contact.png
  3. Click the New User button on the Contact admin toolbar.

    _images/new-user-from-contact.png
  4. Enter the new user’s username and password information and click Save to create the user account, which will now be associated with the selected contact information.

    _images/new-user.png

    See Creating a User for more information.

Managing User Passwords

Changing User Passwords
  1. Navigate to the Users admin page by clicking Users under the Settings category from the Shuup Admin menu

    _images/users-menu.png
  2. Select the user whose password you want to change.

    _images/select-user.png
  3. Click the Actions button on the user admin toolbar, and select Change Password from the dropdown menu.

    _images/change-password.png
  4. Enter the new password in the Change User Password form and click Save in the toolbar to save the new password.

    _images/change-password-form.png
Sending Password-Reset Emails
  1. Navigate to the Users admin page by clicking Users under the Settings category from the Shuup Admin menu.

    _images/users-menu.png
  2. Select the user whose password you want to change.

    _images/select-user.png
  3. Click the Actions button on the user admin toolbar, and select Send Password Reset Email from the dropdown menu.

    _images/send-password-reset-email.png
  4. On the next screen, click Send Reset Email to send the user a password reset email.

    _images/send-reset-email.png

Editing User Permissions

Warning

Use caution when granting users administrative permissions.

  1. Navigate to the Users admin page by clicking Users under the Settings category from the Shuup Admin menu.

    _images/users-menu.png
  2. Select the user whose permissions you want to edit.

    _images/select-user.png
  3. Click the Actions button on the user admin toolbar, and select Edit Permissions from the dropdown menu.

    _images/edit-permissions.png
  4. Check the permission levels that want to grant the user and click the Save button to save the user’s permissions.

    _images/change-permissions.png

Deactivating a User

When users are deactivated, they remain in your system however they will no longer be able to log in to their account and by default are not displayed when first opening the Users admin page.

Note

If a user has an associated contact, deactiving the user’s user account will not deactive their contact, although it will prevent them from logging in, essentially accomplishing the same thing.

See Deactivating a Contact for more information.

To deactivate a user:

  1. Navigate to the Users admin page by clicking Users under the Settings category from the Shuup Admin menu.

    _images/users-menu.png
  2. Select the user you want to deactivate.

    _images/select-user.png
  3. Click the Deactivate User button on the user admin toolbar.

    _images/deactivate-user-button.png
  4. The user will now be deactivated, and the Deactivate User button will be replaced with an Activate User button.

Note

The same steps can be followed to activate a deactivated user.

Logging in as a User

When troubleshooting a problem for a customer, it may be useful to log in under the user’s account.

To log in as a user:

  1. When logged in as a superuser, navigate to the Users admin page by clicking Users under the Settings category from the Shuup Admin menu.

    _images/users-menu.png
  2. Select the user you want to log in as.

    _images/select-user.png
  3. Click the Login as User button on the user admin toolbar.

    _images/login-as-user-button.png
  4. You will now be logged in as the user.

Note

If a superuser places an order as another user, the superuser will be listed as the creator on the orders details page.

Permission Groups

Permission groups can be used to restrict access to different sections of the Shuup admin for staff-level users.

  1. Navigate to the Permission Groups admin page by clicking Permission Groups under the Contacts category from the Shuup Admin menu.

    _images/permission-groups-menu.png
  2. Click the New group button on the Permission Group admin toolbar.

    _images/new-group-button.png
  3. Enter a name for the group, select any modules (or admin sections) the group should have access to, and select any users that should be members of this group.

    _images/permission-groups-form.png

    Note

    Permissions are managed on a module-level basis. For example, if a user has access to the Orders module, they will have access to create orders, shipments, payments, refunds.

    Additionally, if two admin modules require the same permission rights, adding one module will automatically add the second once the group settings have been saved.

  4. Click Save to save the permission group settings.

Contacts

Shuup contacts store contact information such as address data, email, or phone numbers, and a contact may or may not be associated with a user account.

Contacts may be one of the two following types:

Person contact
Contact associated with a person.
Company contact
Contact associated with a company.

One or more person contacts may be members of a company contact.

However, if a user has a contact associated with their account, it must always be a person-type contact, which may then be a member of one or more company contacts.

If a user’s person contact is linked to a company, the company’s contact information will be used when placing orders.

Creating a Contact

  1. Navigate to the Contacts admin page by clicking Contacts under the Contacts category from the Shuup Admin menu.

    _images/contacts-menu.png
  2. Click the New contact button on the Contacts admin toolbar.

    _images/new-contact-button.png
  3. Enter all basic details for the contact, including any required fields.

    _images/contact-basic-details.png

    Note

    If adding a contact of type Person, the Name field is required but unused. Instead, you will want to enter a temporary value into the name field and (optionally) provide the contact’s first name last name.

    If adding a contact of type Company, the Name field is required and will be used as the company name. In this case, the first and last names will not be used.

  4. Click the Addresses tabs on the left-hand side of the screen to enter billing and shipping address information for the contact.

    _images/contact-addresses.png
  5. Click the Save button to create the contact.

Editing a Contact

  1. Navigate to the Contacts admin page by clicking Contacts under the Contacts category from the Shuup Admin menu.

    _images/contacts-menu.png
  2. Select the contact that you want to edit.

    _images/select-contact.png
  3. Click the Edit button in the contact admin toolbar.

    _images/edit-contact.png
  1. Edit the user’s information and click Save to save the contact’s information.

    See Creating a Contact for more information.

Editing Company Membership

  1. Navigate to the Contacts admin page by clicking Contacts under the Contacts category from the Shuup Admin menu.

    _images/contacts-menu.png
  2. Select the company contact whose membership you want to edit.

    _images/select-company.png
  3. Click the Edit button in the contact admin toolbar.

    _images/edit-contact.png
  4. Under the Members field input, type the name of the person contact you wish to add to the company. When the name appears in the dropdown, click to add to the input field.

    _images/company-membership.png
  5. Click save to update the company’s memberships.

Creating a Contact From a User Account

  1. Navigate to the Users admin page by clicking Users under the Settings category from the Shuup Admin menu.

    _images/users-menu.png
  2. Select the user whose permissions you want to edit.

    _images/select-user.png
  3. Click the Actions button on the user admin toolbar, and select Create Contact from the dropdown menu.

    _images/new-contact-from-user.png
  4. Fill in the user’s contact information, including any required fields, then save to create a saved contact for the user.

    _images/contact-basic-details.png

    See Creating a Contact for more information.

  5. The contact will now be created and you will be taken to the new contact’s admin page.

    Click the user’s username to go back to the user’s admin page.

Deactivating a Contact

When contacts are deactivated, they remain in your system however they will no longer be able to log in to their account and by default are not displayed when first opening the Contacts admin page.

Note

If a contact has an associated user, deactiving the user’s contact will not deactive their user account, although it will prevent them from logging in, essentially accomplishing the same thing.

See Deactivating a User for more information.

To deactivate a contact:

  1. Navigate to the Contacts admin page by clicking Contacts under the Contacts category from the Shuup Admin menu.

    _images/contacts-menu.png
  2. Select the contact you want to deactivate.

    _images/select-contact.png
  3. Click the Deactivate Contact button on the contact admin toolbar.

    _images/deactivate-contact-button.png
  4. The contact will now be deactivated, and the Deactivate Contact button will be replaced with an Activate Contact button.

Note

The same steps can be followed to activate a deactivated contact.

Contact Groups

In Shuup, contacts can be placed into different contact groups. These groups can then be targetted for campaigns, discount pricing, or custom behaviors.

Creating a Contact Group

  1. Navigate to the Contact Groups admin page by clicking Contact Groups under the Contacts category from the Shuup Admin menu.

    _images/contacts-menu.png
  2. Click the Create new button in the Contact Groups toolbar.

    _images/new-contact-group-button.png
  3. Select a name and price-display mode for your contact group.

    _images/contact-group-information.png
  4. Click the Save button to save your contact group

    Once the contact group has been saved, two new tabs will be automatically added to the group’s admin page–a Members tab and one or more Sales Range tabs.

Editing Group Membership

View Contact Group Membership
Adding a Contact
  1. Navigate to the Contact Groups admin page by clicking Contact Groups under the Contacts category from the Shuup Admin menu.

    _images/contact-groups-menu.png
  2. Select the contact group whose membership you want to edit.

    _images/select-contact-group.png
  3. Click the Add Members tab on the left-hand side of the screen.

    _images/add-members-tab.png
  4. Click the Select button on an empty row to launch the Contact selector popup.

    _images/add-members-select-button.png
  5. Select the contact you want to add from the Contact popup selector.

    _images/select-member.png
  1. If there are no blank contact rows, click the Add more button to add a blank contact row.

    _images/add-more-button.png
  2. Repeat as necessary to add more contacts, then click Save to save the contact group.

Removing a Contact

Note

Contacts can only be removed from a contact group via the admin page for each contact you wish to remove.

  1. Navigate to the Contacts admin page by clicking Contacts under the Contacts category from the Shuup Admin menu.

    _images/contacts-menu.png
  2. Select the contact that you want to remove from your group.

    _images/select-contact.png
  3. Click the Edit button in the contact admin toolbar.

    _images/edit-contact-group-from-contact.png
  4. Find the contact group whose membership you wish to edit in the Contact Groups list, uncheck the corresponding box, and click Save to update the contact’s group membership.

Creating a Sales Range

Contact group sales ranges can be used to automatically assign customer contacts to contact groups based on their sales totals.

This can be useful if you want to target different sales levels for special campaigns, or offer special discounts or promotions.

  1. Navigate to the Contact Groups admin page by clicking Contact Groups under the Contacts category from the Shuup Admin menu.

    _images/contact-groups-menu.png
  2. Select the contact group to which you want to add a sales range.

    _images/select-contact-group.png
  3. Click the (Shop Name) - Sales Ranges tab on the left-hand side of the screen, where (Shop Name) is the name of the shop to associate with the sales range.

    _images/sales-ranges-tab.png
  4. Enter a minimum and maximum value for the group’s sales range.

    _images/sales-ranges-values.png

    Note

    Leave the maximum value blank to set no maximum for the group.

    Set the minimum value to 0 to set no minimum for the group.

  5. Click Save to save the contact group sales range. Contact group membership will automatically update based on customers’ sales totals.

Tip

Try creating a contact group for customers within a sales range value and target them for special discounts and promotions.

Reports and Analytics

Feature coming soon!

Addons

Installing Addons

Note

Uploading addons is currently disabled in the Cloud version of Shuup.

Addons are installed through the Addons admin. To navigate to the Addons admin, select Addons from the Shuup Admin menu.

_images/addons-menu.png

Any installed addons will be listed on this page.

To upload an addon, click Upload new addon on the Addon toolbar.

Note

Addons must be uploaded in .zip format

Next, upload the addon by selecting the .zip file with your file selector and clicking the Upload button.

_images/select-file.png

Once the file has been uploaded, you will be able to view any package information as well as a list of the uploaded file contents.

Next, click Install Addon to install the addon. This will take you to a page stating whether or not the installation was successful, and if it was unsuccessful it will display more information about the error.

Tip

When troubleshooting installation issues, it helps to copy and paste the error/traceback information.

You should be taken back to the Addon admin page, and unless there were problems uploading your file it should be included in the list of installed addons. However, it will not yet be enabled.

Enabling Addons

After an addon has been installed, it must be enabled. To enable an installed addon, check the Is enabled column next to the addon name and click Save addon changes on the Addons toolbar.

_images/enable-addon.png

If changes were made to the list of enabled/disabled addons, the server must be reloaded and a Reload application button will appear on the Addons admin toolbar.

Warning

When you reload the application server, it may take some time for the new instance of your application to properly initialize.

In addition, there is always a chance for the server to not properly initialize at all, in which case you may need to troubleshoot the problem yourself (or have a system administrator handy).

Clicking this button will take you to the Reload Application Server page, where the server can be reloaded by pressing the Reload Application Server button.

Indices and tables