Skip to main content

DX Market, Powered by GRUBBRR: Portal Setup Guide

Rob Knight
Updated

In this article, we will cover the basic steps that should take place when onboarding new clients with the Dover x GRUBBRR Partnership. 

Company Level

Creating a Location

  1. Sign in to dover.grubbrr.com at the company level using the client's credentials. 
  2. In the left sidebar, select 'Locations'
  3. Select 'Locations' from the dropdown menu. 
  4. On the top right of the Locations List, select 'Add New’

This will open the 'Create Location' page. On this page, enter the following information:

Section 1: Basic Information

The first section of the page has several required fields. Fill those fields in as follows: 

  1. 'Location Name': Use the Location Name provided by the client
  2. 'Location Email': Use the contact email provided by the client
  3. 'Contact No': Use the location's phone number, as provided by the client
  4. 'Customer Support Email': Use test@grubbrr.com 
  5. 'Logo': Click the ‘edit’ button at the top right of the Logo tile. Use the file browser window to select a locally saved image from your computer to upload as the logo for this location. 

Section 2: Owner Information


The second section of the page will auto-fill with information that was added during the Company Creation phase. You do not need to make any changes to this section. 

Section 3: Location Address

The third section that needs to be filled in is the location's physical address information. After typing in the street address, the system will provide you with a series of dropdown boxes that you can use to fill this section in. 

  1. 'Address 1': Refers to the street address of the location obtained from the client. 
  2. 'Select Country': Must be filled in
  3. 'State Name': Must be filled in
  4. 'City Name': Must be filled in
    Filling in these four fields should automatically populate the Latitude, Longitude, and Time Zone fields. Ensure that the time zone is correct. 
  5. 'Start Date': Enter the location's Go Live date in this field.
  6. 'Expiry Date': Must be filled in. We recommend selecting a date that is at least ten years away.
  7. 'Region': Must be filled in. Select the appropriate region in the dropdown menu. 

Once this information is filled in, scroll down to the bottom of the page and select 'Save.'

Editing The Color Scheme for the Pump Kiosk

You can control the color scheme that will appear in online orders and at the pump kiosk at the company level of the GRUBBRR Portal. To make changes to these settings: 

  1. Sign in to the dover.grubbrr.com Portal at the company level
  2. In the left sidebar, select ‘Locations’
  3. Select ‘Locations’ from the dropdown menu
  4. Find the location that you wish to edit
  5. Click the orange color code button on the right side of the table for that location.

This will open the App Settings page, where you can change the following colors:

  • Primary Color: This affects the 'Add to Cart' button, the color of header bars, etc. 
  • Secondary Color: affects the color of a category when it’s selected, the cart button, positive / selected buttons.
  • Positive Button Color: Affects the color of active buttons in the UI- things that can be selected by the user.
  • Negative Button Text Color: Affects the color of text on inactive buttons- things that the user can not click- in the UI. 
  • Text Color: Affects the color of text on the menu screen, popups, and rotating headers.
  • Positive Button Text Color: Affects how text appears on active buttons- things that the user can interact with- in the UI
  • Negative Button Color: Affects the color of inactive buttons in the UI- things that can not be selected by the user.
  • Expand to Screen & Header Icon Color: Affects the appearance of the icons associated with the Expand Screen button & the rotating header.  

You can change these settings in two ways:

  1. Manually, by clicking on the colored tile in each box and selecting the color you want from the pallet, OR
  2. By entering the appropriate hex code for the color in the text box. This is the preferred method, as it ensures consistency across all locations. 

Once you have made the changes that you want to apply to your kiosk, select 'Save'. 

Previewing the Changes to your Kiosk’s Color Scheme

GRUBBRR’s Portal allows you to preview the changes you make to a kiosk’s color scheme directly from the Portal. 

After saving your changes, selecting the yellow Preview button at the bottom of the page will display a mock-up of your Kiosk’s user interface, allowing you to review where and how the display was affected by each change. 

Editing The Color Scheme for Online Orders

You can control the color scheme that will appear in online orders and at the pump kiosk at the company level of the GRUBBRR Portal. To make changes to these settings: 

  1. Sign in to the dover.grubbrr.com Portal at the company level
  2. In the left sidebar, select Online Ordering
  3. Select Online Ordering Color Theme

This will open the App Settings page, where you can change the following colors:

  • Primary Color: This affects buttons, the color of header bars, etc. 
  • Secondary Color: affects the color of a category when it’s selected, the cart button, positive / selected buttons.
  • Accent Color: The color of header text, alerts, cart totals, and item names on the screen.
  • Button Text Color: Affects the color of the buttons' text in the kiosk and mobile app. 
  • Welcome Page Message: Customizes the message displayed when opening an online order.
  • Welcome Page Image:  Customizes the image displayed when opening an online order.

You can change these settings in two ways:

  1. Manually, by clicking on the colored tile in each box and selecting the color you want from the pallet, or
  2. By entering the appropriate hex code for the color in the text box. This is the preferred method, as it ensures consistency across all locations. 

Once you have made the changes that you want to apply to your online ordering portal, select save.

Establish Promotion Limits

You can limit the number of promotions displayed at all of a company's kiosk pumps through the company level of the GRUBBRR Portal. To make changes to these settings :

  1. Sign in to the dover.grubbrr.com Portal at the company level
  2. In the left sidebar, select Configure
  3. Select Promotion Settings

This will open the Details View page. In the text box on this page, you can define a numerical limit for the maximum number of promotions a location can enable at any time, to control how 'busy' the kiosk display is while a customer is using the system. 

Location Level

Add a Pump Device

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. In the left sidebar, select Configure
  3. Select Device Settings from the dropdown menu
  4. Select ‘Add New’ at the top right corner of the Device Settings page. 
  5. Configure the following settings for the pump kiosk: 
    • Name: An easily recognizable device name. 
    • APP ID: Entered manually by GRUBBRR support
    • Module Name: Kiosk
    • Device Type: Android
    • Revenue Center: Do not edit
    • Scanner: Do not edit
    • Pump ID: Give the pump a short, easily recognized number for your system. 
    • IP Address: Will be automatically populated during the configuration process.
    • Mac Address: Will be automatically populated during the configuration process.

Add A KDS

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. In the left sidebar, select Configure
  3. Select KDS Master from the dropdown menu
  4. At the top right of the page, select Add new
  5. Enter identifying information into the top section of the page:
    • Name: an easily recognizable device name
    • Device ID: This is the "App ID" number listed on the sign-in screen of your KDS device. 
    • KDS Type: There are three options here: 
      • Expediter KDS: Allows the KDS to act as a "hub" and complete orders for all other KDSs on the network. If you are only using a single KDS device, use this setting.
      • Regular KDS: Has no special properties
      • Prep KDS: 
    • Number of Rows: Determines how many lines of tickets the KDS will display. By default, GRUBBRR recommends two rows. 
    • KDS IP Address: This is the IP address listed on the sign-in screen of your KDS device.
    • KDS Printer: Assigns the KDS to a printer on your network. 
    • Display Mode: Configure whether the KDS will display in Light mode or Dark Mode
    • Live Device: activates the device in your GRUBBRR ecosystem. 
  6. In the bottom half of the screen, configure the following Settings: 
    • Print Receipt: 
      • Select Print Before to print receipts when an order is received
      • Select Print on Completion to print receipts after an order has been marked complete in the KDS
    • Additional Settings:
      • Send SMS should be off
      • Show Customer Name should be on
      • Show Modifier Group Name should be on
      • Only Allow to Complete Paid Order should be off
      • Show Order Items as Tickets should be off
      • Update OPB should be off
      • Show Server Name should be off
      • Hide Action Buttons should be off
      • Device Settings Lockdown should be off
    • Print Mode: 
      • Select Standard Print
    • Negative Modifier Preference
      • Show Negative Modifiers should be off
      • Print Modifier Ingredient should be on
      • Show Default Modifiers should be on
      • Map to Specific Devices should be off
      • Show Category Name should be on
      • Minimize Sidebar should be off
      • Show Car Information should be off
      • Auto Scroll to New Orders should be on
      • Use Bump Bar should be on
      • Show Delay Order Button should be on
      • Use Highlight for Color should be off
    • Send Notification to Mobile App should be off.
  7. After your device has been fully configured, select 'Save'

Map a KDS to a Kitchen

If you have not set your KDS as an expediter, you will need to map it to a specific kitchen. To do so:

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. Select Configure in the left sidebar
  3. Select Kitchen Settings
  4. On the Kitchen List Page, you have two options:
    1. If you have already set up a kitchen in the GRUBBRR Portal, you can click the blue edit button for that kitchen in the list, otherwise
    2. Click Add New at the top right of the page. 
  5. This will display a pop-up window, where you will fill in the following fields:
     
    1. The Kitchen Name- a short, easily recognizable name to identify your kitchen
    2. The Kitchen Name in Alt Lang- Leave this blank
    3. Kitchen Printer: Select the appropriate printer from the dropdown list
    4. KDS: Select your newly configured KDS from the dropdown list. 
  6. Click save to apply your changes. 

Configure Promotions

You can add, delete, enable/disable, and modify promotions for items without modifiers at the location level. To edit promotions, follow these steps. 

Add a Promotion

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. In the left sidebar, select Promotions
  3. Select Promotions from the dropdown
  4. At the top right of the Promotions list, select Add new
  5. On the Create promotion page:
    • Select the item that the promotion applies to from the dropdown menu labeled Item
      • Remember- at this time, our integration only supports promotions for items without modifiers
    • You can write a brief 'Description' of the promotion for your own records. 
    • At this time, Dover x GRUBBRR only supports 'Percentage off' promotions. In the ‘Percentage off’ field, assign a numerical value for the percentage that the item will be discounted in the customer's order. 
    • 'Image': Upload a saved file from your computer to the Portal to be displayed in the rotating Promotions banner on the Kiosk Pump.
    • 'Quantity': Defines the number of items included in the promotion. 
    • 'Status': Toggle the promotion on or off for this location. 

Activating and Deactivating Promotions

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. In the left sidebar, select Promotions
  3. Select Promotions from the dropdown
  4. You can click the blue/gray toggle button in the column labeled Status. If the button is blue, the promotion is active on the pump kiosks in this location. If the button is gray, it means that the promotion is inactive. 
  5. Select 'Save Display Order' at the bottom of the screen when you have enabled/disabled your promotions.

Changing Promotion Display Order

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. In the left sidebar, select Promotions
  3. Select Promotions from the dropdown
  4. From the Promotions Table: 
    • Click and hold the six dots in the left-most column of the table
    • Drag and drop the promotion into the display order you would like to see on your pump kiosk.
  5. Select 'Save Display Order' at the bottom of the page to apply your changes to the kiosk. 

Upload a Screensaver:

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. In the left sidebar, select ‘Configure’
  3. Select ‘Screensavers’
  4. On the ‘Screen Saver List’ page, select ‘Add New’ at the top right corner of the table. 
  5. This will open the Create Screen Saver page. You can configure the settings on this page as follows: 
    • Name: Give the screensaver a clear, easily recognizable name. 
    • Slider Text: Leave blank
    • Description: An internal description of the content in the screen saver
    • Display Order: If the device cycles through multiple screensavers, you can configure where your new screensaver would appear in the list. 
    • Click on the dropdown for Image/Video to select your format
      • If you are using an Image as your screensaver: 
        • You will be prompted to upload an image from your computer, which 
          • Must be at least 1080x1228 pixels
          • Must be no larger than 1 mb in size
        • You will also receive a secondary prompt, asking you to assign a duration (in seconds) for your screensaver to stay on the screen. 
      • If you are using a video as your screensaver: 
        • You will be prompted to upload a video file from your computer, which:
        • Must be no larger than 3 mb
    • Click ‘Save’

Customizing Headers on Your Kiosk

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. In the left sidebar, select ‘Configure’
  3. Select ‘General Settings’
  4. Select ‘Kiosk’ at the top of the General Settings window. 

This will open a page with a variety of headers that you can now customize for kiosks at this location. A full list of the available options is as follows: 

  • Contact Information Popup
    • Header: Defines the text that appears at the top of the Customer Phone # popup when a kiosk user starts their order. 
      • The default is “Welcome to <store name>”
    • Label: Defines the text above the phone # input ui
      • The default is “Continue Ordering on phone”
  • Thank You Screen
    • Header: Defines the text that shows on the top of the order confirmation screen
      • The default is “THANK YOU!”
    • Sub-Header: Defines the message that appears immediately after the Header
      • The default is “Your order has been placed.” 
    • Image: Allows you to define a custom image that displays underneath the Header and Sub-Header on the popup. 
    • Footer: Allows you to customize the text that appears under the image on the popup. NOTE: GRUBBRR recommends using this space to remind customers to complete their transaction inside.
      • The default is “Please visit the story to finish payment & collect your food”
  • Header Instructions:
    • This section gives you a series of text boxes that you can use to customize the rotating instructions/customer tips that cycle through the header while a customer completes their order. By default, there are three headers activated; however, you can add or remove as many of these as you like. NOTE: Even if you select only a single header, the cycling animation will still play to increase the visibility of these messages. 

Menu Scheduling

Dover users can schedule menu items and categories for display on the DX Market device. The menu scheduling process can be found here.

General Use Features

Identifying Order Locations in GRUBBRR Reports

The GRUBBRR Portal’s reporting feature has been enhanced with the ability to track whether orders were completed through the Pump Kiosk or the Online portal. To find this information: 

  1. Sign in to the dover.grubbrr.com Portal at the Location level
  2. On the Dashboard, scroll down to the table labeled Orders
  3. Click on any of the activity bars to pull up a list of orders for that block of time. 

This displays a pop-up window with detailed order reports during the hour you selected. This window lists the following information: 

  • Date & Time of Order
  • The Order Number within the system
  • A timestamp for the 3rd party order ID
  • Whether the customer signed in as a Guest or a Returning User
  • The order Type (takeout, dine-in)
  • The Order’s Status
  • The Payment tender for the order
    • Plus, the Card Type if a credit card was used
  • The Transaction ID (if available)
  • The Module Name: This identifies if the order was completed using the online portal or the pump kiosk. 
  • Device Name, if the order was completed on a kiosk
  • The Subtotal of the order
  • Any Discounts applied
  • Any additional fees that may have been applied to the order, including:
    • Tax
    • Non-Cash Fees
    • Tip
    • Auto-Gratuity charges
    • Any discrepancies or refunds
  • The Grand Total charged for the order. 

Related articles