This documentation is for WSO2 Message Broker 3.0.0. View documentation for the latest release.
Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Adding topics from the management console

To create a new topic using the management console:

  1. Log in to the management console.
  2. In the Main tab, click Topics -> Add. The Add Topic screen will open.
  3. Enter a name for the topic in the Topic field. 


    Topic name can starts with any of the following: * or any alphanumeric character (a-z A-Z 0-9) any number of times, delimited by dots. Topic name can ends with the following: * , any alphanumeric character or with a hash (#).  The “/” symbol (TENANT_SEPARATOR) can only be used to separate the tenant domain from the topic name when creating topics/subscribing to topics from external clients.

  4. Now you need to grant permissions for users in your system to publish and subscribe to the topic you are creating. You will be granting these permissions to users based on the user's role. As shown below, all the user roles in your tenant domain will be listed. You can select the relevant check box against each role:
    • If the Subscribe check box is selected, the users linked to the role has permission to subscribe to the topic.
    • If the Publish check box is selected, the users linked to the role has permission to publish information to the topic.
    If you want to create new user roles for topic subscription and publishing see the documentation on creating users and roles.


    The user that creates a topic in the system is by default granted permission to Subscribe and Publish to that particular topic. This is handled in the system by automatically creating an internal role and assigning it to the user creating the topic.

  5. Click Add Topic to create the topic.
  6. If the topic is added successfully, a message appears. Click OK to view the topic browser where the newly added topic is listed in a tree view:
    Topic Browser
    Topic Browser
  7. Click on the topic to view all the operations available. See the section on viewing topic details for more information.