How to edit bundled or system plugins

Still need help?

The Atlassian Community is here for you.

Purpose

In rare cases, although not advisable, some users need to edit the contents of the bundled plugin in Confluence. The guide below is an example to find and edit a bundled/system plugin

Customizing the Contents of Bundled Plugin

Please note that this will only work if the bundled plugin has not been upgraded

1. Backup atlassian-bundled-plugins folder in <confluence-install>/confluence/WEB-INF/. This folder contains all of the Confluence bundled plugins.

2. Locate the JAR file of the bundled plugin and unjar the plugin-name-X.X.X.X.jar in the folder atlassian-bundled-plugins.
3. Once unjarred, edit the necessary files and save the edited files

4. Jar the file back to plugin-name-X.X.X.X.jar. Please refer to How to edit files in Confluence JAR files for more information

Customizing the Contents of Upgraded Bundled Plugin

1. Downgrade the bundled plugin by uninstalling it from the Confluence Admin > Managed Add-ons under the User Installed Plugins section
3. Unjar the plugin, edit the necessary files, save the edited files, and jar it back
4. Backup atlassian-bundled-plugins folder in <confluence-install>/confluence/WEB-INF/
5. Delete the old plugin JAR file
6. Insert the new plugin JAR file
7. Upload the new plugin JAR file into Confluence

Customizing the Contents of Bundled Plugin

Please note that this will only work if the bundled plugin has not been upgraded

1. Backup atlassian-bundled-plugins.zip in <confluence-install>/confluence/WEB-INF/classes/com/atlassian/confluence/setup/. This zip file contains all of the Confluence bundled plugins.

2. Unzip the atlassian-bundled-plugins.zip.
3. Locate the JAR file of the bundled plugin and unjar the plugin-name-X.X.X.X.jar in the unzipped atlassian-bundled-plugins.zip.
4. Once unjarred, edit the necessary files and save the edited files

5. Jar the file back to plugin-name-X.X.X.X.jar. Please refer to How to edit files in Confluence JAR files for more information
6. Zip the atlassian-bundled-plugins.zip back.

Customizing the Contents of Upgraded Bundled Plugin

1. Downgrade the bundled plugin by uninstalling it from the Confluence Admin > Plugins under the User Installed Plugins section
3. Unjar the plugin, edit the necessary files, save the edited files, and jar it back
4. Backup atlassian-bundled-plugins.zip in <confluence-install>/confluence/WEB-INF/classes/com/atlassian/confluence/setup/
5. Unzip the atlassian-bundled-plugins.zip.
6. Delete the old plugin JAR file
7. Insert the new plugin JAR file
8. Zip the atlassian-bundled-plugins.zip back.