Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Link your signed-in user ID to Encore for cross-device entitlements and attribution, optionally with attributes
Future<void> identify({
required String userId,
EncoreUserAttributes? attributes,
})
Future completes once the call reaches the native SDK. It does not wait for the network.
| Name | Type | Description |
|---|---|---|
userId | String | Your user’s unique identifier from your auth system. An empty or whitespace-only ID is ignored with a warning |
attributes | EncoreUserAttributes? | Optional attributes to store with the identity, in the same call |
identify() replace the stored set; they are not merged. When the call changes the user or the attributes, the stored set becomes what you pass, so a field you leave out does not carry over. To add or change attributes without touching the others, call setUserAttributes(), which merges.An empty EncoreUserAttributes() counts as no attributes, so it leaves the stored set unchanged.await Encore.shared.identify(userId: user.id);
await Encore.shared.identify(
userId: user.id,
attributes: EncoreUserAttributes(
email: user.email,
subscriptionTier: user.plan,
monthsSubscribed: user.monthsActive.toString(),
),
);
await Encore.shared.identify(userId: user.id);
// Later, when the profile loads. Merges with what is already stored.
await Encore.shared.setUserAttributes(
EncoreUserAttributes(countryCode: 'US', language: 'en'),
);
identify() after a successful login. On logout, call reset() to clear the user ID and attributes.