Apple Business guidance for brand and location asset intent
Intent
Cover Photo
COVER_PHOTO indicates an intent to use an asset as a location's place card cover photo ("hero" image). When added to a brand asset, it cascades to all locations associated with the brand.
If a location has its own cover photo, the location's cover photo takes precedence over the brand's cover photo.
- Location MAY have exactly one (1)
COVER_PHOTO - Accepted file formats: HEIC (brand asset only), JPEG, or PNG
- Minimum dimensions: 1600x1040 pixels
- Maximum length: 4864 pixels
- Aspect ratio: 1.54:1 (tolerance: 1.5380 - 1.5402)
- Image/photo color space must not use the CMYK color model
Gallery Photo
GALLERY indicates an intent to use an asset as a location's place card gallery photo.
The following size requirements apply to images and photos:
| Key | Minimum Length | Maximum Length |
|---|---|---|
thumbnail | >= 100 | =< 330 |
small | >= 200 | =< 660 |
medium | >= 400 | =< 1320 |
large | >= 600 | =< 1980 |
xlarge | >= 800 | =< 2640 |
xxlarge | >= 1200 | =< 3960 |
original | >= 100 | =< 4864 |
- Accepted file formats are JPEG or PNG
- Unit of measurement for length is pixels.
- Minimum and maximum length refer to both width and height. Neither dimension must be less than minimum nor greater than maximum for a given key
- Referenced photo assets MUST NOT possess an aspect ratio greater than 2.2:1 ("Landscape") or less than 1:2.2 ("Portrait")
In other words, the longest dimension must not be greater than 2.2x the length of the shortest dimension.
Illustration
Gallery photos and their respective aspect ratios. All aspect ratios between the stated minimum and maximum are acceptable.
Place Card Logo
PLACECARD_LOGO indicates an intent to use an asset as a location's place card logo. The asset cascades to all locations associated with the brand.
- Accepted file formats: HEIC, JPEG, PNG, SVG
- Dimensions: 1024x1024 pixels (exact)
- Aspect ratio: 1:1
- SVG file size SHOULD NOT exceed 15 megabytes
- Image color space must not use the CMYK color model
Related
| Name | Description |
|---|---|
| Brand Asset | Brand Asset API |
| Location Asset | Location Asset API |