Mobile App Other Functions

This article describes advanced Mobile App configuration, the complete widget catalog shown in the Mobile App editor, link behavior, shared widgets, targeting, and optional channel settings.

Complete the baseline configuration in Mobile App Set Up before using these functions.

Widget Configuration Model

The Homepage, Profile, shared header and footer areas, and other configurable contexts use the same widget types. The exact fields displayed in the editor depend on the selected type.

Common Widget Settings

Most widgets include the following settings:

Type-specific settings can include descriptions, media, buttons, links, height, corners, margins, colors, selected wallets, selected content, and layout controls.

Visibility

Use None to store a work-in-progress widget without displaying it in the app.

Segment Targeting

To restrict a widget by segment:

1. Expand the widget.
2. Under Segments, click Add new.
3. Select the required segment.
4. Add additional segments if required.
5. Save and test with members inside and outside the selected segments.

If no segment is selected, the widget is not restricted by segment. Visibility rules still apply.

Link Configuration

Content links serve to incorporate additional links into various content types such as News Articles, Deals, and certain types of Widgets (e.g., Static Widget, Links Widget, etc.). There are three distinct types of Content Links available, depending on the content being edited. The available types may differ depending on the content that is being edited.

Content Link Type

Link Type

Link to an App Section

1. Select Direct link.
2. Select App link.
3. Choose a destination from App link.
4. Save and test the widget.

For example, select Coupon to open the coupon section.

Link to a Specific Content Item

1. Select the supported item-level link configuration.
2. Choose the app content type.
3. Use the additional Item field to select the exact item.
4. Save and test with a member who can access the item.

For example, a widget can open the coupon section or a specific coupon, depending on the selected configuration.

Open a Website

1. Select Direct link.

2. Select Web link.

3. Select Web Link Type:

   Web Link Type	Behavior
   In-app	Opens the page in the app's embedded browser.
   In-App (Tab)	Opens the page in an in-app tab.
   In browser	Opens the page in the device's external browser.

4. Enter a complete Link url, including https://.

5. Enable Block screenshot if screenshots of the embedded page must be blocked and the selected flow supports this control.

6. Use Close Browser on specific URL if the embedded browser must close after reaching a defined callback or completion URL.

7. Save and test the complete flow.

Widget Reference

The following widget types are available in the Mobile App editor shown in the source configuration.

The types available to a specific project can depend on project configuration.

Content and Navigation Widgets

Static

Use Static for a configurable content tile or banner.

Supported controls shown in the editor include:

• title and description
• image displayed as an icon, background, or no image
• optional link and button
• margins and centered text
• square or rounded corners
• widget height
• background, title, button, and text colors

The editor provides Tiny, Small, Medium, and Large height options where available. When an image is removed, the upload area displays the recommended dimensions for the selected size. Follow the dimensions shown for the current widget size.

The demonstrated upload field accepts JPG, PNG, or MP4 files up to 5 MB and shows the recommended dimensions in the editor. Requirements can differ between widget fields, so always use the hint displayed next to the active upload control.

Button and Button Two column

Use Button for a single priority action. Configure the button text, destination, background, color, corners, and margins displayed by the editor.

Use Button Two column when two actions must appear side by side. Configure and test both destinations independently.

Feed

Use Feed to display a horizontal, swipeable collection. The feed can be mapped to supported content such as:

• coupons
• rewards
• leaflets
• products

Select the content source and configure the title, item display, link behavior, and appearance offered by the editor. Test with enough published content to verify empty, single-item, and multi-item states.

Link Icons, Link Pillboxes, and Links

These widgets present a group of destinations in different styles:

• Link icons uses uploaded or configured icons.
• Link pillboxes uses pill-shaped controls.
• Links uses text-only links.

For each item:

1. Click the add control.
2. Enter the customer-facing label.
3. Configure an app, web, or supported system destination.
4. Add the icon where required.
5. Repeat for each link.
6. Reorder and test all items.

Loyalty and Member Widgets

Card

The Card widget displays a member card summary. The demonstrated editor provides controls for:

• Show profile picture
• Show tier badge
• Show display name
• Show points balance
• Use tier background
• Front background and Back background
• background mode such as solid, image, or transparent
• corners and margins

Selecting the card in the app opens the supported card interaction or detail flow configured for the project.

Points

The Points widget displays the balance from a selected wallet.

1. Select Points as the widget type.
2. Select the required wallet under Wallets.
3. Configure the title and appearance.
4. Test with a member who has a known balance in the selected wallet.

Profile

The Profile widget displays supported member details such as:

• name
• email
• registration phone number

Selecting the widget opens the profile area, including My Profile where available.

Tier

The Tier widget displays details of the member's current tier. Test it with members in different tiers and with a member who has no tier if that state is possible in the project.

Contest Widgets

Contest

The Contest widget displays a selected contest.

1. Select the contest template or supported contest configuration.
2. Select the exact contest.
3. Configure the layout, including Steps in row where available.
4. Review the progress display in the preview.
5. Test with members at different contest-progress states.

Contest Notification

The Contest notification widget displays a compact notification only when the member has an unused contest token.

If the widget is configured but not visible, test with a member who has an unused token before treating the behavior as an error.

Layout Widgets

Line

Use Line to separate content areas. Configure the line's size and styling in the fields shown by the editor. The demonstrated configuration supports values ranging from a narrow divider to a much larger block, so verify the visual result in the preview.

Spacer

Use Spacer to create an intentional gap between two widgets. Prefer a spacer over empty text or transparent image workarounds.

Side-by-side images and Static Two Column

Use these types when content must be split into left and right areas:

• Side-by-side images displays two images next to each other.
• Static Two Column provides two static content columns with the type-specific controls shown in the editor.

Static Text and Static Counter

• Static Text displays a plain text block with supported font-size, color, background, title, and vertical-margin controls.
• Static Counter uses the counter-specific static layout and spacing controls shown by the editor.

Header and Footer Widgets

Global Header

Configure a shared header in SETTINGS → HEADER WIDGETS. The setting Widget for header is used on every Mobile App screen unless it is overridden.

The Header widget supports:

• solid, full-width-image, or transparent background
• logo placement or no logo
• optional greeting
• optional personalized customer information supported by the project
• an ordered list of links
• visibility and segment targeting

To display a header only on one screen, do not configure the global header. Add a Header widget to that screen instead.

Advanced Embedded-Browser Functions

Custom JavaScript

SETTINGS → EMBED BROWSER → Custom Javascript executes JavaScript in the embedded WebView context. The setting can be used for advanced requirements such as bridge listeners, DOM manipulation, or overriding global variables.

Do not place API keys, access tokens, passwords, or other secrets in client-side JavaScript.

Optional Channel Settings

General Behavior

The GENERAL section also exposes optional controls. Use the description displayed below each setting as the source of truth for the current channel version.

Test the complete customer journey after changing any login, registration, profile, GPS, coupon, or card-pair control.

Coupon Appearance

Use SETTINGS → COUPON → Background of left side of coupon to configure the supported coupon-side background color.

Mobile Wallet Buttons

The MOBILE WALLETS section can include:

Configure and publish the corresponding wallet channels before enabling these buttons.

Profile Appearance

The PROFILE section includes:

Screenshot Blocker

The SCREENSHOT BLOCKER section includes:

Test screenshot behavior on every supported platform and operating-system version used by the project.

Venue Behavior

The VENUE section includes:

The Favorite venue widget requires the corresponding venue functionality to be enabled and is intended for registered members.

Testing Advanced Functions

For each advanced function:

1. Save the configuration as a draft.
2. Verify it in the editor preview.
3. Publish the relevant screen or settings through the project's publication workflow.
4. Test on supported physical devices.
5. Test anonymous and logged-in states.
6. Test members inside and outside selected segments.
7. Test empty, single-item, and multi-item content states where applicable.
8. Test every internal, item-detail, web, and system destination.
9. Test failure and return behavior for embedded websites.
10. Confirm that member-specific widgets use the correct wallet, contest, tier, profile, and venue data.