Preferences

Preferences allow you to store settings like theme choice, language selection, or notification preferences that are specific to individual users or shared across teams.

User preferences

You can store user preferences on a user's account using Appwrite's Update Preferences endpoint.

Preferences are stored as a key-value JSON object. The maximum allowed size for preferences is 64kB, and an error will be thrown if this limit is exceeded.

Update user preferences

Use the updatePrefs method to store user preferences as a JSON object.

Get user preferences

Retrieve stored preferences with the getPrefs method.

Team preferences

Team preferences let you store settings that apply to an entire team of users. They are well-suited for collaborative features like team-wide themes, notification preferences, or feature toggles.

Team preferences are stored as a JSON object in the team document and are limited to 64kB of data. All team members can access these shared preferences.

Update team preferences

Store team-wide settings using the updatePrefs method with a team ID.

Get team preferences

Fetch team preferences by passing a team ID to the getPrefs method.