Goal
This shows you how to add a horizontally scrolling Featured listings row to your app’s Home screen and make it your own: turn it on, give it a title (or hide the title), choose how tall it sits, and decide how the featured banner image behaves.
When you’re done, a Featured row will sit near the top of the Home screen, scroll sideways through your featured items, and show the title and height you picked.
Two related rows. Your Home screen can show both a Featured listings row and a separate Recent listings row — this article sticks to the Featured row. The toggles look alike, so double-check the setting label before you save.
Prerequisites
- MAM Suite installed with MAM Main active.
- A WordPress admin account with access to the Mobile App Manager admin area.
- A Home screen that is already reachable in the app (a Home tab-bar button exists). If not, set that up first — see Related.
- Some content marked as featured, so the row has something to display. If your Featured row comes up empty after you enable it, that means no items are currently flagged as featured.
Where these settings live
You’ll find the Featured row settings in the app settings, under the Home Screen group:
| Setting (admin label) | Variable | Type | What it does |
|---|---|---|---|
| Show featured listings on home screen | show_featured_listings |
Yes / No | Turns the Featured row on or off. |
| Featured Listings Title | featured_listings_title |
Text | The heading shown above the Featured row. |
| Hide Featured Listings Title | hide_featured_listings_title |
Yes / No | When on, hides the row’s title entirely. |
| Featured Listings Alternate Title | featured_listings_alt_title |
Text | An alternate label used in place of the main title in certain contexts. |
| Featured section title | main_featured_header_title |
Text | The section header title for the Featured area on the Home screen. |
| Featured Listings Height | home_featured_listings_height |
Dropdown (Never, 1–5) | How tall the Featured row is, as a size step rather than a raw pixel value. |
| Scrolling Featured Image | scrolling_featured_image |
Yes / No | When on, the featured banner image scrolls/animates instead of sitting static. Lives under the Listings group, not Home Screen. |
Settings can save per role. If your app shows different content to different user roles, set the role selector before you start editing, then repeat for each role. Leave no specific role chosen and the value becomes the shared default — the one everyone gets.
Steps
-
Open the app settings. Head into the Mobile App Manager admin area and open your app’s settings.
-
Pick a role (optional). Running different Home screens per user role? Choose that role first. Otherwise, leave it on the shared default so your change reaches everyone.
-
Turn the Featured row on. In the Home Screen group, set Show featured listings on home screen to Yes.
-
Give the row a title. Type the heading you want above the row into Featured Listings Title — something like
FeaturedorEditor's Picks. There’s also a separate Featured section title field, which sets the section header for the Featured area on the Home screen; if your layout uses a section header, set that one too so the two titles read consistently. -
Or hide the title. Prefer no heading at all? Leave the title field blank, or set Hide Featured Listings Title to Yes — either way, the hide setting wins over whatever text sits in the title field.
-
Set the row height. Choose a value from the Featured Listings Height dropdown: Never, or a step from 1 through 5. Think of these as size steps, not pixel measurements — the higher the number, the taller the row. A good starting point is the middle of the range; preview, then adjust up or down until your banner images show cleanly at the smallest height that works.
-
Choose how the banner image behaves. Head to the Listings group and set Scrolling Featured Image to Yes if you’d like the banner image to scroll and animate, or No to keep it static.
-
Save. Save the settings — your values are written for the role you selected.
Verify it
- Open the app (or your preview/dev build) and go to the Home tab.
- Confirm the Featured listings row appears, scrolls sideways, and shows your featured items.
- Confirm the title reads what you typed (or is absent if you chose to hide it).
- Confirm the row height looks right — bump Featured Listings Height up or down a step if items are clipped or the row feels too tall.
- If you set per-role values, sign in as a user with that role to confirm they see the right version.
Changes may be cached. If an update doesn’t show up right away on a device, that’s because app data is served through a cached pipeline — give it a moment to refresh, or run your normal app-data refresh step.
Troubleshooting
- The Featured row does not appear. Check that Show featured listings on home screen is set to Yes for the role you’re testing, and that the Home screen itself is set up.
- The row appears but is empty. Nothing is flagged as featured yet. Mark some content as featured and the row will have something to scroll through.
- The title shows when you wanted it hidden (or vice versa). Check Hide Featured Listings Title — set to Yes, it suppresses the title no matter what text is there. Set to No, your Featured Listings Title (or section title) takes over.
- The row is too short or too tall. Nudge Featured Listings Height one step at a time and preview again — remember, it’s a size step (1–5), not a pixel value.
- Different users see different results. You probably saved to one role but not another. Switch the role selector and repeat for each role you support.
Related
- Configure your app’s Home screen — build the full stack of Home-screen content blocks the Featured row sits within.
- Style your listings — colors, stars, favorites, and how listing rows look across the app.
- Set up the bottom tab bar — add the Home button that navigates to this screen.
- Settings cascade overview — how per-role and shared defaults resolve.
What’s next
Once the Featured row looks right, round out the Home screen with the Recent listings row and your category sections — then preview the whole Home tab top to bottom before you publish.
