Categories
Prev |  | Next

## Categories

Notifications can optionally have a type indicator. Although neither client or nor server must support this, some may choose to. Those servers implementing categories may use them to intelligently display the notification in a certain way, or group notifications of similar types.

Categories are in ``class.specific`` form. `class` specifies the generic type of notification, and `specific` specifies the more specific type of notification.

If a specific type of notification does not exist for your notification, but the generic kind does, a notification of type ``class`` is acceptable.

Third parties, when defining their own categories, should discuss the possibility of standardizing on the hint with other parties, preferably in a place such as the xdg mailing list at freedesktop.org. If it warrants a standard, it will be added to the table above. If no consensus is reached, the category should be in the form of "`x-`vendor`.`class`.`name``."

The following table lists standard notifications as defined by this spec. More will be added in time.

Table 2. Categories

Type | Description
--- | ---
`"device"` | A generic device-related notification that doesn't fit into any other category.
`"device.added"` | A device, such as a USB device, was added to the system.
`"device.error"` | A device had some kind of error.
`"device.removed"` | A device, such as a USB device, was removed from the system.
`"email"` | A generic e-mail-related notification that doesn't fit into any other category.
`"email.arrived"` | A new e-mail notification.
`"email.bounced"` | A notification stating that an e-mail has bounced.
`"im"` | A generic instant message-related notification that doesn't fit into any other category.
`"im.error"` | An instant message error notification.
`"im.received"` | A received instant message notification.
`"network"` | A generic network notification that doesn't fit into any other category.
`"network.connected"` | A network connection notification, such as successful sign-on to a network service. This should not be confused with `device.added` for new network devices.
`"network.disconnected"` | A network disconnected notification. This should not be confused with `device.removed` for disconnected network devices.
`"network.error"` | A network-related or connection-related error.
`"presence"` | A generic presence change notification that doesn't fit into any other category, such as going away or idle.
`"presence.offline"` | An offline presence change notification.
`"presence.online"` | An online presence change notification.
`"transfer"` | A generic file transfer or download notification that doesn't fit into any other category.
`"transfer.complete"` | A file transfer or download complete notification.
`"transfer.error"` | A file transfer or download error.

Prev |  | Next
Icons and Images | Home | Urgency Levels