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.


  1. On the Main tab in the management console, click Queues -> Add.
  2. Enter a name for the topic in the Queue Name field. 


    Note the following for queue names:

    • The queue name cannot contain any of following symbols: [email protected]#;%^*()+={}|<>"' or spaces. 
    • Do not include "/"literalsor prefix the name with "tmp_". 
    • The “/” symbol (TENANT_SEPARATOR) can only be used to separate the tenant domain from the queue name when creating queues from external clients.
  3. Now you need to grant permissions for users in your system to publish messages to the queue and consume messages from the queue. 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 Consume check box is selected, the users linked to the role has permission to consume messages from the queue.
    • If the Publish check box is selected, the users linked to the role has permission to publish messages to the queue.

    Image RemovedImage Added
    If you want to create new user roles as queue publishers and queue consumers, see the documentation on creating users and roles.


    By default, publishing and consuming permissions for queues (including JMS client queues) are granted only to the role to which the queue creator belongs. If required, the admin user can change these permissions (Configure > Users and Roles > Roles).

  4. Click Add Queue.

  5. If the queue is added successfully, a message appears. Click OK to view the Queue List where the newly added queue is listed:
    Image RemovedImage Added

Add queues through client subscriptions