Setting up the marketplace homepage

TABLE OF CONTENTS

• 
  
  • 1. Overview
  • 2. Requirements & Preparation
  • 3. Step-by-Step Configuration
    • Step 1: Navigate to the Settings
    • Step 2: Create a Marketplace Message
      • Supported Message Types:
    • Step 3: Display Content on Homepage
      • Visual Examples:
  • 4. Review & Validation
  • 5. FAQ
  • 6. Conclusion

1. Overview

The marketplace homepage is the first screen users see when they open the app. A clear, logical, and visually appealing layout directly impacts user experience, conversion rates, and average order value. This guide provides step-by-step instructions for creating and configuring homepage content using the Marketplace Messages and Discovery tabs.

2. Requirements & Preparation

Before getting started, make sure you have:

• Access to edit the marketplace;

• Prepared images and copy for your content;

• A clear understanding of your marketplace's structure and goals (businesses, delivery zones, promotions, etc.);

• Predefined categories and linked businesses if you plan to use a Categories list type.

3. Step-by-Step Configuration

Step 1: Navigate to the Settings

It's important to understand the roles of the two key tabs:

• Marketplace Messages – used to create and manage content: banners, articles, alerts, cards with text, links, videos, vouchers, etc. This is where homepage content is created.

• Discovery – controls how content is displayed on the homepage: order, structure, layout type (row, banner, grid).

Combining these two tabs allows you to build a dynamic, adaptive, and business-effective homepage.

Go to Marketplace → App Builder to find both Marketplace Messages and Discovery tabs.

Step 2: Create a Marketplace Message

All message types except Popup and Service shutdown must be configured in the Discovery tab to be visible to users.

1. In the Marketplace Messages tab, click Add.

2. Fill in the following fields:

   • Image – upload the background for the card. Most file types are accepted. Max size is 10MB. Recommended proportions: 5*3 (width*height);

   • Regions – optionally restrict visibility to selected delivery zones; leave empty to show in all zones;

   • Title – the main headline on the card;

   • Subtitle – optional secondary text line below the title;

   • Label – internal name not shown to users; helps managers organize and manage items;

   • Tag – short visual indicator on the card, e.g. Discount, New, Promo;

   • Language – determines when the card will display based on the user's interface language. You can select one or multiple languages. If left blank, the card will show for all users regardless of language;

   • Action button title – defines a button on the card (e.g., "Learn More", "See Now").

     1. Enter a value in Action button title.

     2. Click Save.

     3. A new Gallery tab appears in the left menu.

     4. Open Gallery and click Add to define the message that opens when the button is clicked.

     5. Upload an image, set a title and description — this becomes the linked content.
        

   • Message type – defines card format and behavior. Each type may reveal different config fields. For example, Banner doesn’t require message input, but Article or Message types include a text field.

   • Enabled – toggles card visibility in the app;

   • Message – the text that appears when the card is tapped, or is displayed on popup-style cards. Relevant for specific types like Message, Article, Service shutdown, and Popup.

   • Business ID and Product – used to promote a specific item from a specific business.

Supported Message Types:

• Popup – appears when the app opens:
  
  

• Banner – a visual card or slider with image/video only; no message on click:
  
  
  

• Article – an interactive card that opens a detailed text message upon tapping. Ideal for in-depth descriptions, news, instructions, promotion details, or any informational blocks requiring expanded content. The user receives both a visual cue and accompanying rich text information:
  

• Business promotion – allows you to feature and promote a specific product tied to a particular business. When a user taps the card, they are redirected directly to the product page within that business. This is especially effective for spotlighting special offers, new menu items, or promotional deals. The card can include an image, title, and an action button for quick access:
  

• Service shutdown – notifies about unavailability of ordering;

• List promotion – adds a new field for selecting a "List type" that will open when the card is tapped. This allows you to assign dynamically generated collections based on filters such as Recommendations, Vouchers, Categories, Favorites, Most Popular, Fastest Delivery, Distance, Delivery Price, Free Delivery, History, New, Custom List, and Messages. This flexibility enables tailored content blocks on the homepage for promoting items and services based on their marketing status.

TIP: Choose the type first — available fields depend on it.

Step 3: Display Content on Homepage

1. Open the Discovery tab.

2. Click Add.

3. Fill in the following:

   • Visible – enables the element on the homepage;

   • Shuffle list – randomizes card order;

   • Disable rounded corners – uses rectangular instead of rounded cards;

   • Highlighted – applies a colored background to draw attention;

   • Hide video controls – hides play/pause buttons if the card contains video;

   • Margins – adds side padding to the block;

   • Label – internal name for organizing blocks;

   • List type – defines what kind of content will be displayed: Categories, Messages, Custom, Most Popular, Promo, Vouchers, etc.;

   • Business items – manually assign content (for Custom, Categories, or Messages);

   • Regions – limit visibility by delivery area, if needed;

   • Row items count – number of cards shown without scrolling;

   • Max items in preview – total number of cards shown, including those revealed by scrolling;

   • Positioning:

     • Row – horizontal scroll;

     • Banner – full-width banner view;

     • Table – grid layout;

   • Width to Height Ratio – defines card aspect ratio: 5x4, 5x3, 1x1, Fullscreen;

   • Layout orientation – select screen mode where block will appear: Portrait, Landscape, or All;

   • Language – like messages, content is filtered by user’s interface language.

Visual Examples:

• A block with Highlighted enabled has a colored background to attract attention.
  
  
  

• The Margins toggle determines whether content is centered or stretches full width.
  
  
  

• Row positioning produces a horizontally scrollable list.
  
  
  

• Table positioning renders a grid layout, ideal for categories/favorites.
  
  
  

• Fullscreen card ratio fills the screen height for a prominent look.
  

4. Save each block.

5. Use Sort mode to drag blocks into your preferred homepage order.

4. Review & Validation

Check the following:

• All needed items are created in Marketplace Messages;

• All items are added and configured in Discovery;

• Each block has Visible toggled on;

• Mobile display matches expectations (type, order, scrolling, look);

• Clicking each card triggers the correct action (banner, article, message, etc.).

5. FAQ

1. Why isn’t a block showing on the homepage?

• Check if Visible is enabled.

• Make sure selected Region matches the user’s location.

• Verify that the corresponding content exists in Messages for the selected type.

• Confirm the element is added under Discovery.

2. Why doesn’t the action button work?

• Make sure the linked gallery message is set up.

3. Why is the block showing but it’s empty?

• Check list type or if content is missing (no business/category linked).

4. How do I limit display by location?

• Use the Regions field to filter visibility.

5. How do I change the block order?

• Use Sort mode in the Discovery tab and drag items into place.

6. Conclusion

A well-structured homepage boosts engagement and usability. Use clear content, test different layouts, and optimize positioning. For edge cases, contact DelivApp Support or consult platform documentation.

Don’t forget to test the mobile view — appearance may differ from the web interface.