---
title: "Sessions"
slug: "mapp-intelligence-ios-sdk-v5-sessions"
updated: 2026-04-30T11:48:49Z
published: 2026-04-30T11:48:49Z
canonical: "docs.mapp.com/mapp-intelligence-ios-sdk-v5-sessions"
---

> ## 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.

# Sessions

Session parameters describe the current user session — for example, login state, A/B test bucket, or feature flags. The iOS SDK lets you attach an `MISessionParameters` object to any tracking event so the values are sent together with the event.

Before you start, complete the [Quickstart](/v1/docs/mapp-intelligence-ios-sdk-v5-quickstart) so the SDK is initialized.

---

## MISessionParameters

| Property | Description |
| --- | --- |
| `parameters` | Dictionary of numbered session parameters (`NSNumber` → `NSString`). The numbers must match the session parameters configured in your Mapp Intelligence account. |

---

## Example

Build an `MISessionParameters` with numbered keys and attach it to a page or action event.

**Swift**

```swift
let sessionParams = MISessionParameters(dictionary: [
    1: "loggedIn",
    2: "experiment-A"
])

let pageEvent = MIPageViewEvent(name: "Home")
pageEvent.sessionParameters = sessionParams

MappIntelligence.shared()?.trackPage(pageEvent)
```

**Objective-C**

```objectivec
MISessionParameters *sessionParams = [[MISessionParameters alloc] initWithDictionary:@{
    @1: @"loggedIn",
    @2: @"experiment-A"
}];

MIPageViewEvent *pageEvent = [[MIPageViewEvent alloc] initWithName:@"Home"];
pageEvent.sessionParameters = sessionParams;

[[MappIntelligence shared] trackPage:pageEvent];
```

---

## Session lifecycle on iOS

The SDK manages the session lifecycle automatically:

- A new session starts when the app is launched after being killed.
- An existing session resumes when the user returns to the app within the inactivity window.
- A session ends after about 30 minutes of inactivity (enforced server-side during post-processing).

> [!NOTE]
> You do not start or end sessions from app code. To force a clean session start during testing, use [Reset the SDK Singleton](/v1/docs/mapp-intelligence-ios-sdk-v5-reset-sdk-singleton).

---

## Related

- [Quickstart](/v1/docs/mapp-intelligence-ios-sdk-v5-quickstart)
- [Object Oriented Tracking](/v1/docs/mapp-intelligence-ios-sdk-v5-object-oriented-tracking)
- [Pages](/v1/docs/mapp-intelligence-ios-sdk-v5-pages)
- [Events](/v1/docs/mapp-intelligence-ios-sdk-v5-events)
- [Users](/v1/docs/mapp-intelligence-ios-sdk-v5-users)