Setting the Dojo djConfig variable in XPages

Last year I wrote about how to load
the Firebug Lite debugger in Internet Explorer
by downloading
the javascript files and adding them into your xPages application. At the
time I mentioned that Dojo contains a version of Firebug Lite but that
there was currently no method to enable it.

With Lotus Domino 8.5.1 we can now use
the built in Firebug Lite. To turn it on you need to get the Xpages parser
to add isDebug:true to the djConfig line that it uses to load the base
Dojo javascript files. The way to do this is a little hidden away so here
is a step by step…

First of all open the application that
you want to add the Firbug Lite console to in your Domino Designer client.
We then need to open the package explorer view. This is an eclipse view
that is not part of the Domino Designer perspective so to open this view
click on the ‘Window – Show Eclipse Views – Other’ menu. In the dialog
that pops up scroll down to ‘Java’, expand it out and then select ‘Package

A picture named M2

A new eclipse view should open, probably
on the right of your screen where the the list of controls appears when
your editing an xPage. You will see a set of folders that kinda matchup
to the different design elements in the Domino Designer perspective along
with a few extra folders. the one we are interested in is a file called and it is inside the WebContentWEB-INF folder.

A picture named M3

Opening this file will show you all
of the xsp properties in effect for this application. Most of them you
will recognize from the Application Properties dialog. To set the djConfig
line just add in xsp.client.script.dojo.djConfig= and put in the additional
values that you desire, so for the Firebug Lite you add in isDebug:true.

A picture named M4

Now you just close and save that tab
and Firebug Lite will automatically load in any web browser that supports

Just don’t forget to take the value
out before releasing your code to end users, I’m sure they won’t want to
be seeing a debug console all the time.

Tagged with: , , ,
Posted in None
4 comments on “Setting the Dojo djConfig variable in XPages
  1. If you do advanced work with Xpages, you find yourself opening up the Package Explorer a lot. You could switch perspectives all the time if you want, or you could go to the Window menu each time, but here’s something much simpler…Once you’ve opened the Package Explorer in Designer, go to Window – Save Perspective As, and then select Domino Designer. That will keep the Package Explorer available to you permanently.Not long after I did this, I also found myself adding the Progress tab as a sibling to the “Problems” tab on the bottom and saving it. That way, any time I do a Project – Build or Project – Clean, I can switch to that tab and keep track of what’s going on.


  2. Michael Oliphant says:

    Hi,I don’t have listed in my WEB-INF folder. Any ideas why? My install is 8.5.1 Windows 7 Domino Designer without a server connection.Many thanks.


  3. John Smart says:

    Declan: Your last sentence confused me, I thought this property was per client, so changing this wouldn’t affect my users.@2: You can also change it in your NotesDataDirectory/properties/ file.If you don’t have an file, create one using Notepad. Mine says:# from


  4. Firebug Lite says:

    Thanks for the info! Having read your article, I decided to search for some additional info and managed to find a video on Installing Firebug Lite on Internet Explorer. Hope someone will find it useful


Comments are closed.

%d bloggers like this: