Skip to content
English
  • There are no suggestions because the search field is empty.

Theme

Under Design → Theme, you customize the appearance of your shopping app: colors, typography, styling, cards, navigation, search, categories, products and cart. Every change appears immediately in the live preview next to the settings.

 

Requirement: your app theme must be at version 7.33.5 or higher. Some settings require version 7.34.0. You can find out which ones and how to check the version of your app at the end of this article under Availability by theme version.

 

Overview

In the Shopgate backend, open Design → Theme.

The page has two halves: the settings on the left, grouped into nine categories, and a live preview of your shopping app on the right, where every change is rendered immediately.

Use the icons above the preview to switch between phone and tablet views.

CategoryContents
Colors Brand, text, navigation, surface, price and status colours of the app
Typography Font settings for text, buttons and prices
Styling Corner style, media widget margins and shadows
Cards & Tiles How cards, product cards and tiles are displayed
Navigation & Menu Header, header buttons and navigation bar
Search Search bar and search field
Categories How categories are displayed, plus the category and filter bar
Product Product images, action buttons, variant selection, grid, slider and reviews
Cart Add to cart bar on the product page and checkout bar

Finding settings quickly

If you are unsure which category a setting belongs to, use the search settings field above the categories.

The result list shows the full location for each setting, for example Colours › Main colours. Clicking a result opens that setting directly.

Light and dark appearance

In the Colours category, Theme → Appearance defines whether your app is displayed in light or dark mode.

The setting affects the entire app. The preview applies the change immediately, so you can check contrast and readability right away.

Defining colours

Under Main colours you define your app's brand colours. The primary colour shapes key interface elements such as buttons, the secondary colour serves as an accent.

Click the pencil icon to open the colour picker, or enter the hexadecimal value directly. The override default contrast text option determines which text colour is used on top of that colour.

Further down the category you will find additional colour groups.

Group Description
Text colours Body text and secondary text
Navigation Colours of the top and bottom bars
Surface colours Page background and content surface backgrounds
Advanced color configuration Counter and discount badges, rating stars and the round buttons on product images
Price colours Regular price, sale price and struck-through price
Input colors Background, text and icons of input fields such as the search bar
Status colours Error, warning and success states

Typography and custom fonts

In the Typography category you define the font settings for the entire app: base text size, base line height and the three font weights Regular, Medium and Bold.

Below that you will find separate sections for buttons and prices, where font size, line height, font weight and text transform can be set independently.

Using a custom font: switch on Load a custom font. Then enter the address of the stylesheet that provides your font under Font URL, and the name of the font family under Primary font family – exactly as it is defined in the font.

An example of such a URL: https://fonts.googleapis.com/css2?family=Playfair+Display&display=swap with the font family Playfair Display. Use the address of your own licensed font here.

Styling

Corner style

In the Styling category, Corner style defines how strongly corners are rounded in your app. The setting applies uniformly to product and category images, cards and buttons.

The options are slightly rounded, medium rounded, heavily rounded, square and custom. With the custom option you specify the radius in pixels yourself.

Spacing for media widgets

Also in the Styling category, Spacing for media widgets sets the default spacing around image and video widgets. You can specify separate values for top, bottom, left and right in pixels.

This spacing applies exclusively to image and video widgets. Other content such as product lists or category lists remains unchanged. To see the effect in the preview, scroll to a position where an image widget is displayed.

Individual widgets can override this default. A widget with its own spacing setting is unaffected by changes made here.

Shadows

Under Shadows you define the shadows of floating elements. For each shadow you set the horizontal and vertical offset, blur, spread and colour. The shadow of cards is set in the Cards & Tiles category.

ShadowApplies to
Floating elements Floating navigation bar and floating add to cart and checkout bars
Action buttons Round buttons for wishlist, share and add to cart on product images
Header buttons Floating buttons in the header

Cards and tiles

In the Cards & tiles category, Base style for all cards defines how cards are displayed in your app. Cards are raised containers that group related content, such as line items in the cart or products in a slider.

Card style Appearance
Shadow (elevated) Cards are raised from the background with a shadow; strength and colour are configurable
Border (outlined) Cards get an outline; border thickness and colour are configurable
Flat (no border) Cards are displayed without shadow and without border

Two more sections follow below. Under Product cards in sliders you set the inner padding of card, image and text and the number of lines for product names. Under Product and category tiles you set the background, border, inner padding and number of lines for the tiles in the product and category grid. Tiles do not use the card style; they have their own border.

Navigation and menu

In the Navigation & Menu category you define how the header and the navigation bar look and behave.

Header

Under Header you choose the display type. Fixed shows the header as a solid bar on every page. With Floating, logo and buttons float over the content on the home page and the product page; all other pages keep the bar.

For the floating header you also choose the scroll behavior: either a bar appears behind logo and buttons while scrolling, or the header hides when scrolling down and returns when scrolling up. Under Floating header you set the opacity and blur of the buttons and of the revealed bar. You also decide whether and where the logo appears on the home page.

Header buttons

Under Header buttons you assign one button on the left and up to two on the right. For each button you choose an action, for example search, cart, wishlist, store finder, scanner, menu or category flyout, and optionally a different icon. With the Open page action you link any page of your app by its page path, for example /page/shipping. The Share button only appears on the product page.

Navigation bar

Under Main navigation you determine how the bottom navigation bar looks and behaves. For the fixed bar, Border adds a top border and sets its colour. The shadow of the floating bar is set under Styling › Shadows.

SettingDescription
Navigation style Floating or fixed navigation bar
Show labels Shows or hides the labels below the icons
Hide on scroll Hides the navigation bar while customers scroll
Transition effect Type of animation when showing and hiding
Show favorites counter Shows the number of items on the wishlist on the icon

Search

In the Search category, Search bar defines on which pages a search field appears below the header: home page, categories, search results, content pages and wishlist. With Hide while scrolling, the search bar disappears when scrolling down and reappears when scrolling up.

Under Search field you can show an icon in the empty search field that opens the barcode scanner. The icon only appears in apps with a scanner.

Categories

In the Categories category, Display defines how subcategories appear on the browse page and on category pages: as a list or as a grid with images. For the grid you choose how many categories are shown side by side, separately for smartphone and tablet.

You also set the aspect ratio of category images, show or hide category images and, if you like, add an entry Show all products before the subcategories. Whether this entry is available for your shop depends on how your shop system is connected.

The Category and filter bar sits above product lists. Here you decide whether subcategories appear as swipeable chips in the bar, whether sort and filter are also shown in categories that have subcategories, and whether the bar hides while scrolling.

Product presentation

The Product category controls how products are presented in your app.

In the product grid you define how many products appear side by side – separately for small and large screen widths. For the product slider you instead define how many products are visible at once; decimal values such as 2.3 make the next product appear partially cut off, inviting customers to swipe.

Under product images you set the aspect ratio of your product images. Enter width and height as a ratio: 1 to 1 produces square images, 3 to 4 portrait ones. You also define the fill colour shown behind images that do not fill the frame, plus an optional inner shadow.

Setting Description
Products per row Number of products side by side in the grid, per screen width
Slides per view Number of products visible at once in the slider; decimals cut off the next product
Aspect ratio Format of product images, for example 1:1 square or 3:4 portrait
Image fill color Background colour behind images that do not fill the frame

Image gallery of the product detail page

Under Product images you also define how the image gallery of the product detail page shows which image is currently visible: with dots or a counter, either on the image or below it. The indicator only appears for products with more than one image and also applies to the fullscreen view. Margin and Corner radius move the images away from the edge and round their corners.

Action buttons

Action buttons are the round buttons for wishlist, share and add to cart on product images. Under Action buttons you define in which corner of the image they sit and whether they are arranged side by side or stacked. You also choose whether product tiles show an add to cart button, either as a round button on the image or as a button below the product, and whether the product detail page gets a share button. For products with variants, the add to cart button first opens the variant selection.

The colours of the buttons are set under Colors › Advanced color configuration, the shadow under Styling › Shadows.

Variant selection

Under Variant selection you determine how customers choose variants such as colour or size: with a dropdown or with chips. Chips either wrap into several lines or stay in one swipeable row.

Characteristics such as colour can be shown as swatches. Enter the names of the characteristics, for example “Farbe, Color”, and choose the source: the image of each variant or a product property that contains a CSS colour or an image URL. If neither exists, chips are shown. The shape and image zoom of the swatches can be adjusted as well.

You also decide whether the first available variant is preselected and how sold-out variants appear: struck through, hidden or not marked.

Reviews and manufacturer

Under Other you decide whether your app shows product reviews. If Show reviews is switched off, no rating stars or reviews appear anywhere in the app, not even in product sliders. Show write review offers customers to write a review themselves. Whether this is possible depends on your review provider.

You can also show or hide empty rating stars for products without reviews and decide whether the manufacturer appears below the product name on the product detail page.

Cart

In the Cart category you define how the bars at the bottom of the screen look.

SectionSettings
Add to cart bar Bar with the add to cart button on the product detail page: fixed or floating, optionally with a quantity picker
Checkout bar Fixed: totals and the “Checkout” button sit in one bar. Floating: the totals are shown in the cart, only the “Checkout” button floats and shows the grand total.

If the navigation bar is floating, both bars are always displayed floating.

Transferring a theme configuration

The three-dot menu in the top right transfers a finished theme configuration from one shop to another. This is useful, for example, if you want to agree on a design in a test shop first and then adopt it in your live shop.

Download Theme Config creates a JSON file containing the settings of all themes. Before the download, a dialog shows where the configuration comes from.

Upload Theme Config opens an area where you can drop the downloaded JSON file. Alternatively, click the area and select the file.

Important: the file contains theme settings only. Pages and content are not transferred.

Field Meaning
Merchant Merchant account the configuration comes from
Shop Shop the configuration comes from
Stage Environment, for example playground or live
Size File size of the JSON file

Saving and publishing

In the top right you will find the two buttons that complete your work:

Save stores your changes as a draft. Nothing changes in your customers' app at this point, and you can continue editing later at any time.

Publish applies the settings to your shopping app. Only this step affects your customers' app.

Reverting changes or resetting to default values

The three-dot menu in the top right contains two more entries. Both ask you to confirm in a dialog before they are carried out.

Revert Changes discards all changes you have not saved yet and restores the last saved values. This entry can only be selected if there are unsaved changes.

Reset to Default Values sets all settings in the editor to their default values. Your saved settings remain unchanged for now: the default values are only applied once you save or publish afterwards.

Availability by theme version

Which settings take effect in your app depends on the version of the theme. The table shows from which theme version each area is available.

CategorySectionFrom version
Colors All sections 7.33.5
Colors Advanced color configuration: action buttons background and icon 7.34.0
Typography All sections 7.33.5
Styling Corner style, media widget margins 7.33.5
Styling Shadows: floating elements 7.33.5
Styling Shadows: action buttons, header buttons 7.34.0
Cards & Tiles All sections 7.33.5
Navigation & Menu Main navigation, border 7.33.5
Navigation & Menu Header, header buttons, floating header 7.34.0
Search All sections 7.34.0
Categories Display: aspect ratio of category images 7.33.5
Categories Display: all other settings; category and filter bar 7.34.0
Product Product images: aspect ratio, fill color, inner shadow 7.33.5
Product Product images: position indicator, margin, corner radius 7.34.0
Product Product grid, product slider 7.33.5
Product Action buttons, variant selection 7.34.0
Product Other: show empty rating stars 7.33.5
Product Other: show reviews, show write review, manufacturer 7.34.0
Cart All sections 7.34.0

How to check the theme version of your app

  1. Open your app and tap More in the navigation bar.
  2. Scroll all the way down.
  3. There you will find the line Theme Version, for example “Theme Version: 7.34.0”.

If your version is older than required, please contact support@shopgate.com.

Do you have questions about individual settings, or are you missing an option? Your Shopgate contacts are happy to help.