Your app’s name is the text that appears under the icon on a phone’s home screen and in the app stores. Your app’s icon background is the solid color that fills in behind your icon image. You’ll set both on the Publish Your App page — not on the App Setup page where you build screens and menus.

Here’s where to find each setting, what the icon background color is really doing behind the scenes, and how to sidestep the most common app-store rejection: a transparent icon.

Before you start

• You are a WordPress administrator (these fields require the manage_options capability).
• You have an app icon image ready, or one already uploaded. The icon should be a 1024 × 1024 PNG. MAM resizes it automatically for every device, so you only upload it once.
• You know the name you want shown on the device. Keep it short — long names get truncated under the home-screen icon.

The app name and icon live in your publishing configuration, so nothing here is locked in — change either one any time before you submit a build, or again on a future update.

Where these settings live

Everything below lives on one page. Open the WordPress admin menu and go to Publish Your App (the page your app submission is built from). The fields are grouped into panels:

The App Name and App Icon panels look separate, but one save on the Publish Your App page captures both.

Set the app name

1. Go to Publish Your App.
2. In the App Store Information panel, find the App Name field.
3. Enter the name exactly as you want it to appear on the device and in the stores.
4. Save the page.

Behind the scenes, the value is stored in the local-app-ios-app-name option and reused for both the iOS and Android builds. It feeds straight into the payload — the bundle of data sent to the build pipeline — so whatever you type here is exactly what gets submitted.

The App Description field lives in the same panel but does a different job: it’s the listing text for both the Apple App Store and Google Play. It won’t touch your home-screen label.

Set the app icon and its background color

1. In the App Icon panel, click the image picker (labeled Click to select app icon when empty) and choose your 1024 × 1024 PNG from the media library.
2. Below the icon, use the Background Color picker to choose the color that fills behind the icon. It defaults to white (#ffffff).
3. Save the page.

Under the hood, the icon image is stored in local-app-images-app-icon and the background color in local-app-app-icon-bg.

What the background color actually does

It’s not just a cosmetic swatch — MAM puts that color to work in two places:

• It flattens your icon so Apple will accept it. Apple rejects App Store icons that carry any transparency or alpha channel (error 90717). So every time you change the icon image or the background color, MAM composites your PNG onto the color you picked and saves an opaque version for submission. Any transparent corners or edges in your original icon end up filled with this background color.
• It backs the Android icon sizes. When your icon gets resized for Android, the same color fills in behind it.

One thing it doesn’t touch: the launch (splash) screen. That has its own Background Color setting over in the Launch Screen panel — set that one separately if you want the splash background to match your icon.

Given all that, pick a background that actually looks good behind your icon — usually white, or whatever color the icon’s own background already uses, so the seam disappears.

Running a full-bleed square icon with no transparency? Then the background color barely shows on the icon itself — but it still shapes the Android sizes, so it’s not one you can skip. Leaving it at white is a safe bet either way.

Save and verify

A quick check after saving is enough to know it worked:

• Re-open Publish Your App and confirm the App Name field shows your text and the App Icon panel shows your image with the correct Background Color swatch.
• Don’t worry about flattening the PNG yourself — changing the icon or its background color tells MAM to regenerate the flattened, opaque icon automatically.
• Whatever you’ve set here goes out the next time you send a publish request from this same page. There’s no separate “apply” step to hunt for.

Troubleshooting

My icon was rejected for transparency / error 90717.
That’s the alpha-channel rejection — easy to fix. Set a Background Color (white is the safe default) and re-save the page. Saving with a changed icon or background re-flattens the PNG onto a solid color, so the file you submit next has no transparency left in it.

The name on the phone is cut off.
That’s just the home screen truncating a long name. Shorten the App Name to a few characters that’ll read cleanly under the icon.

I changed the icon but the launch screen still looks old.
Launch screens regenerate when the icon changes — or when the launch screen’s own background color does. Re-save the page after changing the icon, and double-check the Background Color in the Launch Screen panel: that’s the color launch screens are actually built on, not the icon background color.

I don’t see the Publish Your App page or the fields are disabled.
That page needs administrator (manage_options) access. A few identifier fields on it (bundle IDs, version and build numbers) are system-managed and shown read-only just for reference — those aren’t the app name or icon fields, and it’s normal to see them greyed out.

Related settings (reference)

These are the underlying options behind the fields above. Admins do not edit them directly — they are listed so the values you set on the page can be traced.

These option keys are part of MAM’s frozen publishing contract. Do not rename or hand-edit them; set the values through the Publish Your App page.

Verification

This article was last verified against:

• mam-main/includes/publish-app/app-submit.php — App Store Information and App Icon panels (render_app_store_info(), render_app_icon()), save flow, and the alpha-flatten on icon/background change.
• mam-main/includes/publish-app/mam-app-publishing.php — local_app_save_publish_app_settings() option writes.
• mam-main/includes/app-settings/mam-image-manager.php — flatten_png_alpha(), generate_launch_screen(), and gd_resize() background-color usage.

Re-verify whenever the Publish Your App panel layout changes, the local-app-ios-app-name / local-app-app-icon-bg / local-app-images-app-icon option keys change, or the icon-flattening / launch-screen generation behavior changes.