In this section, you will learn how to use the Jovo User class to persist user specific data and create contextual experiences for your voice apps.

Introduction to the User Class

The User object offers helpful features to build contextual, user specific experiences into your voice applications.

You can access the user object like this:


There are certain configurations that can be changed when dealing with the user object. The following are part of the Jovo default configuration and can be changed in the config.js file:

Database Integrations

Learn more about all available database integrations here.

The Jovo User object uses database integrations to persist data across sessions. By default, the file-based system will be used so you can start right away when prototyping locally.

Also, by default the framework will write to the database with every user interaction (request & response). To enable data caching, i.e. only write to the database if the state of it has changed between the request and the response, you have to add the following to your configuration file:

Below, learn more about operations you can do for user-specific data:

Save Data

This will save data with your user's userID as a mainKey, and a key and a value specified by you.

Load Data

After you saved data, you can use a key to retrieve a value from the database.

Delete a User

This will delete your whole user's data (the mainKey) from the database.

Meta Data

The user object meta data is the first step towards building more contextual experiences with the Jovo Framework. If the feature is enabled, the following data is automatically stored inside your database:

Meta Data Usage Description
createdAt this.$user.$metaData.createdAt Timestamp: When the user first used your app
lastUsedAt this.$user.$metaData.lastUsedAt Timestamp: The last time your user interacted with your app
sessionsCount this.$user.$metaData.sessionsCount Timestamp: How often your user engaged with your app

You can enable meta data like this:

You can also overwrite any other of the default configurations:


The user context is used to automatically store data from past interaction pairs (request and response) inside an array. To be able to use this feature, a database integration is required (data is stored in the FilePersistence db.json by default, but for e.g. AWS Lambda it is important to set up DynamoDB).

User context can be enabled like this:

This works like pagination. The most recent request and response pair is stored at this.$user.$context.prev[0].

Right now, the following data can be accessed (with index i):

Category Data Usage Description
Request intent this.$user.$context.prev[i].request.intent this.$user.getPrevIntent(i) String: Intent name
  state this.$user.$context.prev[i].request.state this.$user.getPrevRequestState(i) String: State name
  sessionId this.$user.$context.prev[i].request.sessionId   String: Session Id
  timestamp this.$user.$context.prev[i].request.timestamp this.$user.getPrevTimestamp(i) String: Timestamp of request
  inputs this.$user.$context.prev[i].request.inputs this.$user.getPrevInputs(i) Object: Contains all the slots (filled & unfilled). Example: You got a slot called city. Access the value with this.$user.getPrevInputs(i).city.value.
Response speech this.$user.$context.prev[i].response.speech this.$user.getPrevSpeech(i) String: Primary speech element
  reprompt this.$user.$context.prev[i].response.reprompt this.$user.getPrevReprompt(i) String: Reprompt element
  state this.$user.$context.prev[i].response.state this.$user.getPrevResponseState(i) String: State name

The default configuration looks like this:

You can freely adjust how many of these request-response pairs should be saved by changing the array size in your app's config to an Integer equal to or bigger than 0.

You can also decide what you want to save and what not. Simply change the value of the unwanted data to false:

Session Data

Some platforms do not provide the ability to persist data throughout a session. In that case, you can save the data in the database. Other platforms, e.g. Twilio Autopilot, need to save the session ID in the database for the NEW_SESSION built-in intent to work.

You can enable both in your project's configuration:

If the feature is enabled, the database entry will have the following structure:

It is also possible to provide dataKey which changes the key under which the data gets saved:

This is helpful, because some database-integrations like MongoDB do not allow special characters like $ as field names.

This will cause the database-entry to have the following structure:


The updatedAt column allows you to store the last time the database entry was updated at (String ISO 8601 format).

The option is disabled by default, but you can enable it inside your config file the following way:

User ID

Returns user ID on the particular platform, either Alexa Skill User ID or Google Actions User ID:

This is going to return an ID that looks like this:

Note: Google Action user IDs are generated by Jovo and stored in the Google Action user storage. Learn more about the process here.


Returns the platform's locale:

Comments and Questions

Any specific questions? Just drop them below or join the Jovo Community Forum.

Join Our Newsletter

Be the first to get our free tutorials, courses, and other resources for voice app developers.