Goal

Here’s what greets someone the moment they open your app: the Home Screen Content stack — an ordered list of content blocks like labels, images, search bars, and category scrollers — plus the Home Screen Categories that feed the category rows on that same screen.

By the end, your Home tab will render your chosen blocks top to bottom in exactly the order you arrange them, with each category row pulling from the taxonomies and terms you pick.

Two different things share the name “Home.” This article builds the Home Screen itself — the stack of content that fills the screen. That’s separate from the Home tab-bar button, the shortcut in the bottom tab bar that takes you to this screen. Seeing a Home icon but no content? You’ve got the tab-bar button in place but haven’t built the stack yet. See Configure the tab bar for that button.

Prerequisites

• MAM Suite installed with MAM Main active.
• A WordPress admin account with access to the Mobile App Manager admin area.
• A Home tab-bar button already placed in your app’s tab bar (so the screen is reachable). If you have not added one yet, set up the tab bar first — see Related.
• If you plan to use category rows: the relevant content already exists in WordPress under a public taxonomy (categories, tags, or a custom taxonomy) with terms assigned to posts/listings.

Where these settings live

These settings live under the Home tab-bar button type (internally the home_button content type), inside a Home Screen Content group in the app settings UI. You’ll work with two builders:

Both builders save per role. Showing different content to different user roles? Set the role selector before you start editing, then repeat the process for each role. Leave no specific role chosen, and your settings save to the shared mam-all role that applies to everyone.

Steps — build the content stack

1. Open the Home Screen settings. In the Mobile App Manager admin area, open your app’s settings and find the Home Screen Content group for the Home button. You’ll see the stack builder: a list of any sections already added, with an Add control waiting at the bottom.

2. Pick a role (optional). Building different Home screens for different user roles? Choose the role first. Otherwise, leave it on the default to configure the Home screen everyone sees.

3. Add your first section. Choose a section type from the Add section dropdown and click Add — a new section block appears in the list. The available section types include, among others:

   • Label — a line of text with justification, font size, weight, and color.
   • Image — an uploaded image with a width percentage and justification (the app preserves the image’s aspect ratio).
   • Spacer — vertical whitespace, sized in pixels or as a percent of screen height.
   • Category Filter Bar — a row of category chips (single-row, multi-row, or off).
   • Category Scroller — a horizontally scrolling row of categories.
   • Listing Search / Listing Table / Map / Collection View — different ways to present your listings.
   • Geofilters and Radius Selector — location-aware filtering controls.
   • Bottom Tab Bar — switches the Home screen into tabbed mode.
   • Plus standard options such as Special Offers, Tag Cloud, and Tagged Navigation (whose content is supplied by the matching plugin), and sections registered by other plugins (such as Storefront) that appear in the dropdown only when the plugin that supplies them is active.

   Your dropdown may show more or fewer options than the examples above — the exact list depends on which MAM Suite plugins are active on your site.

4. Configure the section. Fill in its fields. A Label, for example, lets you type the text and set justification, font style, size, and color; an Image lets you upload the image and set its width and justification; a Spacer lets you set its height and height type.

5. Repeat for each block. Add as many sections as you need — the on-screen order, top to bottom, is exactly how the app renders them.

6. Reorder and remove. Drag a section by its sort handle (the arrow control) to move it up or down, and click the trash icon on a section to delete it. A few section types — filter bars, search, geofilters, and tag clouds — get pinned to the top of the screen automatically, no matter where they sit in the list; they always stay above the scrollable content.

7. Save. Once you save, your stack is written for the selected role.

Steps — set up category rows

Added a category-driven section — Category Scroller, Category Filter Bar, or similar? Populate the Home Screen Categories builder next, so those sections actually have something to show.

1. Open the Home Screen Categories builder. It sits alongside the content stack in the same Home Screen settings group, laid out as a table of rows.

2. Add a category row. Click Add New, and a new row appears with four columns:

   Column	Meaning
   Taxonomy	Which public taxonomy to pull from (e.g. category, post tag, or a custom taxonomy).
   Term	The specific term within that taxonomy. The Term dropdown fills in after you pick a taxonomy.
   Sort	The field the items in that row are sorted by.
   Order	Sort direction — ASC or DESC.

3. Choose a taxonomy, then a term. Pick the taxonomy first — the Term dropdown then fills in with the terms available inside it. Select the term whose content you want in that row.

4. Set sort and order. Enter the sort field, then choose ascending or descending.

5. Add more rows as needed — one per category row you want on the Home screen. The order you set here is the order they’ll appear.

6. Save. This writes the category rows for the selected role.

Verify it

1. Open the app (or your app preview/dev build) and go to the Home tab.
2. Confirm the blocks render in the order you arranged them, and that category sections show the terms you selected.
3. If a category section is empty, check that the chosen term actually has published content assigned to it, and that the taxonomy is public.
4. If you configured per-role Home screens, 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 on a device right away, that’s normal — your app data flows through a cached pipeline, so give it a moment to refresh, or trigger your usual app-data refresh step.

Troubleshooting

• Home tab shows a blank screen. The tab-bar button is there, but the content stack underneath it is empty. Add at least one section in Home Screen Content and save.
• Category section is empty. Either the term has no published, app-visible content, or the wrong taxonomy/term got selected. Re-check the row’s Taxonomy and Term.
• A section type you expected is missing from the Add dropdown. That section comes from a plugin that isn’t active right now. Activate the plugin that supplies it, then reload the settings page.
• Different users see the wrong Home screen. You probably saved to one role and skipped another. Switch the role selector and configure each role you support (or use the shared default for everyone).

Related

• Configure the tab bar — add or edit the Home button that navigates to this screen.
• Content class: Home for tab bar — reference for the Home tab-bar button itself.
• Settings cascade overview — how per-role and shared (mam-all) settings resolve.
• Build an app end to end — where Home-screen setup fits in the larger build.

What’s next

Once your Home screen looks right, round out the rest of the tab bar and left menu so people can reach your other content — then you’re ready to move on to publishing your app.