Profiles/CRM
Profiles is a CRM for your users. With Profiles, you can:
- Find specific users by profile ID, customer user ID, email, or transaction ID.
- View the user’s event timeline, including billing issues, grace periods, and other events.
- Analyze user’s properties such as subscription state, total revenue/proceeds, and more.
- Grant the user a subscription.
To understand how Adapty creates and links user profiles, see How profiles work.
Finding users
In the Profiles list, you can search for a specific user by:
- Profile ID: Adapty’s internal identifier for the user (also called Adapty ID).
- Customer user ID: Your app’s identifier for the user, if you’ve set one.
- Email: The user’s email, if sent as a custom attribute.
- Transaction ID: The store transaction ID from a purchase.
Click any row to open the user’s full profile.
Subscription state
In the Profiles list, you can filter and sort users by subscription state. The state values are:
| User state | Description |
|---|---|
| Subscribed | The user has an active subscription with auto-renewal enabled. |
| Auto-renew off | The user turned off auto-renewal but still has access to premium features until the end of the subscription period. |
| Subscription cancelled | The user canceled their subscription, and it has fully ended. |
| Billing issue | The user couldn’t be charged due to a billing issue, either after their subscription or trial expired. |
| Grace period | The user is currently in a grace period due to a billing issue that occurred when attempting to charge them after their subscription or trial expired. |
| Active trial | The user has an active subscription that is currently in its trial period. |
| Trial cancelled | The user canceled the trial and does not have an active subscription. |
| Never subscribed | The user has never subscribed or started a trial and remains a freemium user. |
User attributes
You can send additional user properties to Adapty using the SDK.
By default, Adapty sets:
| Property | Description |
|---|---|
| Customer user ID | An identifier of your end user in your system. |
| Adapty ID | Internal Adapty identifier of your end user, called Profile ID. |
| IDFA | The Identifier for Advertisers, assigned by Apple to a user’s device. Requires App Tracking Transparency (ATT) permission on iOS 14+. Not available on Android. |
| Country | Country of your end user. |
| OS | The operating system used by the end user. |
| Device | The end-user-visible device model name. |
| Install date | The date when the user was first recorded in Adapty:
|
| Created at | The date the user was created. |
Send at least your internal user ID or user email. This lets you find users by these identifiers in the Profiles list.
After you install the SDK, Adapty automatically collects user events from the payment queue and displays them in the user profile. The attributes in the table above are collected automatically — you do not need to send them.
Custom attributes
In the Attributes section of a profile, you can see custom attributes set via the SDK or API. You can also assign attributes manually using the Add attribute button.
Granting a subscription
In a profile, you can extend an active subscription or grant a user lifetime access to an access level — without requiring them to make a purchase.
This is most useful for:
- Compensating a user after a billing or support issue.
- Running manual promotions or beta programs.
- Testing subscription flows without a real purchase.
To grant access, open the user’s profile, go to the Access levels section, and click Edit. Set the expiration date and save. The expiration date must be in the future and cannot be decreased once set. Adjusting it for active subscriptions does not affect ongoing payments.
Granting access does not create App Store or Google Play purchase events. The user’s event feed and analytics will differ from a real purchase flow.
You can also grant access programmatically using the Grant access level API method.
Sharing paid access between user accounts
Main article: Sharing paid access between user accounts
Access sharing history
When access levels are shared or transferred, the user’s profile shows a link to the connected profile — the profile that shared access, or the profile that received it. To view the connected profile, in the user’s Profile, click the link next to the access level.
Next steps
- To understand how Adapty creates and links profiles, see How profiles work.
- To configure the access sharing policy, see Sharing paid access between user accounts.
- To grant access programmatically, see the Grant access level API method.