Menu
Your Apple ID is the account you use for all Apple services.
App Icon
Every app needs a beautiful and memorable icon that attracts attention in the App Store and stands out on the Home screen. Your icon is the first opportunity to communicate, at a glance, your app’s purpose. It also appears throughout the system, such as in Settings and search results.
Embrace simplicity. Find a single element that captures the essence of your app and express that element in a simple, unique shape. Add details cautiously. If an icon’s content or shape is overly complex, the details can be hard to discern, especially at smaller sizes.
Provide a single focus point. Design an icon with a single, centered point that immediately captures attention and clearly identifies your app.
Design a recognizable icon. People shouldn’t have to analyze the icon to figure out what it represents. For example, the Mail app icon uses an envelope, which is universally associated with mail. Take time to design a beautiful and engaging abstract icon that artistically represents your app’s purpose.
Keep the background simple and avoid transparency. Make sure your icon is opaque, and don’t clutter the background. Give it a simple background so it doesn’t overpower other app icons nearby. You don’t need to fill the entire icon with content.
Use words only when they’re essential or part of a logo. An app’s name appears below its icon on the Home screen. Don’t include nonessential words that repeat the name or tell people what to do with your app, like 'Watch' or 'Play.' If your design includes any text, emphasize words that relate to the actual content your app offers.
Don’t include photos, screenshots, or interface elements. Photographic details can be very hard to see at small sizes. Screenshots are too complex for an app icon and don’t generally help communicate your app’s purpose. Interface elements in an icon are misleading and confusing.
Don’t use replicas of Apple hardware products. Apple products are copyrighted and can’t be reproduced in your icons or images. In general, avoid displaying replicas of devices, because hardware designs tend to change frequently and can make your icon look dated.
Don’t place your app icon throughout the interface. It can be confusing to see an icon used for different purposes throughout an app. Instead, consider incorporating your icon’s color scheme. See Color.
Test your icon against different wallpapers. You can’t predict which wallpaper people will choose for their Home screen, so don’t just test your app against a light or dark color. See how it looks over different photos. Try it on an actual device with a dynamic background that changes perspective as the device moves.
Keep icon corners square. The system applies a mask that rounds icon corners automatically.
App Icon Attributes
All app icons should adhere to the following specifications.
Attribute | Value |
---|---|
Format | PNG |
Color space | sRGB or P3 (see Color Management) |
Layers | Flattened with no transparency |
Resolution | Varies. See Image Size and Resolution |
Shape | Square with no rounded corners |
App Icon Sizes
Every app must supply small icons for use on the Home screen and throughout the system once your app is installed, as well as a larger icon for display in the App Store.
Device or context | Icon size |
---|---|
iPhone | 180px × 180px (60pt × 60pt @3x) |
120px × 120px (60pt × 60pt @2x) | |
iPad Pro | 167px × 167px (83.5pt × 83.5pt @2x) |
iPad, iPad mini | 152px × 152px (76pt × 76pt @2x) |
App Store | 1024px × 1024px (1024pt × 1024pt @1x) |
Provide different sized icons for different devices. Make sure that your app icon looks great on all the devices you support.
Mimic your small icon with your App Store icon. Although the App Store icon is used differently than the small one, it’s still your app icon. It should generally match the smaller version in appearance, although it can be subtly richer and more detailed since there are no visual effects applied to it.
Spotlight, Settings, and Notification Icons
Every app should also provide a small icon that iOS can display when the app name matches a term in a Spotlight search. Additionally, apps with settings should provide a small icon to display in the built-in Settings app, and apps that support notifications should provide a small icon to display in notifications. All icons should clearly identify your app—ideally, they should match your app icon. If you don’t provide these icons, iOS might shrink your main app icon for display in these locations.
Device | Spotlight icon size |
---|---|
iPhone | 120px × 120px (40pt × 40pt @3x) |
80px × 80px (40pt × 40pt @2x) | |
iPad Pro, iPad, iPad mini | 80px × 80px (40pt × 40pt @2x) |
Device | Settings icon size |
---|---|
iPhone | 87px × 87px (29pt × 29pt @3x) |
58px × 58px (29pt × 29pt @2x) | |
iPad Pro, iPad, iPad mini | 58px × 58px (29pt × 29pt @2x) |
Device | Notification icon size |
---|---|
iPhone | 60px × 60px (20pt × 20pt @3x) |
40px × 40px (20pt × 20pt @2x) | |
iPad Pro, iPad, iPad mini | 40px × 40px (20pt × 20pt @2x) |
Don’t add an overlay or border to your Settings icon. iOS automatically adds a 1-pixel stroke to all icons so that they look good on the white background of Settings.
TIP If your app creates custom documents, you don't need to design document icons because iOS uses your app icon to create document icons automatically.
User-Selectable App Icons
For some apps, customization is a feature that evokes a personal connection and enhances the user experience. If it provides value in your app, you can let people select an alternate app icon from a set of predefined icons that are embedded within your app. For example, a sports app might offer icons for different teams or an app with light and dark modes might offer corresponding light and dark icons. Note that your app icon can only be changed at the user’s request and the system always provides the user with confirmation of such a change.
Provide visually consistent alternate icons in all necessary sizes. Like your primary app icon, each alternate app icon is delivered as a collection of related images that vary in size. When the user chooses an alternate icon, the appropriate sizes of that icon replace your primary app icon on the Home screen, in Spotlight, and elsewhere in the system. To ensure that alternate icons appear consistently throughout the system—the user shouldn't see one version of your icon on the Home screen and a completely different version in Settings, for example—provide them in the same sizes you provide for your primary app icon (with the exception of the App Store icon). See App Icon Sizes.
For developer guidance, see the setAlternateIconName method of UIApplication.
NOTE Alternate app icons are subject to review by App Review and must adhere to the App Store Review Guidelines.
Technical Q&A QA1686
Q: What icons need to be included in an iOS Application, Apple Watch Application, iMessage Application, or Sticker Pack Application?
A: Below are guidelines for handling icon files for iPhone-only apps, iPad-only apps, universal apps, Apple Watch apps, and iMessage extensions. If you are building an iMessage Application or Sticker Pack Application, you must include icons for both the containing application and the iMessage extension.
If you don't provide artwork for one of the listed optional icons, the system will automatically scale one of your existing icon images to an appropriate size. It is strongly recommended that your application include artwork for all the icons listed, at the specific sizes needed.
Prior to iOS 3.2, icon images for iPhone applications were required to follow a strict naming convention. These legacy names are still listed in the tables below along with example names for the more recent icons. Except for
iTunesArtwork
, icon images included in your app can have arbitrary names.Note: All icon images must be in PNG format. Icon images may include an alpha channel but should not include any transparent regions.
iOS ignores the PPI (Pixels Per Inch) of icon images. You may author your icon images at any PPI but their width and height, as measured in pixels, must match the values in the tables below.
Important: iTunesArtwork icon images should be in png format, but name them without the .png extension.
Icons for iPhone-only Applications
iPhone-only applications use the following icons. Items marked with 'Required' must be included.
Note: You should include images for the iPad-specific icons even if the application is not a universal app. If available, they will be used when the application is installed on an iPad.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
512x512 | iTunesArtwork | App list in iTunes | Do not include | Optional but recommended |
1024x1024 | iTunesArtwork@2x | App list in iTunes on devices with retina display | Do not include | Optional but recommended |
120x120 | Home screen on iPhone/iPod Touch with retina display | Required | Required | |
180x180 | Home screen on iPhone with retina HD display | Optional but recommended | Optional but recommended | |
76x76 | Icon-76.png | Home screen on iPad | Optional but recommended | Optional but recommended |
152x152 | Home screen on iPad with retina display | Optional but recommended | Optional but recommended | |
167x167 | Home screen on iPad Pro | Optional but recommended | Optional but recommended | |
40x40 | Icon-Small-40.png | Spotlight | Optional but recommended | Optional but recommended |
80x80 | Spotlight on devices with retina display | Optional but recommended | Optional but recommended | |
120x120 | Spotlight on devices with retina HD display | Optional but recommended | Optional but recommended | |
29x29 | Icon-Small.png | Settings | Recommended if you have a Settings bundle, optional otherwise | Recommended if you have a Settings bundle, optional otherwise |
58x58 | Settings on devices with retina display | Recommended if you have a Settings bundle, optional otherwise | Recommended if you have a Settings bundle, optional otherwise | |
87x87 | Settings on devices with retina HD display | Recommended if you have a Settings bundle, optional otherwise | Recommended if you have a Settings bundle, optional otherwise |
In addition to the above icons, iPhone-only applications with a deployment target of iOS 6.1 or earlier use the following icons. Items marked with 'Required' must be included if the application's deployment target is iOS 6.1 or earlier.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
57x57 | Icon.png | Home screen on iPhone/iPod touch (iOS 6.1 and earlier) | Required | Required |
114x114 | Home screen on iPhone/iPod Touch with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended | |
72x72 | Icon-72.png | Home screen on iPad (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended |
144x144 | Home screen on iPad with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended | |
29x29 | Icon-Small.png | Spotlight on iPhone/iPod Touch (iOS 6.1 and earlier), and Settings on all devices | Recommended if you have a Settings bundle, otherwise optional but recommended | Recommended if you have a Settings bundle, otherwise optional but recommended |
58x58 | Spotlight on iPhone/iPod Touch with retina display (iOS 6.1 and earlier), and Settings on all devices with retina display | Recommended if you have a Settings bundle, otherwise optional but recommended | Recommended if you have a Settings bundle, otherwise optional but recommended | |
50x50 | Icon-Small-50.png | Spotlight on iPad (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended |
100x100 | Spotlight on iPad with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended |
You can include distinct images for the iPhone and iPad icons in categories where the required sizes are equivalent, for example, Settings.
Icons for iPad-only Applications
iPad-only applications use the following icons. Items marked with 'Required' must be included.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
512x512 | iTunesArtwork | Ad Hoc iTunes | Do not include | Optional but recommended |
1024x1024 | iTunesArtwork@2x | Ad Hoc iTunes on devices with retina display | Do not include | Optional but recommended |
76x76 | Icon-76.png | Home screen on iPad | Required | Required |
152x152 | Home screen on iPad with retina display | Optional but recommended | Optional but recommended | |
167x167 | Home screen on iPad Pro | Optional but recommended | Optional but recommended | |
40x40 | Icon-Small-40.png | Spotlight | Optional but recommended | Optional but recommended |
80x80 | Spotlight on devices with retina display | Optional but recommended | Optional but recommended | |
29x29 | Icon-Small.png | Settings | Recommended if you have a Settings bundle, otherwise optional but recommended | Recommended if you have a Settings bundle, otherwise optional but recommended |
58x58 | Settings on devices with retina display | Recommended if you have a Settings bundle, otherwise optional but recommended | Recommended if you have a Settings bundle, otherwise optional but recommended |
In addition to the above icons, iPad-only applications with a deployment target of iOS 6.1 or earlier use the following icons. Items marked with 'Required' must be included if the application's deployment target is iOS 6.1 or earlier.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
72x72 | Icon-72.png | Home screen on iPad (iOS 6.1 and earlier) | Required | Required |
144x144 | Home screen on iPad with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended | |
50x50 | Icon-Small-50.png | Spotlight on iPad (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended |
100x100 | Spotlight on iPad with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended |
Icons for Universal Applications
Universal applications use the following icons. Items marked with 'Required' must be included.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
512x512 | iTunesArtwork | App list in iTunes | Do not include | Optional but recommended |
1024x1024 | iTunesArtwork@2x | App list in iTunes for devices with retina display | Do not include | Optional but recommended |
120x120 | Home screen on iPhone/iPod Touch with retina display | Required | Required | |
180x180 | Home screen on iPhone with retina HD display | Optional but recommended | Optional but recommended | |
76x76 | Icon-76.png | Home screen on iPad | Required | Required |
152x152 | Home screen on iPad with retina display | Optional but recommended | Optional but recommended | |
167x167 | Home screen on iPad Pro | Optional but recommended | Optional but recommended | |
40x40 | Icon-Small-40.png | Spotlight | Optional but recommended | Optional but recommended |
80x80 | Spotlight on devices with retina display | Optional but recommended | Optional but recommended | |
120x120 | Spotlight on devices with retina HD display | Optional but recommended | Optional but recommended | |
29x29 | Icon-Small.png | Settings | Recommended if you have a Settings bundle, optional otherwise | Recommended if you have a Settings bundle, optional otherwise |
58x58 | Settings on devices with retina display | Recommended if you have a Settings bundle, optional otherwise | Recommended if you have a Settings bundle, optional otherwise | |
87x87 | Settings on devices with retina HD display | Recommended if you have a Settings bundle, optional otherwise | Recommended if you have a Settings bundle, optional otherwise |
In addition to the above icons, universal applications with a deployment target of iOS 6.1 or earlier use the following icons. Items marked with 'Required' must be included if the application's deployment target is iOS 6.1 or earlier.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
57x57 | Icon.png | Home screen on iPhone/iPod touch (iOS 6.1 and earlier) | Required | Required |
114x114 | Home screen on iPhone/iPod Touch with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended | |
72x72 | Icon-72.png | Home screen on iPad (iOS 6.1 and earlier) | Required | Required |
144x144 | Home screen on iPad with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended | |
29x29 | Icon-Small.png | Spotlight on iPhone/iPod Touch (iOS 6.1 and earlier), and Settings on all devices | Recommended if you have a Settings bundle, otherwise optional but recommended | Recommended if you have a Settings bundle, otherwise optional but recommended |
58x58 | Spotlight on iPhone/iPod Touch with retina display (iOS 6.1 and earlier), and Settings on all devices with retina display | Recommended if you have a Settings bundle, otherwise optional but recommended | Recommended if you have a Settings bundle, otherwise optional but recommended | |
50x50 | Icon-Small-50.png | Spotlight on iPad (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended |
100x100 | Spotlight on iPad with retina display (iOS 6.1 and earlier) | Optional but recommended | Optional but recommended |
You can include distinct images for the iPhone and iPad icons in categories where the required sizes are equivalent, for example, Settings.
Icons for Watch Applications
Watch applications use the following icons. Items marked with 'Required' must be included.
Important: Icons for Watch applications must be added to the Watch App target. Do not add Watch icons to the iOS app target or the Watch Extension target.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
80x80 | Home screen on Apple Watch (38mm/42mm), Long-Look notification on Apple Watch (38mm) | Required | Required | |
88x88 | Long-Look notification on Apple Watch (42mm) | Required | Required | |
172x172 | Short-Look notification on Apple Watch (38mm) | Required | Required | |
196x196 | Short-Look notification on Apple Watch (42mm) | Required | Required | |
48x48 | Notification center on Apple Watch (38mm) | Required | Required | |
55x55 | Notification center on Apple Watch (42mm) | Required | Required | |
58x58 | Settings in the Apple Watch companion app on iPhone | Required | Required | |
87x87 | Settings in the Apple Watch companion app on iPhone 6 Plus | Required | Required |
Icons for iMessage Extensions
iMessage extensions and Sticker Pack extensions use the following icons. Items marked with 'Required' must be included.
Important: These icons must be added to the iMessages extension or Sticker Pack extension target.
Image Size (px) | File Name | Used For | App Store | Ad Hoc |
---|---|---|---|---|
1024x768 | Messages1024x768.png | Messages App Store | Required | Required |
120x90 | Messages app drawer on iPhone/iPod Touch with retina display | Required | Required | |
180x135 | Messages app drawer on iPhone with retina HD display | Required | Required | |
134x100 | Messages app drawer on iPad with retina display | Required | Required | |
148x110 | Messages app drawer on iPad Pro | Required | Required | |
54x40 | Breadcrumb icons in the chat transcript on devices with retina display. | Required | Required | |
81x60 | Breadcrumb icons in the chat transcript on iPhone with retina HD display | Required | Required | |
64x48 | Messages app management screen, message bubble branding on devices with retina display | Required | Required | |
96x72 | Messages app management screen, message bubble branding on iPhone with retina HD display | Required | Required |
Adding Icons to an iOS Application
Asset catalogs are the preferred way to manage your application's icons. New projects are configured to use asset catalogs by default. If you have an older project, see Migrating an iOS App Icon Set to learn how to move existing app icons and launch images into an asset catalog. If you prefer not to use asset catalogs, or if you must support iOS 4.3, you can manually configure your application's icons by editing the information property list for your application. See Configuring Icons Without an Asset Catalog.
Adding Icon Images to an Asset Catalog
- Select the asset catalog in the project navigator. It is named Assets.xcassets for new projects, or Images.xcassets for migrated projects, by default.
- From the set outline view (left column), select the app icon set. For new or migrated projects it will be named 'AppIcon'. You may need to create an icon set by clicking the (+) button in the bottom left corner of the editor and choosing App Icons and Launch Images > New iOS App Icon from the context menu.
The set will only contain image wells for icons that are relevant depending upon the project's configuration at the time the asset catalog was created. If an image well is missing, expand the attributes inspector and select the appropriate options from the pull-down menus under the App Icon section, depending upon the project's deployment target and supported devices.
- Drag images from the Finder onto each image well to configure the associated icon.
Asset catalogs create a copy of images added to them. If you had previously added the images as resources to your project you can safely remove them.
- Configure your application to use the new icon set.
- Select the project in the project navigator.
- Select the application target from the list in the left column of the project editor.
- Switch to the General pane at the top of the project editor.
- Select the app icon set from the App Icons Source popup menu under the App Icons And Launch Images section.
Migrating an iOS App Icon Set
Simplify image management by moving existing app icons into an asset catalog.
- In the project navigator, select your target.
- Open the General pane, and scroll to the App Icons and Launch Images section.
- Click the Use Asset Catalog button next to the App Icons Source label.
- Configure any options in the dialog. To choose a different asset catalog or to create a new one, click on the pop-up menu. Choose an existing asset catalog or choose New Asset Catalog to create a new one. The menu is shown when there is at least one asset catalog in the project.
- Click the Migrate button. If there is no asset catalog or if you selected New Asset Catalog from the pop-up menu, you will be prompted to create one. Canceling creation of the new asset catalog will cancel the migration.
The icons are migrated to the new or existing asset catalog.
Configuring Icons Without an Asset Catalog
- Follow the steps in the Xcode Help to add each icon image to your project as a resource.
- Locate the target's information property list in the project navigator. By default it will be named
Info.plist
. Command click on it and choose Open As > Source Code from the context menu.
As of iOS 5.0, icons are specified by including the
CFBundleIcons
key. Older applications may have previously specified their icons by including the CFBundleIconFiles
key. This key should be removed if it is still present (don't forget to remove any device specific variants too). All applications should migrate to the CFBundleIcons
key to specify their icons.The value for the
CFBundleIcons
key is a dictionary with two child keys: CFBundlePrimaryIcon
and UINewsstandIcon
. The UINewsstandIcon
key is for newsstand apps and can otherwise be omitted. The value for the CFBundlePrimaryIcon
key is a dictionary that identifies the icon images associated with the bundle. It may contain two child keys: CFBundleIconFiles
and UIPrerenderedIcon
. The value for the UIPrerenderedIcon
key is a boolean that specifies whether the images already incorporate a shine effect. The value for CFBundleIconFiles
key is an array of strings, each identifying an image in the bundle.Important: When specifying the name of each image, it is best to omit any extensions. Omitting the extension lets the system automatically detect high-resolution (
@2x
or @3x
) variants of the image using the standard-resolution image filename. If you include extensions, you must specify all image files (including the high-resolution variants) explicitly.Listing 1 Example configuration for a universal app.
If your application supports iOS 4.3 you must also include the
CFBundleIconFiles
key to specify the application's icon images. The value for this key is an array of strings, each identifying an image in the bundle. If you have included images for the iPad-specific icons, you may either list them under the CFBundleIconFiles
key, or you may list them under the device specific CFBundleIconFiles~ipad
key. iPad-only applications should list their icon images under the CFBundleIconFiles
key.Listing 2 Example configuration for a universal app with deployment target of iOS 4.3.
Adding Icons to a Watch Application
Asset catalogs are the preferred way to manage your Watch application's icons. New projects are configured to use asset catalogs by default.
Adding Icon Images to an Asset Catalog
- Select the asset catalog in the project navigator. It is named Images.xcassets by default.
- From the left column of the editor, select the icon set. For new it will be named 'AppIcon'. You may need to create an icon set by clicking the (+) button in the bottom left corner of the editor and choosing 'New App Icon' from the context menu.
By default, the set will only contain image wells for watch icons. If image wells for iOS app icons are present, expand the attributes inspector and select the appropriate options from the pull-down menus under the App Icon section.
- Drag images from the Finder onto each image well to configure the associated icon.
Asset catalogs create a copy of images added to them. If you had previously added the images as resources to your project you can safely remove them.
- Configure the Watch application to use the new icon set.
- Select the project in the project navigator.
- Select the Watch App target from the list in the left column of the project editor.
- Switch to the General pane at the top of the project editor.
- Select the icon set from the App Icons Source popup menu under the App Icons section.
Adding Icons to an iMessage Extension
Asset catalogs are the preferred way to manage iMessage extension and Sticker Pack extension icons. New projects are configured to use asset catalogs by default.
Adding Icon Images to an Asset Catalog
- Select the asset catalog in the project navigator. It is named Assets.xcassets by default.
- From the set outline view (left column), select the app icon set. It is named 'iMessage App Icon' by default. You may need to create an icon set by clicking the (+) button in the bottom left corner of the editor and choosing App Icons and Launch Images > New Messages Extension Icon from the context menu.
- Drag images from the Finder onto each image well to configure the associated icon.
- Configure the extension to use the new icon set.
- Select the project in the project navigator.
- Select the iMessage extension or Sticker Pack extension target from the list in the left column of the project editor.
- Switch to the General pane at the top of the project editor.
- Select the icon set from the Sticker Icons Source popup menu under the App Icons section.
Troubleshooting
This section describes common problems and how to fix them.
Note: Before attempting further troubleshooting, perform a clean build of the application (Hold down the Option key and choose Product > Clean Build Folder, then Product > Build from the Xcode menu bar) and remove the app from the test device or simulator. Build the app again and attempt to reproduce the problem. You may also try clearing the contents of Xcode's derived data folder (
~/Library/Developer/Xcode/DerivedData/
) before building again.[Asset Catalogs] Remove icon related keys from the information property list
If a target is using asset catalogs to manage its icons then its information property list should not include any icon related keys; they will be added at build time by the asset catalog compiler.
- Open the information property list for the target. It can be found under the Info tab in the project editor or in the project navigator where it will likely be named either
Info.plist
or<ProductName>-Info.plist
. - Remove the following keys, including device specific variations.
- “Icon file” (
CFBundleIconFile
) - “Icon files” (
CFBundleIconFiles
) CFBundleIcons
[Asset Catalogs] Verify that the asset catalog is associated with the target
If a target is using asset catalogs to manage its icons, verify that the asset catalog file is associated with the target and that the correct image set is selected for the target's App Icons Source.
- Select the asset catalog in the project navigator.
- In the utility panel, check the box next to the target under the Target Membership section as shown in Figure 12.
- Select the project in the project navigator.
- Select the target from the list in the left column of the project editor.
- Switch to the General pane at the top of the project editor.
- Verify that the name of the icon set is selected in the App Icons Source popup menu under the App Icons and Launch Images section as shown in Figure 4.
[Manual] Verify that all icon images are associated with the target
If a target is not using asset catalogs to manage its icons, verify that each of the icon images are associated with the target. Images that are not associated with the target are not copied into the target's bundle when it is built.
- Select the icon image in the project navigator.
- In the utility panel, check the box next to the target under the Target Membership pane as shown in Figure 13.
[Manual] Verify that the CFBundleIcons key is present in the information property list
If a target is not using asset catalogs to manage its icons, the information property list must contain the CFBundleIcons key to specify the application's icon images. See Configuring Icons Without an Asset Catalog.
Note: Older applications may have previously specified their application icons by including the CFBundleIconFiles key. You should migrate these applications to use the
CFBundleIcons
key instead.[Manual] Verify that all images referenced by the CFBundleIcons key are present
If a target is not using asset catalogs to manage its icons, each of the entries under the CFBundleIcons key in the information property must reference at least one image in the app bundle. Remember that if you include filename extensions in the information property list, you must specify the names of all icon image files (including the high-resolution variants) explicitly.
Verify that all icon images are in PNG format, use a supported color model, and are the correct sizes
All icon images must be in PNG format and use a supported color model. Images that do not use the RGB color model may appear correctly in Xcode but will fail to load on the device. You can use the Preview application to inspect the format, color model, and size of an image.
- Open the image in Preview
- For an image inside of an asset catalog: Select the asset catalog in the project navigator, choose the image set containing the icons, select the image and choose File > Open with External Editor.
- For an image not inside of an asset catalog: Select the image in the project navigator and choose File > Open with External Editor.
- From the Preview menubar, choose Tools > Show Inspector.
- The Inspector window opens
- The value of the Document Type field shows the image format. It should be Portal Network Graphics image.
- The value of the Image Size field shows the image size. It should match the size shown in the tabes above.
- The value of the Color Model field shows the image size. It should be RGB.
If the Document Type is not a Portal Network Graphics image, use Preview to export a copy of the image in PNG format.
- From the Preview menubar, choose File > Export.
- Select PNG from the Format menu at the bottom of the save dialog.
- Click the Save button.
- Import the saved image into your Xcode project, replacing the original image.
Repeat the above for all icon images.
Validation Errors
There are multiple icon-related problems that will result in your application failing validation by Xcode or iTunes Connect. The underlying issue depends upon the error.
ITMS-90022/ITMS-90023: Missing required icon file
You have not included an image for one or more of the required icons, based on your application's supported devices and deployment target.
Refer to the tables above for the list of required icons. Verify that each of your icon images matches the size listed in the table.
If your application was recently migrated to use asset catalogs to manage its icons, verify that you have removed all icon-related keys from your application's information property list.
If your application is not using asset catalogs to manage its icons, verify that the CFBundleIcons key is present in your application's information property list, and all listed images are present in your application bundle.
ITMS-90032: Invalid Image Path
Your application's information property list references one or more icon images that were not included in the compiled bundle.
If your application is using asset catalogs to manage its icons, verify that you have removed all icon-related keys from your application's information property list.
If your application is not using asset catalogs to manage its icons, verify that all images referenced by the
CFBundleIcons
key in the application's information property list are present and are associated with the application target.ITMS-90033: Invalid Image
One or more of your application's icon images is not a valid PNG file. Verify that all icon images are in PNG format, use a supported color model, and are the correct sizes.
ITMS-90647: Invalid (Messages) Image Asset
One or more of the icons in your iMessage extension or Sticker Pack extension contains transparent areas. Icons for iMessage extensions and Sticker Pack extensions must be opaque.
You can use the Preview app to check your image for transparent areas, which will appear dark grey as shown in Figure 17. Use your preferred graphics editing software to fill in the transparent areas with the desired background color.
We clicked “Yes”. This overlay will count down until the application quits, or you release the keyboard shortcut.In other words, it will abort quitting the application if you release Command+Q before the countdown completes.You can also adjust the delay if you prefer. By default, it is set to quit applications after 2 seconds, but you can make that longer or shorter by opening the Terminal and typing the following command and hitting “Enter”: $ defaults write com.dteoh.SlowQuitApps delay 5000You want to change the value after “delay” accordingly. Best mac terminal app. You can always change this at a later time.Once installed, SlowQuitApps will act as an intermediary between you and Command+Q. When you press Command+Q, a black countdown overlay will appear on top of your app.
ITMS-90649: Missing (Messages) App Icon
You have not included an image for one or more of the required icons in your iMessage extension or Sticker Pack extension, or one of your icons is not the correct size. Refer to the tables above for the list of required icons. Verify that each of your icon images matches the size listed in the table.
Icons for iMessage extensions and Sticker Pack Extensions must be added to the asset catalog associated with the iMessage extension or Sticker Pack extension target. See Adding Icons to an iMessage Extension.
Other Errors
Icons don't appear on the device
If the project is using asset catalogs to manage its icons, verify that the asset catalog is associated with the target.
If the project is not using asset catalogs to manage its icons, verify that all images referenced by the
CFBundleIcons
key in the application's information property list are present are associated with the application target, and are in a supported format.A previous version of the icon appears on the device
Your testing device or simulator may have a partially outdated build. That is, Xcode failed to copy a modified resource to the app bundle it installed on the device as part of the build & run process. To force Xcode to copy the most recent resources from your project directory:
![Mac Pages App Plus Sign Symbol Mac Pages App Plus Sign Symbol](/uploads/1/2/6/4/126441405/782465981.jpg)
- Remove the app from your testing device or simulator.
- Clean the build directory. Hold down the Option key and choose Product > Clean Build Folder, then Product > Build from the Xcode menu bar
- Build and run your app.
If your project is using asset catalogs then you must replace the modified image in the asset catalog. Asset catalogs do not track files on disk, opting instead to make a copy of the image at the time it is added to the asset catalog.
Messages App Icon Is Missing On iPad
Verify that you have included icons for all of the sizes listed in Table 8 in the iMessage extension or Sticker Pack extension target. See Adding Icons to an iMessage Extension.
In addition, open the information property list for the iMessage extension or Sticker Pack extension and remove all icon-related keys.
Icon has a black border
![Mac pages app plus sign symbols Mac pages app plus sign symbols](/uploads/1/2/6/4/126441405/431212070.png)
Your icon artwork includes rounded corners or transparent areas. iOS will automatically apply a mask that rounds the corners to each icon it displays on the Home screen. Do not inset your icon artwork and make sure your icon has 90° corners so it looks good after the mask is applied.
Icon has a black background in the App Store
The Large App Icon you uploaded to iTunes Connect includes transparent areas. The iTunes Connect Developer Guide lists the complete requirements for the Large App Icon, including that it must be opaque.
You can use the Preview app to check your image for transparent areas, which will appear dark grey as shown in Figure 17. Use your preferred graphics editing software to fill in the transparent areas with the desired background color.
The wrong icon appears in the App Store
The application bundle includes additional images which are being detected as valid icon images.
Note: Different icon images from the application's bundle, and the large app icon, are displayed in various contexts within the App Store. For example, the incorrect icon image may appear in the search results but not on your application's landing page.
You may encounter this issue if your icon images deviate from the naming convention shown in the above tables. If your application bundle also contains one or more images that match the naming convention in the tables above, these images may be detected as valid icon images by the App Store. This may occur regardless of whether those images are included in the asset catalog or are referenced by the application's information property list. The solution is to rename or remove the images.
You may encounter this issue when building an app using a third party development environment or if your project was created using a template project provided by a third party. Both will usually include a default set of icon images. If you fail to remove these images or replace all of them with your own artwork, the App Store may display them in the search results for your app. Like the iOS home screen, the icons displayed in the search results depend upon the current device. It is possible that the incorrect icon is shown in the search results on certain devices but not others.
The solution is to delete any instances of the template-provided icons that remain in your project and remove any references to the deleted files from the information property list. Due to the wide variety of ways in which iOS versions have allowed developers to specify app icons in the information property list, you may find it simpler and less error prone to remove all icon related keys from the information property list and then reconfigure your app's icons using the steps presented in Adding Icons to an iOS Application. See Start Over.
Start Over
If the none of the above solutions resolve the problem, follow the steps below to remove all the icons and icon related configuration from the application. Then follow the steps in Adding Icons to an iOS Application to re-configure the proper icons for the application.
Warning: Make sure you have a backup of your icon artwork at a location outside of your project directory.
Remove the Icon Set From Your Asset Catalog
- Select the asset catalog in the project navigator. It is named Assets.xcassets or Images.xcassets by default.
- From the set outline view (left column), control click the icon set and choose
Remove Selected Items
from the context menu. By default the icon set will be named 'AppIcon'.
Remove Icon Images From Your Project
Using the Xcode project navigator, remove any icon images from your project that were previously added to your project as resources. Icon images usually have a file name beginning with 'Icon' or 'AppIcon'.
Remove Icon Related Keys From The Information Property List
- Open the information property list for your application. It can be found under the Info tab in the project editor or in the navigator where it will likely be named either
YourApp-Info.plist
orInfo.plist
. - Remove the following keys, including device specific variations.
- “Icon file” (
CFBundleIconFile
) - “Icon files” (
CFBundleIconFiles
) CFBundleIcons
Clean The Project
To remove any cached icons, clean your target. Choose Product > Clean from the menu bar.
Finally, follow the steps in Adding Icons to an iOS Application to re-configure the proper icons for the application.
Additional Resources
For additional information, see the App Icons section in the iOS App Programming Guide.
For information about designing your application's icons, see the App Icon section of the iOS Human Interface Guidelines.
For an example project with properly configured icons, see the Application Icons and Launch Images for iOS sample code.
Document Revision History
Mac Pages App Plus Sign Symbols
Copyright © 2016 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2016-12-20