Custom User Data - iOS SDK¶
On this page
Read a User’s Custom Data¶
You can read the custom user data of a
currently logged in user through that user's
User object. You cannot
edit custom user data through a
User object. To edit custom user
data, see Update Custom User Data. To read the data, access the
customData property on the
User object of a logged in user:
MongoDB Realm does not dynamically update the value of the client-side user custom data document immediately when underlying data changes. Instead, MongoDB Realm fetches the most recent version of custom user data whenever a user refreshes their access token, which is used by most SDK operations that contact the MongoDB Realm back end. If the token is not refreshed before its default 30 minute expiration time, Realm refreshes the token on the next call to the backend, so custom user data could be stale for up to 30 minutes plus the time until the next SDK call to the backend occurs.
If you require the most recent version of custom user data, use the refreshCustomDataWithCompletion method to request the latest version of a user's custom data.
Create a User’s Custom Data Document¶
To create custom user data for a user, create a MongoDB document in the custom user data collection. The user ID field of the document should contain the the user's user ID.
In the Realm UI, check the App Users page under the Custom User Data tab to find and configure custom user data settings, including:
- The custom user data cluster, database, and collection
- The user ID field used to map custom user data documents to users
The following example uses MongoDB Remote Access to insert a document containing the user ID
of the currently logged in user and a
favoriteColor value into the
custom user data collection:
You can add any number of arbitrary fields and values to the custom user
data document when you create it. The user ID field is the only
requirement for the document to become available on the
as custom user data.
Update a User’s Custom Data¶
To update a user's custom user data with MongoDB Data Access, edit the
MongoDB document whose user ID field contains the user ID of the user.
The following example uses MongoDB Data Access to update the
favoriteColor field of the
the document containing the user ID of the currently logged in user in
the custom user data collection:
To determine a user's ID, access the
User.id property or find the
user in the Realm UI on the App Users page under the