The Janrain Console User Guide

Welcome to the Janrain Console User Guide. Here you’ll find links to documentation that explores every nook and cranny of the Console, including information on ground-breaking new features such as user search and Console agents. And what if we missed a nook or cranny somewhere along the way? In that case, click the Provide Feedback link off to the right and let us know. We’ll try to fill that documentation hole as quickly as we can.

And if you’re wondering, “OK, but what exactly is the Janrain Console?” you might want to start by taking a peek at the topic Overview of the Janrain Console.

Using the Janrain Console

More About the Janrain Console

What’s New/What’s Cool?

What Would You Like to Know?

I’d like to know …

An Overview of the Janrain Console

The Janrain Console is the next generation of Janrain management tools, and the eventual successor to both the Janrain Dashboard and the Customer Care Portal. Which brings up an important question: what if you’re perfectly content with the Janrain Console and the Customer Care Portal? After all, if the old tools already do everything you need them to (or at least if they seem to do everything you need them to), why would you want to go through the time and trouble required to learn something else? Does the Janrain Console really offer something that these other tools don’t?

Funny you should ask. As it turns out, the Console offers a number of things that its predecessors don’t:

  • A single location for all your management tools, with a unified look and feel.

  • Delegation of administrative authority by using a single mechanism: roles. This differs from the Janrain Dashboard, where access to the Capture Dashboard and to the Engage Dashboard are managed in different places, and by using different methodologies.

  • Full-fledged user profile search capabilities, including the ability to write queries that employ wildcard characters and Boolean operators such AND and OR.

  • The ability to export user profile data. The Console also allows you to export audit data for a specified user; this data provides a blow-by-blow account of every change that has been made to a user profile in the past 90 days, including the identity of the person who made the change, what they changed, and when they changed it.

For more background on the Console, including information on how to access the tool, take a look at these two topics:

Elsewhere in this documentation you’ll find detailed information on all the Console’s features and capabilities, including:

And what if you’ve already started using the Janrain Console, but things aren’t working the way you expected them to? In that case you might want to take a look at the article Frequently Asked Questions About the Janrain Console.

Accessing the Janrain Console

If you’re wondering how you can get access to the Janrain Console, well, here’s the secret: if you hold the admin role in your organization’s Capture Dashboard, then you already have access to the Janrain Console. To start using the Console, just point your web browser towards

Janrain Console Login Screen

From there, log on using the same credentials you use to log on to the Capture Dashboard.

Note. The preceding illustration shows the default Janrain Console logon screen. The logon screen that you see could look slightly different, based on any customizations and modifications that your organization might have made. Note that your URL could different as well, depending on your setup and configuration. See your Janrain representative for more information.

After you log on, and depending on your access credentials, you’ll be able to manage three key aspects of your Janrain implementation:

Note. After logging on to the Console you will automatically be logged out if: 1) 15 minutes have elapsed without you taking any action; or, 2) 8 hours have elapsed since you logged on, regardless of your activity level. So what happens if your session times out? Nothing much: you’ll be logged out, but you can immediately log back in.

See Also

Comparing the Capture Dashboard and the Janrain Console

The Janrain Console will eventually replace both the Capture Dashboard and the Engage Dashboard. As of this writing, however, the Console doesn’t have all the features and capabilities found in the Capture Dashboard, and has none of the features found in the Engage Dashboard. The following table compares Capture Dashboard pages with their Console counterparts:

Capture Dashboard Page Console Page Notes
Analytics N/A Download daily logon activity reports. Not available in the Console.
Schema Manage Schemas Access to your Janrain schemas. The Console provides full access to your schemas, including information about all schema attributes. However, you must be an Administrator to access the Manage Schemas page.
Records Manage Profiles Access to user profile data. The Console provides additional search capabilities well beyond the simple filtering available in the Capture Dashboard. In addition, the Console enables you to download user profile information in either comma-separated value (CSV) or JavaScript Object Notation (JSON) format.
API Clients N/A Access to API client information, including client IDs and secrets. Planned, but not yet available in the Console.
People Manage Agents Manage administrative access. Note that the Console supports different roles and access permissions than the ones found in the Capture Dashboard.
Settings N/A Configure API client settings. Planned, but not yet available in the Console.

See Also

Frequently-Asked Questions About the Janrain Console

You say you’ve got questions about how to use the Janrain Console, questions about why you’re not seeing what you thought you’d see, or why this one error message keeps popping up every time you try to do something? No problem: you’ll find the answers to many of those most-frequently asked questions (and those most-frequently encountered issues) right here.

And if you don’t see your question anywhere on that’s page? In that case, click the Provide Feedback button and send us your question. We’ll post an answer as quickly as we can.

General Management Questions

How do I access the Janrain Console?

Point your web browser towards and then log on using the same credentials you use to log on to the Janrain dashboard.

I logged on to the Janrain Console, but I don’t see the Manage Agents link. Why not?

That usually means that you’ve been assigned the CCP Agent or CCP Agent – Update Only role; users holding those roles won’t see the Manage Agents link. That link is only visible to CCP Agent Managers and Administrators.

For more information about agents and agent roles, see Console Roles and Permissions.

I tried to log on to the Janrain Console, but all I saw was a page with the message You do not have any applications associated with your account. What does that mean?

That means that you haven’t been assigned a Console role. You’ll need to have an Administrator or a CCP Agent Manager assign you a role.

For more information about agents and agent roles, see Console Roles and Permissions.

It’s nice that the creation date for all my user profiles is shown on the Manage Profiles page, but I’d rather see the country that my users are from. Is there any way to change the display?

Yes, there is. In fact, not only can you display any attribute you want in the search results, but you can also display those attributes in any order that you want. All you have to do is modify the user_search_display_fields setting.

For information on how to modify this setting, see Modifying the Search Display Fields.

I’d like to sort my user profiles by last name, but I can’t figure out how to do that. Can I sort profiles by last name?

Yes. (Well, yes but ….) If an attribute has been indexed, you can sort user profiles on that attribute simply by clicking the appropriate column header (for example, Last Name). However, that only applies to attributes that have been indexed; if your search results display an unindexed attribute (such as is not indexed. If you want to sort on a user’s city, you’ll need to have the attribute indexed. And to do that, you’ll need to contact your Janrain representative. Currently neither the Console nor the Janrain Dashboard provides a way for you to index attributes yourself.

For more information on sorting the search results, see Viewing Profiles on the Manage Profiles Page. And for more information on indexed attributes, see What You Can Search On.

How do I set a user’s password at the same time I create their user profile?

You can’t: allowing administrators to set user passwords is not a security best practice. The only password-related activity you can carry out is to access the user’s profile and click Send Password. That sends the user an email that includes a link to a page where they can create their own password.

For more information on setting/resetting user passwords, see Resetting a User Password.

I wanted to delete a couple of inactive user profiles, but I can’t find the Delete Profile button anywhere. Where is it?

Delete Profile is found at the bottom of each user profile:

Delete Profile Link

That said, you won’t see Delete Profile if you hold the CCP Agent – Update Only role. Users with that role can view and modify profiles, but they can can’t create or delete profiles.

Incidentally, user profiles must be deleted one-by-one. At the moment, there is no way (at least not in the Console or the Dashboard) to select a number of profiles and delete all of them in a single operation.

For more information on agents and agent roles, see Console Roles and Permissions.

Searching for User Profiles

I tried to search for a user using the query displayname = “Bob Jones”, but all I got back was the error message The attribute with path ‘displayname’ does not exist. The displayname attribute doesn’t exist?!?

Technically, no, it doesn’t. That’s because letter casing is crucial when it comes to attribute names. As far as the Console is concerned, there is no attribute named displayname; instead, there’s an attribute named displayName (note the uppercase N). Try this query instead:

displayName = "Bob Jones"

For more information on letting casing and when it matters, see Attribute Names.

I tried searching for all the users who live in the state of Oregon, but all I got back was the error message Some fields are not queryable: primaryAddress.stateAbbreviation. What does that mean?

It might not be obvious, but that error message means that you can only search on attributes that have been indexed; by default, primaryAddress.stateAbbreviation is not an indexed (i.e., searchable) attribute. And how are you supposed to know which attributes have been indexed? One easy way to determine that is to click the Searchable fields link on the Manage Profiles page:

Searchable Fields Link

Clicking that link displays a dialog box that lists all your searchable attributes:

Searchable Attributes

But what do you do if you need to search on the primaryAddress.stateAbbreviation attribute? Here’s your answer: contact your Janrain representative and ask him or her to index the attribute for you.

For more information on indexed attributes, see What You Can Search On.

I tried searching for all the users who have Gmail accounts by using this query: email = “*”. All I got back was the error message Some fields are not reverse-queryable: email. What’s the problem here?

The problem here is this: in order to use a wildcard character at the beginning of a string, the attribute you are searching on (in this case, email) must be configured as a reverse-queryable attribute. (Which, for our purposes, simply means that you can use a wildcard at the beginning of a search value that references that attribute.) To have an attribute marked as reverse-queryable, contact your Janrain representative.

For more information on wildcards and how they can (and cannot) be used in the Console, see Wildcard Characters.

I tried searching for all the user accounts created on or after September 25, 2017 using this query: created >= “9/25/2017”, but I got the error message Invalid date string ‘9/25/2017’: expected ISO8601 format. Did I do something wrong?

As a matter of fact, you did do something wrong: you used an invalid format when specifying the date. As the error message states, you need to use the ISO 8601 format when specifying dates and times. With ISO 8601, a simple date is specified like this:


Or, in your case:


To get back the data you were hoping to get back, try this query instead:

created >= "2017-09-25"

For more information about searching for dates in the Janrain Console, see Searching for Datetime Values.

I tried searching for a user using the query uuid = “834-962*”, but all I got back was the error message Invalid UUID string “834-962*”: Expected hexadecimal UUID string. Why did I get this error message?

You got that error message because you can’t search for UUIDs using a wildcard; wildcards are reserved for string values. And what if you aren’t sure about the datatype (e.g., string; integer; Boolean; etc.) used by an attribute? Don’t worry about it; you can find this information on the Manage Schemas page:


For more information on wildcard characters, see Wildcard Characters.

I searched for all the user profiles created after September 25, 2017 (that is, September 26 or later) by using the query created > “2017-09-25”. However, the returned results include users whose profiles were created on September 25. Why?

That’s because, in the Console, the datetime value 2017-09-25 is actually short for this:

2017-09-25 00:00:00.000000

Effectively, that refers to the exact instance at which the date clicked over to September 25th. Any date or time later than that (including, for example, a time one second into September 25th) is greater than your specified date.

To find all the accounts created on September 26, 2017 or later (which is what you really want), use this query instead:

created >= "2017-09-26"

That returns the data you’re looking for.

For more information on searching for datetime values in the Janrain Console, see Searching for Datetime Values.

I want to look at all my user profiles. I tried using the query displayName = “*” but all I got back was an Invalid string %: cannot begin and end with a wildcard error message. How do I display all my user accounts?

You’re getting the “invalid string” error message because you started (and ended) your search value with an asterisk, and that’s not allowed. That said, however, you don’t need to go to that much trouble just to display all of your user accounts; after all, that’s what the Console does by default. If you want to display all your user accounts simply delete any query currently shown in the Search for profiles field. For example, suppose your Search for profiles field currently looks like this:

Resetting the Search Results

Select the query created > “2017-09-25” and then press Delete. As soon as the query is deleted the screen will refresh, and all your user accounts will be displayed.

Exporting User Data

I’m trying to export all my user data, but I’m only getting a subset of those users. Why?

The Console only exports information for the user profiles that currently appear in the search results. For example, suppose you just searched for all the users who live in the state of Oregon, and those profiles are currently displayed in the search results. If you export the data, your export will only include information about the users who live in the state of Oregon. Like we said, you can only export information for the user profiles currently in the search results.

So how do you export information for all your users? To do that, just make sure that all your user profiles appear in the search results. And to do that, select and delete any query currently in the Search for profiles field. With no query in effect, Console displays information for all your users. Export the profiles now, and you’ll get back data for each and every user in your database.

However (and this is an important however), before you export all your user accounts you should read the topic Exporting Profile Information.

I want to export my user data, but I’d like to get back the user’s city and state. How do I do that?

When you export user data in the Janrain Console, you export the data currently shown in the search results. By default, that means you export the following attributes:

  • First Name (givenName)
  • Last Name (familyName)
  • Email (email)
  • Phone (
  • Birthday (birthday)
  • Created (created)

If you want to get back different attributes (such as and/or primaryAddress.stateAbbreviation), you need to reconfigure the search display so that those new attributes show up in the search results. That can be done by modifying the user_search_display_fields setting.

For information on modifying this setting, see Modifying the Search Display Fields.

Managing Agents

Is there a way to limit an agent to a specific set of profiles?

Yes, there is, although there are some limitations on your ability to place these limits, starting with this: you can only restrict agent access to profiles based on the value of a single attribute (per entity type). For example, if you want to allow an agent to only access profiles from Canada, you can select as the “distinguisher field” and then configure Canada as one of the distinguisher values. When configuring the agent’s account, all you have to do is specify that the agent in question can only access profiles where the attribute is set to Canada.


As noted, however, you can only select one such distinguisher field, and this attribute must apply to an entire entity type. What if you wanted to limit some agents to accessing profiles only from Canada and wanted to limit other agents to accessing profiles only from Mexico? That’s fine; you can do that because you only need to work with one attribute ( But what if you wanted to limit some agents to only accessing profiles from Canada, and limit other agents to only accessing profiles from the state of Oregon? That’s something that you can’t do, because that requires two distinguisher fields ( and primaryAddress.stateAbbreviation). The Console only allows you to specify a single distinguisher field.

For more information on limiting access to profiles, see Restricting Agent Activity by Profile Type.

How can I print a list of all my agents?

Well, from within the Console you can’t, not unless you want to print each web page that includes agent information. However, you can export the agent data, load the exported data into an application that can read and format comma-separated value (CSV) files, and then print the agent data from there.

For more information on exporting agent data, see Exporting Agent Data.

I tried to search for all my agents that have an email address that starts with the letter e, but when I typed the e I continued to see all of my agents. Is that the expected behavior?

In this case, yes. The problem you’re running into is the fact that the Manage Agents page uses a very simple, very rudimentary type of searching. When you type the letter e, the Console doesn’t search for agents who have an email address that starts with the letter e; instead, it searches for agents who have that letter anywhere in their email address or display name. (Not just at the beginning, but anywhere.) For example, if you type ed you’ll see email addresses like or; you’ll also see email addresses like or display names like Fred Smith.

Is there a way to work around this issue? Not really; about the best you can do is export all your agent data, then use a different program to sift through the exported information.

For more information on filtering your list of agents, see Filtering for Agents.

Scroll ↓