---
title: "FAQs & Troubleshooting"
slug: "mapp-engage-ios-sdk-faqs-troubleshooting"
updated: 2026-05-07T09:32:46Z
published: 2026-05-07T09:32:46Z
canonical: "docs.mapp.com/mapp-engage-ios-sdk-faqs-troubleshooting"
---

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

# FAQs & Troubleshooting

## FAQs

#### Why can't I upload Apple iOS certificates to the Marketing Cloud?

- Ensure your certificates are valid and include the correct capabilities:
  - Development for the development channel.
  - Production for the production channel.
- Match certificates with their respective bundle IDs.

#### Why can't I send rich push notifications or add media to my notifications?

- Create a mobile app extension and corresponding certificate via Apple Developer.
- Refer to [Rich Push Notifications](/v1/docs/mapp-engage-ios-sdk-rich-push-notifications).

#### How do I generate an iOS Push Certificate?

See [Installation](/v1/docs/mapp-engage-ios-sdk-installation) for the steps to enable Apple Messaging for Mapp Engage.

#### What types of media can be sent to iOS devices?

- Supported formats: video, animated images, images, and audio files.
- File size limits:
  - Images: 10 MB
  - Audio: 5 MB
  - Video: 50 MB

---

## Troubleshooting

#### No debug logs display after integrating the SDK:

- Ensure the SDK setup is completed.
- On the first launch, check for `[Appoxee Debug] Engaging Appoxee SDK...` in Xcode.

#### Critical error: Missing SDK Key:

Confirm the `sdk_key` and `is_eu` flag are correctly entered in `AppoxeeConfig.plist`. Missing or invalid credentials result in `[Appoxee Critical]` logs at startup.

> [!NOTE]
> Note:
> 
> The legacy `App Secret` field (formerly `AppoxeeDelegateAppSecret`) has been deprecated. Current versions of the SDK rely solely on the `sdk_key` from `AppoxeeConfig.plist`.

#### Error: Wrong SDK Key used:

Verify the correct SDK Key is used to prevent `[Appoxee Error] HTTP code: 403`. A 403 also occurs when the `is_eu` flag does not match the data center the SDK Key was issued for.

#### How to utilize Mapp Engage SDK logs:

Debug logs provide detailed error information. Check log levels (`Debug`, `Error`, `Critical`) for debugging.

---

**Still have questions?**

Contact Mapp Cloud Support: [Mapp Service Now](https://mapp.service-now.com/).