> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Profile Portal Assets

> The image assets your brand needs to provide to configure Profile Portal and its Apple Wallet and Google Wallet cards.

Profile Portal is configured to match your brand during onboarding, and again whenever you update your branding. This page lists the image assets Omneo needs from you, with recommended dimensions, formats, and file names, so your design team can prepare a complete set in one pass. See [Configuring Profile Portal](/experiences/profile-portal/configuration) for how these assets fit into setup.

<Note>
  Provide these assets to your Omneo account manager. Self-serve asset upload is not yet available.
</Note>

## Before you start

* Provide logos as vector files (SVG) where possible, or at minimum a 2x resolution PNG.
* Use transparent backgrounds for icons and logos, and JPG for photographic backgrounds and banners.
* Label each file by its purpose (for example "card background") rather than only its dimensions, so Omneo can confirm it matches the right slot.
* Provide the actual pixel dimensions of each file. A print-ready source file (for example an InDesign file) is not usable directly and needs a web-ready export.

## Asset checklist

```text theme={null}
resources/
├── favicon/
│   ├── icon-16x16.png
│   ├── icon-32x32.png
│   ├── icon-64x64.png
│   └── icon-128x128.png
├── profile-portal/
│   ├── brand-logo.svg
│   ├── profile-card-logo.png
│   ├── profile-card.jpg
│   ├── profile-banner-desktop.jpg
│   └── profile-banner-mobile.jpg
├── wallet/
│   ├── apple/
│   │   ├── apple-icon.png / apple-icon@2x.png / apple-icon@3x.png
│   │   ├── apple-logo.png / apple-logo@2x.png / apple-logo@3x.png
│   │   └── apple-banner.png / apple-banner@2x.png / apple-banner@3x.png
│   └── google/
│       ├── google-logo@4x.png
│       └── google-banner@2x.png
└── optional/
    ├── email-logo.png
    ├── email-banner.jpg
    └── receipt-example.png
```

That is 20 required files, plus the optional ones listed under `optional/` (see [Optional assets](#optional-assets)). The following sections cover each group in detail.

If the same file is reused for more than one purpose (for example the Google Wallet logo also used as the Profile Portal card logo, or the same logo used for both the brand logo and the email logo), provide one file and state which purposes it covers, rather than duplicating it under multiple names.

### Favicon

Used for the browser tab icon, and when a customer adds Profile Portal to their home screen or bookmarks.

| File               | Dimensions | Format                      |
| ------------------ | ---------- | --------------------------- |
| `icon-16x16.png`   | 16x16      | PNG, transparent background |
| `icon-32x32.png`   | 32x32      | PNG, transparent background |
| `icon-64x64.png`   | 64x64      | PNG, transparent background |
| `icon-128x128.png` | 128x128    | PNG, transparent background |

### Profile Portal

| File                         | Purpose                                   | Dimensions                               | Format                      |
| ---------------------------- | ----------------------------------------- | ---------------------------------------- | --------------------------- |
| `brand-logo.svg`             | Header logo, shared by desktop and mobile | 127px wide, height scales proportionally | SVG or transparent PNG      |
| `profile-card-logo.png`      | Logo shown on the digital loyalty card    | 264px wide, height scales proportionally | PNG, transparent background |
| `profile-card.jpg`           | Background of the digital loyalty card    | 680x480                                  | JPG                         |
| `profile-banner-desktop.jpg` | Desktop page background                   | 1500x1700                                | JPG                         |
| `profile-banner-mobile.jpg`  | Mobile page background                    | 750x376                                  | JPG                         |

### Apple Wallet card

Apple requires three resolution tiers (1x, 2x, 3x) for each image. Provide all three, otherwise Apple upscales the closest available version and the result looks blurred on higher-resolution devices.

| File                  | Purpose                                            | Dimensions                                                   |
| --------------------- | -------------------------------------------------- | ------------------------------------------------------------ |
| `apple-icon.png`      | Icon shown on the lock screen and in notifications | 29x29                                                        |
| `apple-icon@2x.png`   | Same icon at 2x                                    | 58x58                                                        |
| `apple-icon@3x.png`   | Same icon at 3x                                    | 87x87                                                        |
| `apple-logo.png`      | Small logo in the card's top corner                | Recommended 260x60, adjust to match your logo's aspect ratio |
| `apple-logo@2x.png`   | Same logo at 2x                                    | 2x of `apple-logo.png`                                       |
| `apple-logo@3x.png`   | Same logo at 3x                                    | 3x of `apple-logo.png`                                       |
| `apple-banner.png`    | Banner image across the top of the card            | 343x132                                                      |
| `apple-banner@2x.png` | Same banner at 2x                                  | 686x264                                                      |
| `apple-banner@3x.png` | Same banner at 3x                                  | 1029x396                                                     |

All Apple Wallet images are PNG. Icons and logos need a transparent background. The icon and banner dimensions are fixed by Apple. The logo dimensions are a reference only. Actual width and height depend on your brand logo's aspect ratio, and can vary by tenant.

### Google Wallet card

| File                   | Purpose                                 | Dimensions                         | Format        |
| ---------------------- | --------------------------------------- | ---------------------------------- | ------------- |
| `google-logo@4x.png`   | Square logo shown on the card           | Minimum 660x660, 1:1 aspect ratio  | PNG           |
| `google-banner@2x.png` | Banner image across the top of the card | 1032x812, roughly 5:4 aspect ratio | PNG preferred |

Google Wallet masks the logo into a circle. Keep the logo on a square, full-bleed background with roughly 15% margin on each side so nothing gets cut off by the circular mask.

Use a transparent PNG for the banner if you want the card's background colour to show through.

## Optional assets

Provide these only if the corresponding feature is enabled for your tenant.

| File                  | Purpose                                                                            | When it's needed                                 |
| --------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------ |
| Email logo            | Shown at the top of the magic link email customers receive to access their profile | Email-based magic link authentication is enabled |
| Email banner          | Shown at the top of the magic link email, roughly 3:1                              | Same as above                                    |
| Receipt example image | Shown in the Claim Transaction flow                                                | Claim Transaction is enabled                     |

<Info>
  For how Apple Wallet and Google Wallet passes work end to end, see [Omneo Wallet (Omneo Pass)](/concepts/platform-surfaces/omneo-wallet).
</Info>
