Most screens in your app share the same handful of settings: a title for the navigation bar, toggles for the header, search control, and back button, a background color, and the message shown when there’s nothing to display. Unlike the app-wide styling controls, these belong to one screen at a time — you set them on the screen (button) you’re editing, so two screens of the same type can look and behave completely differently.

This guide walks you through each option: where to find it, and what it changes in the app. They all live together on the screen you’re editing, so you can set them in a single pass.

Goal

Style a single screen in your app — set its title, decide whether its header, search bar, and back button appear, choose its background color, and write the empty-state (“no records”) message — then preview the result.

Prerequisites

• You’re a WordPress admin who can manage options on the site.
• MAM Main is installed and active.
• You already have at least one screen (button) to edit. If you don’t, add one first — see Add a new screen (button) to your app.
• You can load your app in the WP Mobile App Manager Previewer to check your changes. (See Preview your app on a device.)

These are per-screen options — they apply only to the one screen you’re editing, not to every screen of that type. Want the change to apply app-wide instead? Look for the matching option in App Settings.

Where these settings live

You’ll find these options on the individual screen (button) itself, not on the global App Settings page.

1. In the WordPress admin, go to Mobile App Manager → App Setup.
2. Choose the placement that holds the screen — the Home Page tab or the Left Menu tab.
3. Find the button for the screen you want to style and open its settings.

Which options you actually see depends on the screen’s content type — a Map screen offers a search toggle, a listing screen offers a header toggle and an empty-state message, and so on. What’s covered here are the common ones, the options you’ll find on most screen types. Once you’ve made your changes, save with the App Setup save control; they reach the app on its next content refresh.

Steps

1. Set the screen title

Find Screen Title (a text field).

This sets the title shown in the navigation bar at the top of the screen. Leave it blank and the screen keeps its default title for that screen type; type a value and it overrides that default. Use this when you want the navigation bar to read something friendlier or shorter.

2. Show or hide the header

Find Hide List Table Header? (a Yes/No toggle).

Turn this on and the section header row on a list / table view disappears, leaving a cleaner list that goes straight to the rows. Leave it off (the default) to keep the section header.

This refers to the list’s own section header, not the navigation bar at the top of the screen — that one’s controlled by the title and back-button options.

3. Show or hide the search control

Depending on the screen type, you’ll see one of these Yes/No toggles:

• Hide search? — hides the search control on a map screen.
• Hide search on Listings? — hides the search bar on a listings screen.

Turn on the toggle that matches your screen type to remove search from that screen. Do this when there’s not enough content to make search worth having, or when a search bar would only get in the way. Leave it off to let people search.

4. Show or hide the back button

Find Hide Back Button? (a Yes/No toggle).

Turn this on and the back button in the navigation bar disappears from this screen. Use it for top-level screens — the ones a user reaches directly from a tab or the home grid — where there’s nowhere to go “back” to. Leave it off on screens a user drills into, so they can find their way back the way they came.

5. Set the background color

Find the background-color picker (a color picker). What it’s called depends on the screen type — Listing View Background color on a list screen, Background color on a calendar. Default #ffffff (white).

This sets the color behind the screen’s content — the list or calendar itself. On a list screen, that’s the listing view’s background. Click the swatch and pick a color that fits your brand and reads well behind your content.

A few screen types have their own, more specific background option: a form screen uses Form background color, and a single-listing detail screen uses Listing Detail View Background color. Both also default to #ffffff — set whichever one matches the screen you’re editing.

6. Write the empty-state message

Find No records message (a text field).

This is the message people see when the screen has no records or results to display — something like “No events found.” Write something specific to the screen, so an empty result reads as expected rather than like something broke.

Pair it with No records image (an image picker) to replace the default empty-list placeholder with an image of your choosing. Together, they make the empty state feel intentional and on-brand.

7. Save and preview

Save your changes in App Setup, then open the WP Mobile App Manager Previewer and load your app to check:

• The navigation bar shows your title (or the default if you left it blank).
• The header, search control, and back button appear (or don’t) as you set them.
• The background color reads well behind the content.
• An empty screen shows your message (and image, if you set one).

Changes reach the app on its next content refresh, so give the previewer a moment (or trigger a refresh) after saving.

Notes and gotchas

• Per-screen, not app-wide. Each of these options applies only to the screen you’re editing. The same option on another screen works independently — set it there too if you want a matching look.
• Which options you see depends on the content type. Not every screen type exposes every option above. A map screen has a search toggle; a list screen has a header toggle and an empty-state message. Don’t see an option? The current screen type just doesn’t use it.
• “Header” has two meanings. Hide List Table Header? controls the list’s section header row. The bar at the very top of the screen is the navigation bar instead, controlled by the title and the back-button toggle. Easy to mix the two up.
• The defaults are sensible. Change nothing, and the screen keeps its default title, shows its header, search, and back button where applicable, and uses a white background. You only need to touch what you actually want to change.

Related

• Add a new screen (button) to your app — create the screen these options apply to.
• Style your listings: colors, stars, favorites, and row lines — app-wide styling for list screens.
• Preview your app on a device — load the app in the WP Mobile App Manager Previewer to see these changes in context.
• App Setting Reference: screen_title, hide_header, hide_search, listings_hide_search, hide_back_button, screen_background_color, background_color, listing_detail_background_color, no_content_text, no_content_image.

What’s next

Once a screen looks right, repeat the relevant options on your other screens, and move on to the app-wide controls in App Settings — brand colors, the tab bar, and the login screen — that frame every screen at once.