Setting up a shop in PlentyONE

shop demoshop
Figure 1. The new PlentyONE shop

The PlentyONE shop is the out-of-the-box solution for anyone who wants to sell their products via their own webshop. The shop is the successor to plentyShop LTS and, as a so-called PWA - Progressive Web App - offers outstanding performance with fast loading times. The shop can be set up in just a few steps.

The new PlentyONE shop is based on the Alokai framework and offers headless commerce with seamless integration with the rest of the PlentyONE back end.

This guide will help you to create your first shop or - if you are already running an plentyShop LTS - to switch from LTS to the new shop.

1. Additional information

Before you get started setting up your shop, we would like to draw your attention to a few important pages.

1.1. Developer documentation

This guide you are reading is primarily targeted at users without programming experience. Our developer documentation provides a deeper insight into the technical level of the shop and many tips for individual customisations at code level.

1.2. Showcase shop

You can view the current state of the shop in our showcase shop. This shop is updated with new features and designs with every release. If you do not make any customisations to the shop, your shop will be largely identical to the showcase shop.

2. Preliminary settings

In order to be able to use the shop, you must first carry out several settings in the PlentyONE back end. If you have already set up a plentyShop LTS, you will have already made many of these settings.

2.1. Relevant rights for back end users

In order to have full access to the shop, your user needs the following rights:

Users with roles that are not of the type Administrator can only see certain sections and menus in PlentyONE. This means they only have limited access to the system. If employees Edit shop settings and shop pages, they need at least the following rights:

  • CMS

  • Plugins

  • Setup » Assistants

  • PWA

Tip: How to grant rights

Note that only users with roles of the type Administrator can grant rights.

Assigning rights:

  1. Open the menu Setup » Account management » Roles.
    → The roles overview opens.

  2. Click on New (add).
    → The role creation menu opens.

  3. Enter a name for the role.

  4. Switch to the advanced mode by toggling Advanced (toggle_on) slider.

  5. Assign the rights for the respective section by ticking the check boxes indicated above.
    Note: You can either grant rights for complete sections or limit the rights you grant the user. To only grant limited rights in a certain section, expand the section.

  6. Save (save) the settings.

The simple mode and advanced mode are connected. If you check menu visibilities in the simple mode the corresponding permissions in the advanced mode will be checked automatically. The connection only exists in this direction. If you check permissions in the advanced mode no menu or plugin visibilities will be checked automatically.

2.2. Installing shop plugins

Preinstalled in new systems

If you use a new system, these plugins are preinstalled. Skip this section and continue with Carry out the shop journey.

Install these plugins to get your shop up and running. They add additional REST routes, payment methods as well as basic functionalities to your shop.

You need to install the following plugins:

Proceed as follows to install the plugins:

  1. Log into your PlentyONE system.

  2. Install the plugins mentioned before.

  3. Set the priorities of the plugins, so that IO has the highest priority and plentyShop LTS the second highest. The priority of all other plugins remains 0.

Optionally you can install additional plugins to extend the payment methods and shipping providers of your shop:

Payment methods:

Shipping service provider:

2.3. Carry out the shop journey

If you’ve never set up a plentyShop LTS, you should first go through the guided setup for a shop in the back end. Proceed as described below. Note that the initial setup of the shop and the associated menu items may take some time.

If you have already set up a plentyShop LTS for your client, you can skip this step.

Carrying out the shop journey:

  1. Go to Setup » Guided Setup.

  2. Expand the Setting up Shop section.

  3. Go through the guided setup steps contained therein.

  4. Each completed setup point is marked with a green checkmark.

2.4. Set up bot protection

In the next step, you set up the Cloudflare Turnstile bot protection.

Bot protection guards your shop against automated spamming activities, such as flooding contact forms with unwanted and irrelevant messages, and ensures an optimised and efficient communication process for real users.

By using bot protection, you can improve the overall user experience, maintain data integrity, and reduce the risk of fraudulent or malicious activity that can compromise the security and functionality of your shop. To set up Cloudflare Turnstile, you need to make settings in both Cloudflare and the PlentyONE back end.

Proceed as follows to set up Cloudflare Turnstile for your shop:

Setting up Cloudflare Turnstile:

  1. Create a Cloudflare Acount.

  2. Click Turnstile in the Cloudflare dashboard.

  3. Click Add widget in the overview window.

  4. Enter a name for the widget.

  5. Click below on Add host name.

  6. Enter a your domain without „https://“ and without trailing slash or parameters in the Add custom host name field.

  7. Then, click Add next to the field.
    → The selected domain will be displayed under Selected host names.

  8. Click Add at the bottom.
    → You will be redirected to the Add widget menu, where your domain is now listed under host name.

  9. Select the type of bot protection under widget mode.

  10. Click Create.
    → The notification Turnstile widgets successfully created is displayed.
    → Your Secret Key and Site Key are displayed.

Consult the Cloudlflare documentation for additional information about the setup of Cloudflare Turnstile.

Setting up Cloudflare in PlentyONE:

  1. Go to Setup » Shop » [Select client] » Online Store Settings.

  2. Enter the Cloudflare Site Key in the Cloudflare Turnstile Site Key (only PWA).

  3. Enter the Cloudflare Secret Key in the Cloudflare Turnstile Secret Key (only PWA).

  4. Save (save) the settings.

2.5. Activate languages

In the Localization (language) section of the shop editor you can activate languages for your shop and set a default language for your shop. All languages that PlentyONE supports are available to you: Bulgarian, Chinese, Czech, Danish, Dutch, English, French, German, Italian, Norwegian, Polish, Portuguese, Romanian, Russian, Slovak, Spanish, Swedish, Turkish, Vietnamese.

Setting the default language for your shop:

  1. Open the shop editor.

  2. Click language in the side navigation.
    → The Localization menu opens.

  3. Select a language from the Default language drop-down list.
    Tip: A language must be activated so you can select it as a default language.

  4. Click Save changes (save) to save the settings.

Once you have made the preliminary settings, you can create your shop.

3. Creating a shop

If you want to create a new PlentyONE shop, open the Shop » Shop Management menu.

If you haven’t created a shop yet, the shop management menu looks as follows:

shop create ui
Figure 2. Creating a new shop

Click Create your shop now.

Add more shops

If you want to add more shops, click Add shop (add) in the top left corner.

The Add shop window opens:

shop add app
Figure 3. Add shop

Enter the information as described in the table below.

Table 1. Displayed information
Setting Explanation

Shop name

Enter a shop name. The name will be displayed in the shop overview. The name will not be displayed on your shop page.

Select client

Select the client, you want to create the shop for.

Select shop source

Select between PlentyONE Shop and Git integration. If you select PlentyONE Shop, you create the shop in the default design of our templates. If you select Git integration, additional input fields are shown where you enter the URL and branch of the GitHub repository and Git token (scope: repo) to use your own GitHub integration as foundation for your shop.

Click Create.
The shop is created and will be listed in the list of shops afterwards:

shop overview ui
Figure 4. Add shop

Once the shop has been created, deploy it and activate preview mode as described in the following chapter.

4. Deploying the shop and activating preview mode

Requirements for deploying a shop

To deploy a PlentyONE shop, you need a valid SSL certificate.

When deploying the shop, different settings from the back end are gathered and prepared for your domain. The shop doesn’t go live by deploying alone.
Activating preview mode allows you to view the shop in preview mode for the next 12 hours.
Once you have deployed your shop and activated preview mode, you can edit your shop in the editor, carry out shop-specific settings and activate the shop in live mode to make it accessible to visitors.

Deploying the shop and activating preview mode:

  1. Click Deploy the shop and activate preview mode (play_circle) in the Actions column of the shop.
    → The window Start shop without live mode opens. This can take a few minutes.

  2. Click Confirm.
    → The shop is being deployed and will be available in preview mode for the next 12 hours.

As soon as the Status of the shop changes from Starting to Running, you can open your shop in preview mode. To do this, click Open editor in the Actions column of the shop. Your shop will open in a new browser tab.

Duration of the preview

When you activate preview mode for a shop, this shop can be accessed via the preview for 12 hours. After this period, the preview mode is deactivated again to save resources. Shops that are in live mode are never deactivated automatically.

5. Shop editor

Requirements for the shop editor

To use the shop editor and make your shop available online, you need a valid SSL certificate.

The preview mode is also a what you see is what you get editor. Here you can directly edit your shop pages.
After you opened the preview mode as described in chapter deploying the shop and activating preview mode you can switch between Preview (visibility) and Edit (edit) in the top right corner:

shop edit vs preview
Figure 5. Preview and edit mode
Which pages can be edited in the editor?

In the shop editor, pages of the types Content Pages, Product Category Pages, and Product Detail Pages can be edited.

You find further information how to edit your shop pages with the editor on the shop editor manual page.

6. Putting a shop into live mode

To make your shop accessible to visitors, you must activate it in live mode. To do this, proceed as described below.

plentyShop LTS and a shop cannot be activated at the same time

If you are using a live plentyShop LTS, it will be deactivated and no longer accessible as soon as you activate a new shop in live mode. To use plentyShop LTS again, deactivate the shop’s live mode.

Activating a shop in live mode:

  1. Click on the three-dot menu (more_vert) in the row of the shop in the Actions column.
    → The context menu opens.

  2. Click Activate live mode.
    → The Activate live mode for the shop window opens.

  3. Click Activate live mode.
    → Your shop goes live and can be accessed by visitors.

7. Carrying out shop settings

You can configure all settings for your PlentyONE shop directly in the shop editor. Changes are immediately visible in preview mode.

Language in the shop editor

The user interface of the shop editor is currently only available in English.


7.1. The shop editor’s toolbar

shop toolbar settings en
Figure 6. Toolbar with settings

Click on the icons in the toolbar (on the left) to open the shop settings.

Table 2. Settings sections of the shop editor
Icon Settings section

article

Pages: Page and category management

language

Localization: Language and translations

brush

Branding & Design: Design, colours & logos

category

Category: Category management and sorting

shopping_cart

Checkout: Checkout process & VAT verification

code

*Custom Code: * Upload your own CSS/JS snippets

settings

General Settings: Contact, performance & security

sell

Item Settings: Item settings

search_insights

SEO: Search engine optimisation

7.2. Carrying out settings in the editor

Carrying out shop settings:

  1. Go to Shop » Shop Management.

  2. Click on design_services Open Editor in the line of the shop you want to edit.
    Important: You can only open the editor and edit the shop if the shop is active and has the status Running. To activate the shop, click play_circle Activate preview mode in the shop line.
    → The editor will open in a new tab.
    → The shop settings are located in the toolbar on the left-hand side. Click on an icon to open the respective settings.

  3. Save (save) your settings after making changes.

7.3. Managing pages

page settings
Figure 7. Icon for page settings

In the Pages section, you manage your online shop pages. You can add new pages, change the order of pages in the navigation, and configure page-specific settings.

Adding a new page:

  1. Open the shop editor.

  2. Click add Add Page.
    → The Add Page window opens.

  3. Page Name: Enter a unique name for the page.

  4. Page Type: Select the page type.

    • Content (pages with static content, for example legal texts or blogs)

    • Product Category (item page)

  5. Parent Page: Determines whether the page will be a subpage or a new, independent page.

  6. Click (add) Add Page to add the new page.

A page created in the editor automatically creates a corresponding category in the backend.

7.3.1. Editing a page

To adjust the settings of an existing page, navigate to the categories in the lower section of the Pages menu:

  • Content Pages: Includes all static pages (e.g. legal texts).

  • Product Categories: Contains the product categories of your shop.

shop select page type
Figure 8. Content pages and product categories

Opening the page settings:

  1. Expand the desired section.

  2. Point the cursor over the page you want to edit.

  3. Click the gear wheel icon (settings).

  4. Carry out the settings in the General Settings or SEO Settings sections.
    For more information about the settings, see the chapters General settings and Search engine optimisation.

  5. Click Save settings to apply the changes.

7.3.1.1. General settings

These settings define the identity and visibility of the page.

Table 3. General page settings
Setting Explanation

Basics

Page ID

A unique identification number for the category. The ID cannot be changed.

Page Type

The page type determines the functionality of the page.

  • Content pages can be freely designed with page blocks.

  • An item page serves to display specific items in a category and thus structure the shop.

Page Name

The title of the page as it appears in the shop. This title can be displayed in the navigation depending on the settings. The title can be changed at any time.

Parent Page

Select a Parent Page if you want to create a new page as a child page.
Note: This setting is optional and you do not have to select a Parent Page.

URL Slug

A URL slug is the last part of a URL that serves to make the page uniquely identifiable. The URL slug can be changed at any time.
Note: Changes to the URL slug may cause links that refer to an old URL slug to no longer work.

Position

The position number determines where a page is displayed in the navigation. Lower position numbers are displayed higher up in the navigation.

Activate page for store

As long as this option is enabled, the page will be accessible to visitors to your shop and website crawlers. You can deactivate the page to customise it to your liking. Only activate pages once you are satisfied with their layout and content.
Note: As long as the page is inactive, it cannot be accessed via links or page navigation.

Display in header navigation

Activate to make the page accessible via the navigation in the header.

Login Necessary

Activate to make the page accessible only to logged-in customers.

7.3.1.2. Search engine optimisation (SEO)

Here you control how a single page is perceived by Google, etc.

Table 4. Search engine optimisation (SEO)
Setting Explanation

SEO

Meta Data

Title

Enter a meta title. The meta title defines the title of your page for search engines (=the link to your page in the search results).
The meta data is used for the home page and all pages that do not have their own meta data.

Meta description

Enter a meta description. The meta description is evaluated by search engines as a brief description of your page. The meta description should have up to 160 characters.
The meta data is used for the home page and all pages that do not have their own meta data.

Meta keywords

Enter relevant search terms that give search engines a better overview of the content on your pages. Enter keywords in lower case and separated by commas.
The meta data is used for the home page and all pages that do not have their own meta data.

Robot settings

Robots

This setting affects how search engines treat your shop page. You can specify the behaviour for each page separately.

  • All = Add the page to the search and follow the links on the page.

  • No Index = Do not add the page to the search.

  • No Follow = Do not follow links on page.

  • No Index, No Follow = Do not add the page to the search and do not follow the links on the page.

Further settings

Canonical URL

Enter the URL to use as the canonical URL for item pages. A canonical URL is the version of a web page that search engines should consider to be the original.
This setting allows you to manually specify a canonical URL for variations that may be recognised as multiple duplicates by crawlers.

Include page in Sitemap.xml

Enable if the page should be included in the sitemap.xml. A sitemap.xml is a structured file in XML format that lists all relevant subpages, images and videos of a website. A sitemap.xml can help search engines efficiently capture the structure of a website.

7.4. Managing languages and translations

shop localization settings
Figure 9. Icon for language and translation settings

In the Localization menu, you carry out settings for languages and translations.

  • In the Shop Languages section, you set the default language for your shop and add additional languages that users can select in your shop.

  • In the Edit translations section, you can maintain translations for various elements of the shop.

    • Once you have activated a language (check_box), click edit Edit translations to translate the various elements of the user interface. A new column is added for each language, where you can enter your translations.

    • Note: Only the static texts specified by the shop can be translated into the selected languages. These are all texts that cannot be edited using the editor. Texts that you add yourself in the editor, as well as item and category data, cannot be translated here.

Shop must be deployed

The settings in the Localization menu will only be applied after the shop has been redeployed.

7.5. Branding & Design

shop design settings
Figure 10. Icon for design settings

In the Branding & Design menu, you can define the visual identity of your shop, i.e. save your logo and favicon and carry out settings for fonts, colours and headers.

7.5.1. Uploading logo and favicon

Upload the main images for your shop in the Branding » Images section. The files are managed via your web space.

  • Favicon: The Favicion is an image file in .ico format. It serves as a visual identifier for your shop, displayed in browsers next to the page title in tabs or in bookmark lists.
    Recommended dimensions: 32 x 32 px or 48 x 48 px

  • Logo: The logo is an image file that appears in the left corner of your shop header on all pages. The file must be in .svg, .webp or .avif format.
    Recommended dimensions: Format .svg = 150 x 40 px; formats .webp or .avif = 180 x 80 px

Uploading an image file:

  1. Open the shop editor.

  2. Go to Branding » Images.

  3. In the Favicon or Logo section, click Select to open the file selection for your web space.
    Note: You can manage the web space in the PlentyONE backend in the Shop » Webspace menu.

  4. Click upload in the right-hand section of the file selection to open the file upload.

  5. From the Root Folder drop-down list, select a folder in your web space where you want to upload the image file.

  6. Drag a file into the section or click Click to select file to select a file.

  7. Click Add image to upload the file.
    → The file is uploaded.

7.5.2. Editing the shop name

In the Branding » Texts section, you can customise the name of your shop. The shop name is the name that appears in search engine results.
Click in the input field to customise the name of your shop.

7.5.3. Defining the shop design

In the Design section, you can set the colour scheme and typography for your shop.

Visibility of the changes

Fonts will only be visible after the shop has been deployed. You can see colour adjustments immediately in the editor preview mode.

Table 5. Design settings
Setting Explanation

Design

Fonts

Global fonts

Select the font that will be used globally for all shop pages.
The shop supports Google Fonts. The Google fonts are downloaded during the shop build process, so that the shop is not connected to Google when it goes live.

Click on the selection field to expand the drop-down list for fonts and select a font.
Tip: The selection field also serves as a search field for fonts.

Colours

Primary colour and secondary colour

Define the colour scheme of your shop. The primary colour and secondary colour form the basis of your shop’s colour scheme. Ten shades are generated from both colours, which are used in different places in the shop to dynamically colour your shop.

There are two ways to choose the colour:
- Enter a hexadecimal code in the respective input field.
or
- Click on the colour preview in the input field to open the colour selection including the colour picker.

Header

In the Header section, you can specify the colour scheme for the header. This allows you to design your header separately from the other pages of your shop. You set the colours for the header globally, so the header looks the same on every page of your shop.

There are two ways to choose the colour:
- Enter a hexadecimal code in the respective input field.
or
- Click on the colour preview in the input field to open the colour selection including the colour picker.

  • Background colour = Determines the background colour of the header.

  • Icon colour = Determines the colour of the clickable buttons contained in the header.

Spacing

Horizontal spacing & Vertical spacing

Define the horizontal and vertical spacing of the blocks. This means that you determine how far apart the different components of the page should be arranged. You can select from four spacing options:

  • S = corresponds to 30 px

  • M = corresponds to 40 px

  • L = corresponds to 50 px

  • XL = corresponds to 60 px

7.6. Category

shop category settings
Figure 11. Icon for category settings

In the Category menu, you can specify how items are arranged in your categories.
Table 6 contains an overview of the available settings.

Table 6. Settings for category sorting
Setting Explanation

Category Sorting

Enable item sorting by

Select from the drop-down list which criteria (price, name, etc.) customers can use for sorting.
- If a value is highlighted in green, click to add this value as an option in the shop.
- If a value is highlighted in red and has the word Selected after it, click to remove this value as an option from the shop.

Default Sorting

With this setting, you can specify the value by which items should be sorted on the category page by default. If you select the Recommended option, you can adjust this value to suit your needs using the Recommended Sorting setting.

Recommended Sorting

First sorting option
Second sorting option
Third sorting option

With these options, you determine how the “Recommended” sorting value, which customers can select in the shop, is calculated. The first sorting option has the highest priority in sorting, the second value has the second highest priority, and so on.
If Recommended is selected as the sorting option in the front end, the items in the relevant category are first sorted according to the first value selected in this setting; if several items would be sorted to the same position, the second sorting value takes effect and sorts these items according to the second value.

Note: These settings will only be applied after the changes have been saved and the page has been reloaded.

Variation Position Based On Sales

Calculate the variation position based on monthly sales

With this setting, you can specify whether variations should be sorted by number of sales. Activate this option to sort variations based on last month’s sales figures. Once per night, the variations that were purchased most frequently in the last month are calculated.
Note: Note that this is a global setting that applies to every client (shop).

7.7. Checkout

shop checkout settings
Figure 12. Icon for checkout settings

In the Checkout menu, you can configure settings for the checkout process in the shop.
Table 7 contains an overview of the available settings.

Table 7. Checkout settings
Setting Explanation

Customer Input Settings

Your Reference Input Field

Activate to add an input field for “Your reference” in the checkout process, where customers can enter a separate customer name or contract number as a reference, for example.

Customer Wish Input Field

Activate to add an input field for additional customer requests that can be added to the order during the checkout process.

Vat Number Validation

Validate VAT number

Activate if the customer’s VAT identification number is to be checked during the checkout process. The VAT identification number is always checked when an order is completed or when the customer’s address has been changed.
Note: The VAT identification number is verified by the external service VIES.

7.8. Custom Code

shop custom code
Figure 13. Icon for custom code settings

In the Custom Code section, you can customise your shop with your own code snippets:

  • * Custom CSS*: Individual styling and layout adjustments.

  • Custom JavaScript: Dynamic elements and functional enhancements.

  • Custom meta tags: Additional descriptions for SEO or verification.

  • External Scripts & Styles: Integration of external scripts, stylesheets and libraries.


7.8.1. Managing snippets

  • Display snippets: Expand the Saved Snippets section to display all previously saved snippets.

  • Edit snippets: Click edit to edit a snippet.

  • Enable snippets: Activate the toggle button next to the snippet (toggle_on) to activate the code.

  • Add snippets: Click add Add snippet to define additional code snippets.

Debugging

In safe mode, all custom code snippets for the shop are globally deactivated. This can be useful, for example, if you want to debug your shop.
You can activate safe mode in the Shop » Shop management menu via more_vert » bug_report Safe mode.

7.9. General settings

shop general settings
Figure 14. Icon for general settings

In the General Settings menu, you can manage settings related to contact, security, and performance. Table 8 contains an overview of the available settings.

Table 8. General settings
Setting Explanation

Contact Form

Contact Form Email

Enter your email address for the contact form in the Contact Form Email input field. When customers fill out the contact form in your shop, the form will be sent to this email address.

Customer Management

Assign standard customer classes for B2B and B2C/guests.

Note: Changes to the customer class will only be applied after you have saved the changes and reloaded the editor.

Default B2B Customer Class

Select the customer class from the drop-down list Default B2B customer class that should be assigned to B2B customers by default.

Default B2C And Guest Customer Class

Select the customer class from the drop-down list Default B2C and guest customer class that should be assigned to B2C customers by default. This customer class is also assigned to customers who place orders as guests in your shop.

Performance

Image Optimization

Automatically convert item images into modern formats. This reduces the file size and speeds up loading. This may increase the cost of cloud storage, but it reduces traffic costs.

Convert item images to AVIF

Activate to convert images in your shop to the .avif file format.
AVIF offers better compression than JPG, PNG and WebP. AVIF is supported as a format by most browsers. If the Convert item images to WebP setting is also enabled, WebP will be used as a fallback format for browsers that do not support AVIF.

Convert item images to WebP

Activate to convert images in your shop to the .webp file format.
WebP offers better compression than JPG and PNG. If the Convert item images to AVIF setting is also enabled, WebP will be used as a fallback format for browsers that do not support AVIF.

Security

Session and Url Lifetime

Validity of the session cookie

This setting determines how long the session cookie should remain valid. This means you determine the session duration of your shop. A session cookie is a small text file that is stored on your computer or smartphone while you are browsing. The session cookie ensures, for example, that items remain in the shopping basket while customers browse your shop and that your customers remain logged in while surfing your shop.

The following options are available for setting the lifetime of the session cookie:

  • Until the browser is closed = The session cookie is valid as long as the browser is open.

  • One hour, even if the browser is closed = The session cookie is valid for one hour, even if the browser has already been closed.

  • One day, even if the browser is closed = The session cookie is valid for one day, even if the browser has already been closed.

  • One hundred days, even if the browser is closed = The session cookie is valid for 100 days, even if the browser has already been closed.

Shipping Information Page

Category for shipping information page

Select the category whose data should be used as a template for the shipping information. By default, this page is linked wherever shipping costs are mentioned. Visitors who click on the link will be redirected to the category page containing your shipping cost details.

7.10. Item settings

shop item settings
Figure 15. Icon for item settings

In the Item Settings menu, you can configure settings for availability notifications, item bundles, and the display and sorting of your items in your shop.
Table 9 contains an overview of the available settings.

Table 9. Item settings
Setting Explanation

Back In Stock Notifications

Enable notify me

Activate if you want a subscribe button to appear on product pages for sold-out items. When customers click Subscribe, they will be notified by email as soon as the item is available again.

Item Bundles

Bundle presentation and behaviour in the basket

Defines how item bundles should be displayed in your shop and in the shopping cart. The following options are available:

  • Only list the components of the item bundle and replace the item bundle with the basic items in the order process = Only the individual components of the item bundle are displayed. The individual items are displayed in the shopping cart.

  • Only show item bundle without individual components and do not split the item bundle in the order process = Only the entire item bundle is displayed, but not the individual components. The item bundle is not divided in the shopping cart, i.e. the individual components are not displayed here either.

  • List both the item bundle and its individual components = The item bundle and the individual components of the item bundle are displayed.

Item Internal Sorting

Adopt title sorting from item sorting

Use this sorting option if the item sorting selected by customers in the shop should also apply to the sorting of variations on an item page. In this case, the selected value is used as the first sorting value for the item page.

Sorting Option 1 and Sorting Option 2

The settings for Sorting Option 1 and Sorting Option 2 only apply if no clear order can be derived from the item sorting selected in the shop or if the Adopt title sorting from item sorting setting is not used.

Manufacturer Information

Defines which manufacturer information should be displayed in the item view.
Activate (toggle_on) the information to be displayed on the item page.

7.11. SEO settings

shop seo settings
Figure 16. Icon for SEO settings

In the SEO Settings menu, you carry out settings for search engine optimisation. This includes settings for robots, i.e. crawlers that track and index pages for search engines, rich snippets and schema.org-supported structured data.
Table 4 contains an overview of the available settings.

Table 10. SEO settings
Setting Explanation

Custom canonical URL for item pages

Set up custom Canonical URL for single item views

This setting allows you to manually specify a canonical URL for variations that may be recognised as multiple duplicates by crawlers.
Use a property of type Text to specify a canonical URL for a variation. This property must be linked with the desired variations. Enter the ID of the property in the input field.

Meta Data Defaults

Set default values for meta data, such as title and description.

Note: The settings in the Meta Data Defaults section are global settings. These settings apply to all pages that do not have page-specific settings.

Default title

Enter text that should be displayed as the title in search engine results.

Default meta description

Enter a short description of the shop that will be displayed in search engine results. The text should be informative and appealing.

Default meta keywords

Enter search terms relevant to your shop, separated by commas. Meta keywords can help your shop to be found using specific search terms.

Robots

All Pages

The settings in the All Pages section define the default behaviour of the search engine for all pages in your shop. By default, all pages should be indexed (select the All option) to ensure that your items and content can be found.
Changes to these settings affect all pages unless settings have been made at page level. Only change the settings here if you want to restrict indexing for the entire website, for example for a private version of your shop.

Robots

This setting determines how search engines should treat automatically generated pages.
Available options:

  • All = Include the page in the search engine index and follow the links on the page.

  • No Index = Do not include the page in search engine index.

  • No Follow = Do not follow links on page.

  • No Index, No Follow = Do not include the page in the search engine index and do not follow the links on the page.

Static Pages

Determine how search engines treat the integrated pages of your shop. By default, those pages should be indexed (select the All option) to ensure that they can be found. Only restrict indexing if there is a specific reason for doing so, e.g. temporary content, duplicate pages or private pages.
The following robots settings are available:

  • Robots for cancellation form

  • Robots for cancellation rights

  • Robots for declaration of accessibility

  • Robots for contact page

  • Robots for HomePage

  • Robots for legal disclosure

  • Robots for privacy policy

  • Robots for search result

  • Robots for terms and conditions

Available options:

  • All = Include the page in the search engine index and follow the links on the page.

  • No Index = Do not include the page in search engine index.

  • No Follow = Do not follow links on page.

  • No Index, No Follow = Do not include the page in the search engine index and do not follow the links on the page.

Item Pages

Robots for item pages

Set default values for the robots meta value of your article pages.
Available options:

  • All = Include the page in the search engine index and follow the links on the page.

  • No Index = Do not include the page in search engine index.

  • No Follow = Do not follow links on page.

  • No Index, No Follow = Do not include the page in the search engine index and do not follow the links on the page.

  • Selection via variation property of the type "Text" = Select a custom value at variation level. If you select this option, enter the ID of the property in the input field ID from property of type “Text”.

Exclude URLs with parameters (depends on if it excludes or includes when active)

Activate if item pages with URL parameters (such as referrer or language) should be excluded from search indexing.

Paginated Pages

At which page should robots stop indexing your category pages? Default = 0

Specify the number of paginated pages that search engines should index. The value 0 means that only the first page is indexed, while subsequent pages are not indexed. Only increase this number if additional paginated pages are to be displayed in the search results. Note that this may result in duplicate content.

Improve product listings in search engines

Specify how item details are displayed in search results. This helps search engines to present your articles in a clearer and more appealing way.

Availability

Availability 1-10 = Assign the availabilities defined in the Setup » Item » Availability menu to the availabilities defined by Schema.org from the drop-down list. This enables search engines to better evaluate availability information.

Item Condition

Assign the item conditions defined in the menu Item » Items » [Open item] » Section: Settings » Drop-down list: Condition to the conditions defined by Schema.org from the drop-down list. This enables search engines to better evaluate the condition of the item.
Available options:

  • Item condition: B-stock

  • Item condition: new

  • Item condition: new and original packaging

  • Item condition: new with label

  • Item condition: used

Rich Snippet Mapping

Select the data sources in PlentyONE from which the rich snippets for item pages should be taken for the brand, manufacturer, SKU, and various barcodes. Rich snippets are structured data that provide extended data for search engines. Some of the selectable options display additional input fields where you can enter the ID of a text property, for example, to make rich snippets more versatile.
Available options:

  • Select source for the brand in Rich Snippets of the item page

  • Select source for the manufacturer in Rich Snippets of the item page

  • Select source for GTIN barcode in Rich Snippets of the item page

  • Select source for GTIN-8 barcode in Rich Snippets of the item page

  • Select source for GTIN-13 barcode in Rich Snippets of the item page

  • Select source for ISBN barcode in Rich Snippets of the item page

  • Select source for the MPN barcode in Rich Snippets of the item page

  • Select source for price validity in Rich Snippets of the item page

  • Select source for SKU barcode in Rich Snippets of the item page

Note: If you select Do not display, the data (e.g. the manufacturer or brand) will not be passed on as a rich snippet.


7.11.1. Representation on social media

In the SEO Settings » Social Media section, you can specify how your shop will be presented when it is shared online.
The following settings are available:

  • Image for OpenGraph = Enter the URL of the image that should be displayed as a preview image when the shop is shared on social media.
    Recommended dimensions: 1200 × 630 px

  • Title for OpenGraph = Enter a title for your page that will be displayed when the shop is shared on social media.
    Recommended length: 40–60 characters; maximum 80 characters


7.11.2. Setting up Google Analytics

Information obligation concerning data protection

When using Google Analytics, you are obliged to provide information about how the data is used in your privacy policy. Note that when using services which transfer personal data to third countries (e.g.: USA), the requirements for authorised data transfer in accordance with Art. 44 ff GDPR must be met. This is the case when Google Analytics is used.

In the SEO » Tracking & Analytics » Google Analytics menu, you can integrate the Google Analytics analysis service into your shop in order to collect and evaluate data on user behaviour on your pages.

Which data is evaluated?
  • All automatically collected events, such as purchases and shopping carts, user interactions and checkout process, as well as some link: recommended events.

  • Affiliate data is evaluated, i.e. when customers enter your shop via affiliate links or partner recommendations, this data is recorded.

Table 11 contains an overview of the available settings.

Table 11. Google Analytics settings
Setting Explanation

Cookie Group

Select the cookie group in which the Google Analytics cookie should be included (Necessary, External Media, Functional or Marketing (recommended)). By default, the Google Analytics cookie is added to the Marketing group.

Enable Google Analytics

Activate if you want to use Google Analytics.
Important: Note the information regarding your data protection obligation in this section.

Google Analytics Tracking ID

Enter the Google Analytics tracking ID. This ID has the format UA-12345678-9. Without this tracking ID, the behaviour of visitors to your shop cannot be evaluated.

Register Cookie as opt-out

Activate to use the Google Analytics cookie as an opt-out option. This means that the cookie is initially active and users must proactively reject this cookie if they do not want their behaviour to be tracked and evaluated. This option can only be activated if the Google Analytics cookie is not assigned to the Necessary cookie group.

Send Gross Prices to Google Analytics

Activate to transmit gross prices to Google Analytics. Net prices are transmitted by default.

Shop must be deployed

The settings in the Google Analytics menu will only be applied after the shop has been redeployed.

8. Mollie integration for the shop

Mollie is an online payment service provider. Mollie allows you to offer many payment methods with a single integration in your shop. To integrate Mollie payment methods into the shop, you require the Mollie plugin and then go through the guided setup for the Mollie payment methods offered.

8.1. Installing the Mollie plugin

First add the Mollie plugin to a plugin set. Proceed as follows:

Installing the Mollie plugin:

  1. Go to Plugins » Plugin set overview.

  2. Click on the plugin set in which you want to install Mollie.

  3. Click Add plugin in the header.

  4. Under Add plugins to installation list, click Marketplace to open the PlentyONE Marketplace.

  5. Use the search function to open the Mollie plugin in the marketplace.

  6. Click Go to checkout and purchase the plugin. The plugin is free.
    → It may take a few minutes until the purchased plugin is available in the back end.

  7. Return to your plugin set in the back end, in which you want to install Mollie.

  8. Click Add plugin in the header.
    → The Mollie plugin will appear in the list of available plugins after a few minutes.

  9. In the header, click install.
    → The plugin will be installed and the plugin set overview will open.

  10. Activate the Mollie plugin by clicking the toggle in the Active column.

  11. Click Deploy plugin set.
    → After a few minutes, the deployment of the plugin set will be finalised and Mollie will be available as a new entry in the Setup » Orders » Payment menu.

The Mollie plugin itself has no settings. All settings for Mollie payment methods can be found in the Setup » Orders » Payment » Mollie menu. Note that you must have a registered Mollie account in order to be able to use Mollie payment methods in the shop.

8.2. Registering with Mollie

To use Mollie, you need a Mollie account and the login data. Without these, the plugin cannot be set up and is not usable. If you do not yet have a Mollie account, register with Mollie first.

8.3. Guided setup for Mollie settings

In the menu Setup » Orders » Payment » Mollie you will find the guided setup for the Mollie settings. This will guide you through all aspects of the payment methods. The Guided tour can easily be overlooked. You can find it in the bottom left corner in the side menu.

Click Guided tours and then Mollie settings to start the guided setup.

8.4. Additional settings

The Mollie manual page contains additional helpful information on setting up customer classes, shipping profiles, and event procedures for Mollie payment methods.

8.5. Available Mollie payment methods

You can currently offer the following payment options in your shop via the Mollie shop integration:

  • Bancontact

  • Bank transfer

  • Belfius

  • Credit card

  • EPS

  • KBC/CBC

  • PayPal

  • Przelewy24

  • Invoice purchase for B2B (Billie)

  • Trustly

  • iDEAL

  • in3

  • BLIK

  • TWINT

  • Gift Cards

  • BANCOMAT Pay

  • Pay by Bank

Several payment options can be configured in the Mollie settings in the back end, but are not supported by the new shop at this time. Refer to the list of payment options available in the shop.

9. DHL preferred delivery integration

9.1. Overview

The DHL Preferred Delivery plugin provides DHL preferred delivery services for your shop. You can set up the DHL preferred delivery services using the DHL Preferred Delivery assistant, which is available in the plugin set in the Setup » Assistant » Plugins menu after you have completed the Integrations assistant.

Afterwards, you have to activate the services in the DHL Shipping: Settings combination assistant. For further information, refer to the DHL Shipping^ page.

Tracking pixel for reporting purposes

Note that the DHL Preferred Delivery plugin contains a tracking pixel. This is due to reporting purposes. The pixel returns the URL where the plugin is used as well as the total number of plugin calls. No person-related data or data that could be related to persons will be collected or processed.

9.2. Requirements

In order that you can offer your customers the DHL Preferred Delivery services in your shop, the following requirements have to be met.

9.2.1. Registering with DHL

In order to use the DHL Preferred Delivery services, you have to be registered with DHL. You receive the data from DHL that you need for the settings in PlentyONE. Note that the DHL Preferred Delivery services are only available for deliveries within Germany.

9.2.2. Installing the plugins with the help of the Integrations assistant

To use the DHL Preferred Delivery services, you need the following plugins. Use the Integrations assistant in the Setup » Assistants » First steps menu to install the plugins.

Once you have successfully completed the Integrations assistant, the plugins listed above will be installed automatically in the background. This can take a few minutes. You can then complete the DHL Preferred Delivery assistant.

9.2.3. Selecting DHL Shipping (Versenden) as shipping service provider

DHL Shipping (Versenden) has to be selected as shipping service provider in the Setup » Orders » Shipping » Settings menu in the Shipping service provider tab. This is the only way you can offer DHL preferred shipping in your shop’s checkout.

9.3. Completing the assistant

Once you have installed the plugins with the help of the Integrations assistant, the DHL Preferred Delivery assistant is visible in the Setup » Assistants » Plugins menu in your plugin set.

Complete the assistant DHL Preferred Delivery to save a surcharge for the Preferred day service, determine the cut-off times that belong to the Preferred day service and set the days where no parcels are transferred to DHL.

DHL offers the services Preferred neighbour and Preferred location without any additional charge. If your customer selects the Preferred day service in the shop, the price you determined for this service is displayed in the order process and added to the order’s total sum.

9.4. DHL Packstation/Postal outlet finder

Your customers can use the DHL Packstation/Postfiliale (Postal outlet) finder during the order process in your shop to search for a packstation or post office nearby and select this address as delivery address. This way, your customers can pick up your parcels when it suits them best. To do so, they select an appropriate packstation or post office during the order process from the results list. This address is then saved as the delivery address.

Note: Your customers can enter the street, postcode or town. If the street is entered, it is required for the search to display results that in addition at least the postcode or the town is entered.

In order that your customers can use the finder in the shop to search for a DHL Packstation or post office nearby, you have to enter your Google Maps API key and activate the finder in the DHL Shipping: Settings combination assistant. Activate also the option (toggle_on) at the bottom if you want that it is mandatory for your customers to enter the DHL post number for post offices in the finder.