Last updated Jun 18, 2024

Adding a configuration UI for your plugin

Purpose of the Configuration UI

A plugin can present configurable settings to Atlassian instance administrators. This is useful where your plugin requires configuration or user-specific settings to work.

Here is an example of a plugin which provides a configuration UI:

In Configuring the Plugin Descriptor, we tell you how to create the XML descriptor file for your plugin. In Plugin Modules, we tell you how to define the modules within your plugin. Below is information on defining the links to the configuration UI for your plugin.

To add a configuration link for your plugin as a whole, place a single param element with the name configure.url within the plugin-info element at the top of the plugin descriptor:

    <description>A macro which displays Google maps within a Confluence page.</description>
    <vendor name="Atlassian Software Systems Pty Ltd" url=""/>
    <param name="configure.url">/admin/plugins/gmaps/configurePlugin.action</param>

This param element causes a button with the Configure label to appear in the details view for the plugin in the 'Manage Add-ons' page. The URL value identifies the page the contains the configuration form. For more information about implementing a configuration UI, see the Creating an Admin Configuration Form tutorial.


  • Configuration links are relative to the application.
  • The configuration URL is a link to a separate page, which you have defined using one of the following:
    • A new XWork action that you have defined via an XWork plugin module.
    • Or a servlet defined via a Servlet plugin module.
  • Not all applications support configuration links, so you may need to create a web item link in the administration menu to link to your configuration page.

Rate this page: