# Self-Checkout settings explained

> Reference guide for the Self-Checkout settings: general, layout, features, bag, idle, payment, product pages, home, fonts, and theme.

This page describes Self-Checkout version 1.0.4. This version shares its settings form with an older kiosk app, so the form has more settings than Self-Checkout uses. Settings that this version doesn't use are marked as such.

## Console settings

1. **Installation name:** The installation name shown in **Apps** → **Installations**
2. **Add to group:** The installation group it belongs to in **Apps** → **Installations**
3. **Multi-language support:** The app's supported languages and default language. The kiosk returns to the default language each time it goes back to the idle screen. The kiosk's own texts are in English

## General

1. **Tenant id:** Overrides the installation's tenant ID
2. **Space id:** Overrides the installation's space ID
3. **App Timeout in seconds:** How long the kiosk waits without a touch or scan before it clears the bag and returns to the idle screen. Default 45
4. **Debug Computer Vision:** Not used by this app version
5. **Show products with 'Active' status only:** Only list products with the Active status in product lists
6. **Enable Omnibar:** Used only by the recommended products on the product page. The omnibar with the **Back** and **Pay** buttons is always shown outside the idle screen
7. **Enable Omnibar NPS** and **NPS display type:** No feedback survey is shown by this app version
8. **Enable Mobile Session Transfer:** Not used by this app version
9. **Include data and delivery options from specific spaces:** Also include the products of other spaces, such as an online store, with their own title and delivery options in the bag. Set the **Device SpaceId** labels and the **Additional Spaces**, each with a **Space ID**, **Title to be displayed**, and **Delivery Options**
10. **Show Powered by Ombori:** Show the Powered by Ombori logo on the idle screen and in the bag. Style it in **Customize with CSS** with the `.powered-by-image` class
11. **Product Types coverage:** Product type IDs to include. Products of the child product types are included too. When it is empty, all products are included
12. **Disabled Product Types request:** Product type IDs whose products can't be added to the bag from the product page. Child product types are disabled too

## Layout

1. **Show Header Bar:** Show the header bar on the home screen
2. **Logo:** The logo shown on the home screen
3. **Sticker Properties:** The **Border Type**, **Custom style on sticker value** (a **Background color** and **Text color** for each **Sticker value**), and **Sticker Display Type** of product stickers
4. **Traditional Layout:** Use the traditional home screen layout. When it is on, you can **Show background color**. When it is off, you can set the **Home Screen Label**. **Place bag on header** is not used by this app version
5. **Product List Layout:** **Default** or **Filter Focused**
6. **Product gallery orientation:** **LANDSCAPE** or **PORTRAIT** images on the product page
7. **Product description placement:** **BUILT-IN** or **SLIDE-OUT** product description on the product page
8. **Prices alignment:** **LEFT** or **RIGHT**
9. **Promo Price highlight:** Which price the **Promo** colour highlights: **Slashed Price** or **Active Price**
10. **Omnibar Layout type:** **ROUNDED** or **STRAIGHT** corners for the bar at the bottom of the screen

## Features

1. **Language Picker:** Not used by this app version
2. **Wake on motion:** Not used by this app version
3. **Move Categories to Explore screen:** Remove the categories from the home screen
4. **Call for help:** Not used by this app version
5. **Custom omnibar actions:** Not used by this app version
6. **Bag:** Show the add to bag button on the product page, and show the bag settings below. Scanned items are added to the bag whether or not this is on
7. **Custom sort:** Customise the sort options in product lists. **Use 'ranking' field as default sort** and **Ranking sort label** set the default sort
8. **Filter:** Show filter options in product lists. Add **Filter Option Keys** (a **Label** and the product feature **Key** for each filter), the **Color picker keys** to show as colour swatches, and the **Button Theme**
9. **Product external availability check:** Check the product's availability in store, online, and in nearby stores. Requires an integration with Ombori. Set the **Market ID**, **Store Sales Channel ID**, and **Radius meter**
10. **Inventory availability check:** Check the inventory of product variants. **Redirect to website via QR if unavailable** shows a QR code to your website, built from the **Redirect website URL**, **Redirect Label**, and **Redirect QR instruction**
11. **Display suggested retail price:** Show the suggested retail price. **Use suggested retail price as base price** uses it as the product's base price
12. **Enable screencasting feature:** Show product pages on another screen. Use **Enable feature to all devices under the installation** or **Force to screencast to this deviceId**
13. **Flights:** Not used by this app version

## Bag

These settings appear in **Features** after you turn on **Bag**.

1. **Display Total Discount Calculation?:** Show the number of items, subtotal, savings, coupons, and service charges above the total
2. **Cart level promotions:** Get promotions for the whole bag from a promotions service. **Custom Store id** overrides the store ID sent to the service
3. **Checkout method:** Only **External** is used, for the **Pay online** QR code on the payment screen. The other methods are not used by this app version
4. **Checkout Label:** Required when **Checkout method** is **External**. Not shown by this app version
5. **Checkout URL:** Required when **Checkout method** is **External**. The page that the **Pay online** QR code opens, with a `cart` parameter that lists the product IDs and quantities in the bag
6. **Customize Options Label:** Not used by this app version
7. **Additional Checkout Parameters:** A **Key** and **Value** for each extra parameter added to the **Checkout URL**
8. **Type of notification, which user sees after product was added to the shopping bag:** **TOAST** or **OMNIBAR**, when a product is added from the product page
9. **Hint text that is placed under the checkout button:** A text shown under the bag totals
10. **Separate RFID scanned items:** Show items read by the RFID reader in their own section of the bag
11. **Show privacy policy acceptance on checkout:** Not used by this app version

## Idle

1. **Display Options:**
   - **Default:** The **Splash Media** on one side and a button on the other
   - **Full Screen:** The **Splash Media** across the whole screen, with a heading, a text, and an optional button
   - **Custom (Home Screen):** The home screen with the categories and banners from **Active** → **Home**
2. **Splash Media:** The image or video on the idle screen (PNG, JPEG, SVG, GIF, MP4, or WebM)
3. **CTA label:** The button text. When it is empty, the button reads "Tap to get started"
4. **Hero section Heading** and **Hero section content:** The heading and text for **Full Screen**. When they are empty, the screen shows "Welcome" and "Scan your first item or tab to start"
5. **Show CTA Button:** Show the button on **Full Screen**
6. **CTA Button Position:** Not used by this app version
7. **Button Theme:** The button style: **primary**, **secondary**, **light**, or **custom**
8. **Background Theme:** The background colour behind the button for **Default**, picked from the **Theme** colours

## Payment

1. **Background Media:** The image or video shown on the payment screen

## Active

Customers reach the product page by tapping an item in the bag. The home screen is shown when **Display Options** is **Custom (Home Screen)**.

**Product Page**

1. **Display stocks:** Show the stock level
2. **Check Variant Active Price:** Check the active price of the selected variant. **Original active price to bag** adds the original price to the bag instead, and **Custom Store id** overrides the store ID
3. **Display locate in store (prototype only today):** Show the locate in store option
4. **Recommendations:** The **Scroll Direction** and **Source** of recommended products: **Default**, **Streamoid** (with a **Streamoid Refresh Token**), or **UNBXD** (with an **UNBXD API Key** and **UNBXD Site Key**). For Streamoid and UNBXD, **Inclusion** picks **Similar Items**, **Complete the Look**, or both
5. **Details:** The **Layout Type** (**DEFAULT** or **VERSION 1**), the **Color picker border type**, **Show QR code for product link** (with a title, subtitle, and **Additional query strings**), and the product features and custom content shown for each layout

**Home**

1. **Banners:** Banners with a **Title**, **Description**, **Call to action**, **Background** (video, image, or CSS), **Styles**, and an **On click** action
2. **Categories:** Category tiles, each with the product type **ID**, a **Title**, a **Background**, and **Styles**

## Fonts and styles

1. **Fonts:** **Light**, **Regular**, and **Bold** font files (OTF, TTF, WOFF, or WOFF2)
2. **Product Card Style Override:** CSS for the product card's **Container**, **Name**, **Price**, **Promo Price**, **Image**, and **Brand**

## Theme

1. **Theme style:** **LIGHT** or **DARK**
2. **Buttons border type:** **ROUNDED** or **STRAIGHT** button corners
3. **Colors:** **Primary**, **Secondary**, **Danger**, **Success**, **Light**, **Dark**, **Promo**, **Border**, **Ominibar and Keyboard Background Color**, **Main Screen Background Color**, **Secondary Screen Background Color**, **Background for variant selector**, and **Redirect icon indicator color**
4. **Shadows:** CSS shadows in **Small**, **Medium**, and **Large** sizes