PresentationResult - Encore SDK

The value returned by try await Encore.shared.placement(_:).show(). It tells you whether the user earned an entitlement or not, and why.

PresentationResult is the supported way to observe an offer’s outcome. The older EncorePresentationResult typename is a deprecated alias for this type, and the fluent .onGranted { } / .onNotGranted { } callbacks are deprecated too — prefer branching on the returned PresentationResult.

Definition

public enum PresentationResult: Sendable {
    case granted(Entitlement)
    case notGranted(NotGrantedReason)
}

The associated values are unlabeled — match them positionally:

switch result {
case .granted(let entitlement):   // not .granted(entitlement: ...)
    applyEntitlement(entitlement)
case .notGranted(let reason):     // not .notGranted(reason: ...)
    proceedWithOriginalAction(reason)
}

Cases

Case	Associated value	Description
`.granted`	`Entitlement`	The user completed an offer and earned an entitlement (trial, discount, or credit).
`.notGranted`	`NotGrantedReason`	The user did not earn an entitlement (dismissed, no offers, experiment control, unsupported OS).

Usage

let result = try await Encore.shared.placement("paywall").show()

switch result {
case .granted(let entitlement):
    // The SDK has already recorded the grant; reflect it in your UI.
    unlockPremiumContent(for: entitlement)
case .notGranted(let reason):
    // Resume the user's original flow.
    proceedWithCancellation(reason: reason)
}

show() only throws for genuine failures (transport, protocol, integration). A user dismissal is .notGranted(...), not a thrown error — see Errors and NotGrantedReason.

UserAttributes Entitlements

​Definition

​Cases

​Usage

Definition

Cases

Usage