- trigger |
- The trigger for a room being joined if known. |
+ kind |
+ Is pin or unpin. |
-
- Invite: Room joined via an invite.
-
-
-
- -
-
- RoomPreview: Room joined via its preview.
-
-
-
- -
-
- SlashCommand: Room joined via the /join slash command.
-
-
-
- -
-
- RoomDirectory: Room joined via the public rooms directory.
-
-
-
- -
-
- SpaceHierarchy: Room joined via the space hierarchy view.
-
-
-
- -
-
- Timeline: Room joined via a timeline pill or link in another room.
-
-
-
- -
-
- Notification: Room joined via a push/desktop notification.
+ Pin: Pin a message.
-
- MobilePermalink: Room joined via link.
+ Unpin: Unpin a message.
@@ -531,8 +618,65 @@ JoinedRoom
- PollVote
- Triggered when a poll vote has been cast.
+ CallEnded
+ Triggered when a call has ended.
+
+
+
+ Property |
+ Description |
+ Type |
+
+
+
+
+
+ durationMs |
+ The duration of the call in milliseconds. |
+
+
+ integer
+
+ |
+
+
+
+ isVideo |
+ Whether its a video call or not. |
+
+
+ boolean
+
+ |
+
+
+
+ numParticipants |
+ Number of participants in the call. |
+
+
+ integer
+
+ |
+
+
+
+ placed |
+ Whether this user placed it. |
+
+
+ boolean
+
+ |
+
+
+
+
+
+
+
+ PollEnd
+ Triggered when a poll has been ended.
@@ -558,8 +702,8 @@ PollVote
- WebPanelResize
- Triggered when the user resizes a layout panel.
+ Composer
+ Triggered when the user sends a message via the composer.
@@ -571,57 +715,69 @@ WebPanelResize
- panel |
- The panel that was resized. |
+ inThread |
+ Whether the user was using the composer inside of a thread. |
-
-
+
+ boolean
|
- roomType |
- The type of room the user is viewing when resizing the panel. |
+ isEditing |
+ Whether the user's composer interaction was editing a previously sent event. |
+
+
+ boolean
+
+ |
+
+
+
+ isReply |
+ Whether the user's composer interaction was a reply to a previously sent event. |
+
+
+ boolean
+
+ |
+
+
+
+ messageType |
+ The type of the message. |
-
- video_room
+ Text: A text message.
-
- maximised_widget
+ LocationPin: A pin drop location message.
-
- user_profile
+ LocationUser: A user current location message.
-
- space
+ Poll: A poll message.
-
- other_room
+ VoiceMessage: A voice message.
@@ -631,11 +787,11 @@ WebPanelResize
|
- size |
- The size to which the user has resized the panel in pixels. |
+ startsThread |
+ Whether this message begins a new thread or not. |
- integer
+ boolean
|
@@ -645,8 +801,8 @@ WebPanelResize
- PollCreation
- Triggered when a poll is created or edited.
+ Signup
+ Triggered once onboarding has completed, but only if the user registered a new account.
@@ -658,94 +814,57 @@ PollCreation
- action |
- Whether this poll has been created or edited. |
+ authenticationType |
+ The type of authentication that was used to sign up. |
-
- Create: Newly created poll.
+ Password: Registration with a username and password.
-
- Edit: Edit of an existing poll.
+ Apple: Social login using Apple.
-
-
- |
-
-
-
- isUndisclosed |
- Whether this poll is undisclosed. |
-
-
- boolean
-
- |
-
-
-
- numberOfAnswers |
- Number of answers in the poll. |
-
-
- integer
-
- |
-
-
-
-
-
-
-
- ViewRoom
- Triggered when the user changes rooms.
-
-
-
- Property |
- Description |
- Type |
-
-
-
-
-
- activeSpace |
- active space when user navigated to the room. |
-
-
-
+ -
+
+ Facebook: Social login using Facebook.
+
+
-
- Home: Active space is Home.
+ GitHub: Social login using GitHub.
-
- Private: Active space is a private space.
+ GitLab: Social login using GitLab.
-
- Public: Active space is a public space.
+ Google: Social login using Google.
-
- Meta: Active space is a meta space.
+ SSO: Registration using another SSO provider.
+
+
+
+ -
+
+ Other: Registration using some other mechanism such as fallback.
@@ -754,790 +873,628 @@ ViewRoom
|
-
- isDM |
- Whether the room is a DM. |
+
+
+
+
+
+ PerformanceTimer
+ Triggered after timing an operation in the app.
+
+
+
+ Property |
+ Description |
+ Type |
+
+
+
+
+
+ context |
+ Client defined, can be used for debugging. |
- boolean
+ string
|
- isSpace |
- Whether the room is a Space. |
+ itemCount |
+ Client defined, an optional value to indicate how many items were handled during the operation. |
- boolean
+ integer
|
- trigger |
- The reason for the room change if known. |
+ name |
+ The timer that is being reported. |
-
- Created: Room accessed due to being just created.
+ StartupInitialSync: The duration of an initial /sync request during startup (if the store has been wiped). In this case, `itemCount` should contain the number of joined rooms.
-
- RoomList: Room accessed via the room list.
+ StartupIncrementalSync: The duration of a regular /sync request when resuming the app. In this case, `itemCount` should contain the number of joined rooms in the response.
-
- RoomDirectory: Room accessed via the public rooms directory.
+ StartupStorePreload: The time to preload data in the MXStore on iOS. In this case, `itemCount` should contain the number of rooms in the store.
-
- SpaceHierarchy: Room accessed via the space hierarchy view.
+ StartupStoreReady: The time to load all data from the store (including StartupStorePreload time). In this case, `itemCount` should contain the number of rooms loaded into the session
-
- Timeline: Room accessed via a timeline pill or link in another room.
+ StartupLaunchScreen: How long the app launch screen is displayed for.
-
- Notification: Room accessed via a push/desktop notification.
+ InitialSyncRequest: The time spent waiting for a response to an initial /sync request. In this case, `itemCount` should contain the number of joined rooms.
-
- Tombstone: Room accessed via a tombstone at the bottom of a predecessor room.
+ InitialSyncParsing: The time spent parsing the response from an initial /sync request. In this case, `itemCount` should contain the number of joined rooms.
-
- Predecessor: Room accessed via the predecessor link at the top of the upgraded room.
+ NotificationsOpenEvent: The time taken to display an event in the timeline that was opened from a notification.
+
+
+ |
+
+
+
+ timeMs |
+ The time reported by the timer in milliseconds. |
+
+
+ integer
+
+ |
+
+
+
+
+
+
+
+ CallError
+ Triggered when an error occurred in a call.
+
+
+
+ Property |
+ Description |
+ Type |
+
+
+
+
+
+ isVideo |
+ Whether its a video call or not. |
+
+
+ boolean
+
+ |
+
+
+
+ numParticipants |
+ Number of participants in the call. |
+
+
+ integer
+
+ |
+
+
+
+ placed |
+ Whether this user placed it. |
+
+
+ boolean
+
+ |
+
+
+
+
+
+
+
+ CryptoSessionState
+ Describe the current session crypto state, that is if the session is verified or not, if recovery is correctly setup.
+
+
+
+ Property |
+ Description |
+ Type |
+
+
+
+
+
+ recoveryState |
+ |
+
+
+
+
-
- Widget: Room switched due to widget interaction.
+ Enabled: Secret storage is set up and we have all the secrets locally.
-
- MessageSearch: Room switched due to user interacting with a message search result.
+ Disabled: No default secret storage key exists or it is disabled explicitly using the account data event.
-
- MessageUser: Room switched due to user selecting a user to go to a DM with.
+ Incomplete: Secret storage is set up but we're missing some secrets.
+
+
+ |
+
+
+
+ verificationState |
+ |
+
+
+
+
-
- VerificationRequest: Room switched due to user interacting with incoming verification request.
+ Verified: The device is considered to be verified, it has been signed by its user identity.
-
- SlashCommand: Room accessed via a slash command in Element Web/Desktop like /goto.
+ NotVerified: The device is unverified.
+
+
+ |
+
+
+
+
+
+
+
+ $screen
+ Triggered when the user changed screen on Element Android/iOS.
+
+
+
+ Property |
+ Description |
+ Type |
+
+
+
+
+
+ durationMs |
+ How long the screen was displayed for in milliseconds. |
+
+
+ integer
+
+ |
+
+
+
+ screenName |
+ |
+
+
+
+
-
- Shortcut: Room accessed via a shortcut.
+ Home: The Home tab on iOS | possibly the same on Android?
-
- WebNotificationPanel: Room accessed via Element Web/Desktop's notification panel.
+ Welcome: The splash screen.
-
- WebKeyboardShortcut: Room accessed via an Element Web/Desktop keyboard shortcut like go to next room with unread messages.
+ Login: The screen that displays the login flow (when the user already has an account).
-
- WebHorizontalBreadcrumbs: Room accessed via the Element Web/Desktop horizontal breadcrumbs at the top of the room list.
+ ForgotPassword: The form for the forgot password use case.
-
- WebVerticalBreadcrumbs: Room accessed via the Element Web/Desktop vertical breadcrumb hover menu.
+ Register: The screen that displays the registration flow (when the user wants to create an account).
-
- WebAcceptCall: Room switched due to accepting a call in a different room in Element Web/Desktop.
+ Room: The screen that displays the messages and events received in a room.
-
- WebDialPad: Room switched due to making a call via the dial pad in Element Web/Desktop.
+ RoomDetails: The screen shown when tapping the name of a room from the Room screen.
-
- WebForwardShortcut: Room accessed via the shortcut in Element Web/Desktop's forward modal.
+ RoomMembers: The screen that displays the list of members that are part of a room.
-
- WebUnifiedSearch: Room accessed via Element Web/Desktop's Unified Search modal.
+ User: A screen that shows information about a room member.
-
- WebPredecessorSettings: Room accessed via the predecessor link in Settings > Advanced in Element Web/Desktop.
+ RoomSearch: The screen that allows you to search for messages/files in a specific room.
-
- WebSpaceContextSwitch: Room switched due to the user changing space in Element Web/Desktop.
+ RoomUploads: The screen that allows you to see all of the files sent in a specific room.
-
- WebRoomListNotificationBadge: Room accessed via clicking on a notifications badge on a room list sublist in Element Web/Desktop.
+ RoomSettings: The settings screen shown from the Room Details screen.
-
- WebSpacePanelNotificationBadge: Room accessed via clicking on the notifications badge on the currently selected space in Element Web/Desktop.
+ RoomNotifications: The notifications settings screen shown from the Room Details screen.
-
- WebFloatingCallWindow: Room accessed via interacting with the floating call or Jitsi PIP in Element Web/Desktop.
+ RoomAddresses: The room addresses screen shown from the Room Details screen.
-
- WebThreadsActivityCentre: Room accessed via interacting with the Threads Activity Centre in Element Web/Desktop.
+ RoomPermissions: The roles permissions screen shown from the Room Details screen.
-
- MobileFileSearch: Room switched due to user interacting with a file search result.
+ RoomDirectory: The screen that lists public rooms for you to discover.
-
- MobileRoomSearch: Room switched due to user interacting with a room search result.
+ RoomFilter: The screen that lists all the user's rooms and let them filter the rooms.
-
- MobileSearchContactDetail: Room accessed via interacting with direct chat item in the search contact detail screen.
+ StartChat: The screen shown to create a new direct room.
-
- MobileRoomMemberDetail: Room accessed via interacting with direct chat item in the room contact detail screen.
+ CreateRoom: The screen shown to create a new (non-direct) room.
-
- MobileSpaceMemberDetail: Room accessed via interacting with direct chat item in the space contact detail screen.
+ DeactivateAccount: The confirmation screen shown before deactivating an account.
-
- MobileInCall: Room accessed via interacting with the incall screen.
+ Group: Legacy: The screen that shows information about a specific group.
-
- MobileSpaceMenu: Space accessed via interacting with the space menu.
+ MyGroups: Legacy: The screen that shows all groups/communities you have joined.
-
- MobileSpaceSettings: Space accessed via interacting with a space settings menu item.
+ SpaceExploreRooms: Screen that displays the list of rooms and spaces of a space.
-
- MobileRoomPreview: Room accessed via preview.
+ Sidebar: The sidebar shown on mobile with spaces, settings etc.
-
- MobilePermalink: Room accessed via link.
+ Favourites: The Favourites tab on mobile that lists your favourite people/rooms.
-
- MobileLinkShare: Room accessed during external sharing.
+ People: The People tab on mobile that lists all the DM rooms you have joined.
-
- MobileExploreRooms: Room accessed via space explore.
+ Rooms: The Rooms tab on mobile that lists all the (non-direct) rooms you've joined.
-
- MobileSpaceMembers: Room accessed via space members list.
+ Dialpad: The tab on mobile that displays the dialpad.
-
- MobileSpaceBottomSheet: Room accessed via space bottom sheet list.
+ SearchRooms: The Rooms tab shown in the global search screen on Mobile.
-
-
- |
-
-
-
- viaKeyboard |
- Whether the interaction was performed via the keyboard input. |
-
-
- boolean
-
- |
-
-
-
-
-
-
-
- NotificationTroubleshoot
- Triggered when the user runs the troubleshoot notification test suite.
-
-
-
- Property |
- Description |
- Type |
-
-
-
-
-
- hasError |
- Whether one or more tests are in error. |
-
-
- boolean
-
- |
-
-
-
-
-
-
-
- PinUnpinAction
- Triggered when the users pin or unpins a message.
-
-
-
- Property |
- Description |
- Type |
-
-
-
-
-
- from |
- From where the action is triggered. |
-
-
-
-
-
- Timeline: Action triggered from the timeline.
+ SearchMessages: The Messages tab shown in the global search screen on Mobile.
-
- MessagePinningList: Action triggered from the menu item in message pinning list.
+ SearchPeople: The People tab shown in the global search screen on Mobile.
-
- UnpinAll: Action triggered from the Unpin all button in message pinning list.
+ SearchFiles: The Files tab shown in the global search screen on Mobile.
-
-
- |
-
-
-
- kind |
- Is pin or unpin. |
-
-
-
-
-
- Pin: Pin a message.
+ SwitchDirectory: The screen shown to select which room directory you'd like to use.
-
- Unpin: Unpin a message.
+ InviteFriends: The screen shown to share a link to download the app.
-
-
- |
-
-
-
-
-
-
-
- CallStarted
- Triggered when a call is started.
-
-
-
- Property |
- Description |
- Type |
-
-
-
-
-
- isVideo |
- Whether its a video call or not. |
-
-
- boolean
-
- |
-
-
-
- numParticipants |
- Number of participants in the call. |
-
-
- integer
-
- |
-
-
-
- placed |
- Whether this user placed it. |
-
-
- boolean
-
- |
-
-
-
-
-
-
-
- PollEnd
- Triggered when a poll has been ended.
-
-
-
- Property |
- Description |
- Type |
-
-
-
-
-
- doNotUse |
- Do not use this. Remove this property when the kotlin type generator can properly generate types without properties other than the event name. |
-
-
- boolean
-
- |
-
-
-
-
-
-
-
- UserProperties
- The user properties to apply when identifying. This is not an event definition. These properties must all be device independent.
-
-
-
- Property |
- Description |
- Type |
-
-
-
-
-
- WebLayout |
- Which layout the user is using in Element Web/Desktop. This is known to clobber between devices. |
-
-
-
-
-
- IRC: IRC layout.
+ Breadcrumbs: The screen that displays the user's breadcrumbs.
-
- Bubble: Bubble layout.
+ Settings: The global settings screen shown in the app.
-
- Group: Modern layout.
+ SettingsSecurity: The global security settings screen.
-
- Compact: Modern layout with compact option enabled.
+ SettingsDefaultNotifications: The settings screen to change the default notification options.
-
-
- |
-
-
-
- WebMetaSpaceFavouritesEnabled |
- Whether the user has the favourites space enabled. |
-
-
- boolean
-
- |
-
-
-
- WebMetaSpaceHomeAllRooms |
- Whether the user has the home space set to all rooms. |
-
-
- boolean
-
- |
-
-
-
- WebMetaSpaceHomeEnabled |
- Whether the user has the home space enabled. |
-
-
- boolean
-
- |
-
-
-
- WebMetaSpaceOrphansEnabled |
- Whether the user has the other rooms space enabled. |
-
-
- boolean
-
- |
-
-
-
- WebMetaSpacePeopleEnabled |
- Whether the user has the people space enabled. |
-
-
- boolean
-
- |
-
-
-
- allChatsActiveFilter |
- The active filter in the All Chats screen. |
-
-
-
-
-
- All: Filters are activated and All is selected.
+ SettingsGeneral: The settings screen with general profile settings.
-
- Unreads: Filters are activated and Unreads is selected.
+ NotificationTroubleshoot: The screen containing tests to help user to fix issues around notifications.
-
- Favourites: Filters are activated and Favourites is selected.
+ SettingsNotifications: The notifications settings screen.
-
- People: Filters are activated and People is selected.
+ SettingsPreferences: The preferences screen (theme, language, editor preferences, etc.
-
-
- |
-
-
-
- ftueUseCaseSelection |
- The selected messaging use case during the onboarding flow. |
-
-
-
-
-
- PersonalMessaging: The first option, Friends and family.
+ SettingsVoiceVideo: The calls settings screen.
-
- WorkMessaging: The second option, Teams.
+ SettingsIgnoredUsers: The settings screen with list of the ignored users.
-
- CommunityMessaging: The third option, Communities.
+ SettingsLabs: The experimental features settings screen.
-
- Skip: The footer option to skip the question.
+ SettingsAdvanced: The advanced settings screen (developer mode, rageshake, push notification rules).
-
-
- |
-
-
-
- numFavouriteRooms |
- Number of joined rooms the user has favourited. |
-
-
- integer
-
- |
-
-
-
- numSpaces |
- Number of spaces (and sub-spaces) the user is joined to. |
-
-
- integer
-
- |
-
-
-
- recoveryState |
- Describe the current session recovery state, that if 4S is setup, complete (all secrets cached) or not. |
-
-
-
-
-
- Enabled: Secret storage is set up and we have all the secrets locally.
+ SettingsHelp: The Help and About screen.
-
- Disabled: No default secret storage key exists or it is disabled explicitly using the account data event.
+ SettingsLegals: The settings screen with legals information.
-
- Incomplete: Secret storage is set up but we're missing some secrets.
+ SettingsMentionsAndKeywords: The settings screen to manage notification mentions and keywords.
-
-
- |
-
-
-
- verificationState |
- Describe the current session verification state, that is if the session is verified or not. |
-
-
-
+ -
+
+ SpaceMenu: The bottom sheet that list all space options.
+
+
-
- Verified: The device is considered to be verified, it has been signed by its user identity.
+ SpaceMembers: Screen that displays the list of members of a space.
-
- NotVerified: The device is unverified.
+ RoomPreview: Screen that displays room preview if user hasn't joined yet.
-
-
- |
-
-
-
-
-
-
-
- Signup
- Triggered once onboarding has completed, but only if the user registered a new account.
-
-
-
- Property |
- Description |
- Type |
-
-
-
-
-
- authenticationType |
- The type of authentication that was used to sign up. |
-
-
- | |