Welcome to the official BlackBerry Support Community Forums.

This is your resource to discuss support topics with your peers, and learn from each other.

inside custom component

BlackBerry® World™ Development

Invoke BlackBerry® World™ from a web page

by Retired on ‎02-16-2010 04:11 PM - edited on ‎01-21-2013 04:03 PM by Retired (4,565 Views)



This article applies to the following:

  • BlackBerry® World™ storefront

  • BlackBerry® Browser
  • BlackBerry® Device Software 4.2 and later
  • BlackBerry smartphones with trackballs or SurePress™ touch screens
  • Web content development




BlackBerry® World™ can be launched from the BlackBerry Browser by creating a link on your web page to a file that has a file name extension of .bbaw and contains the App World ID of the application to be launched.


When a BlackBerry smartphone user clicks on the .bbaw file from the BlackBerry Browser, BlackBerry World is invoked and the details page for the corresponding application is loaded.


This feature is only available when accessing a web page from the BlackBerry smartphone. Therefore, your web site should only present a link to the .bbaw file when accessed from a BlackBerry smartphone. Currently, BlackBerry World is only available to select countries and wireless service providers.



  • Configure your web server to accept a .bbaw file by defining a new BlackBerry World mime type as follows:

    Apache Tomcat

  • Use a text editor to open the web.xml file that is located in the conf folder of the Tomcat directory.
  • Add the following mapping definition to the Default MIME Type Mappings section:




  • Save the web.xmlfile.

    Microsoft® Internet Information Services

  • On the Start menu, open IIS.
  • Right-click Default Web Site, and then select Properties.
  • Select the HTTP Headers tab.
  • In the MIME Map section, click the File Types … button.
  • Click the New Type … button.
  • In the Associated extension field, type bbaw.
  • In the Content type (MIME) field, type application/x-bb-appworld.
  • Click OK.
  • Create a plain text file with a file extension of .bbaw that contains your application ID. The application ID should be the only value in the file and it should be on the first line with no other information. There should be no whitespace before or after the application ID.

    You can identify the value of your application's ID from the vendor portal. In Manage Applications, open your application and look for a 3 or 4-digit number after the contentID= value in the web address.

    This file should be deployed on your web server.

    The following is an example of an application ID in an app.bbaw file:


  • Create a link on your web page to your .bbaw file as shown in the following example:



    <body><a href="app.bbaw">View My Application </a></body>


Users Online
Currently online: 28 members 1,572 guests
Please welcome our newest community members: