New Visualization Tool: Chat Explorer

We are thrilled to announce a new tool within the Stream Chat Dashboard: Chat Explorer. This page of the dashboard is an effective way to visualize the resources that make up your application all in one place. Come here to search specific users, messages, or channels, and click to edit parameters like name or email. This is an especially useful place to come when debugging.

Chat Explorer allows you to create, read, and update certain resources in your application. All actions can be done within this tool when your app is in both production and development mode. The following resources are editable:

  • Channels
  • Users
  • Messages
  • Members

To navigate to the Chat Explorer, log in to your Stream Dashboard, select your app, and click on Explorer from the Chat dropdown:

Don't have an account? Try Stream Chat for free.

Searching and Filtering

The dashboard's Explorer helps you learn more about the chat resources that exist within your application. For example, selecting users will show you all of the currently created users within your app. From here, you can navigate on the ID of a particular user to see more information on it such as role, online status, banned status, etc.

You can interact with the following resources within the Explorer:

  • Users
  • Channels
  • Members of the channel
  • Messages of the channel

The UI allows you to search for certain resources by a specific query parameter, and they will be listed in descending order of created_at date. The magnifying glass icon allows you to start searching, as shown below. By default, this feature searches by ID, but you have the option of changing the query parameter by clicking the filter icon on the right hand side.

The following resources can be searched:

  • Users (defaults to ID, but can change to username or name)
  • Channels (defaults to ID, but can be changed to cid and type)

Note: All searching must be an exact match on the query to return a result.

Updating Existing Resources

To update a resource, click on the value you wish to update, make the edit, and click the enter key to save the changes. When a change is successfully made, the interface will flash green to confirm the update, as shown below:

Not every value within a resource can be updated within the Chat Explorer, so we have outlined a list of items that are not editable. However, we are seeking customer feedback to see which values we should make editable, so if you would like to have the ability to update any of the currently uneditable values for a specific resource, please contact our Technical Product Manager, Nico Lewis, at nico@getstream.io. We would love to hear from you!

The following values cannot be updated on a user:

  • id
  • banned
  • dashboard_ban_channel_cid
  • language
  • role
  • shadow_banned
  • created_at
  • updated_at

The following values cannot be updated on a channel:

  • id
  • role
  • created_at
  • updated_at
  • cid
  • last_message_at
  • member_count
  • config

The following values cannot be updated on a message:

  • id
  • html
  • user
  • attachments
  • latest_reactions
  • own_reactions
  • reaction_counts
  • reactions _scores
  • reply_count
  • cid
  • created_at
  • updated_at
  • mentioned_users
  • pinned_at
  • pinned_by
  • pin_expires

The following values cannot be updated for members:

  • id
  • role
  • created_at
  • updated_at
  • last_active
  • banned

Creating New Resources

To create an entirely new resource, navigate to its type (Channels, Users, or Members) within the Explorer, and click the ‘+’ icon. This will present you with a modal where you can fill in information for the newly created resource.

The following resources can all be created within the Explorer:

  • Users
  • Channels
  • Members

Deleting Resources

Deleting resources is currently under development.

For a more technical overview of this feature, visit our github, and if you want to watch a video walkthrough that highlights the functionality of this tool, click here. Again, contact Nico Lewis at nico@getstream.io for feedback on the updatable values.