Customizing Fisheye and Crucible Look and Feel
Please Note:
- The Atlassian Support Offering does not cover the customizations described on this page. Assistance may be obtained through the Atlassian community from answers.atlassian.com or from an Atlassian Expert.
- The customizations mentioned in this article do not survive product upgrades.
- After upgrading, customized files from the old installation must not be copied over to the new installation. Changes need to be redone instead.
General instructions:
- In order to customize Fisheye and Crucible look and feel, you will need to edit specific CSS files.
- These CSS files are located inside the
<Fisheye Installation Directory>/content/static/<mucnm4>/2static/style/
directory, just note that the string<mucnm4>
in this path will be different for you. - Before modifying any of these files we recommend backing them up.
Inside this path you will see many
.css
files with their corresponding.css.gz
files.- The alphanumeric part of the file names (e.g.,
6b5bddea7adbb0cf89bfb560f8fab43b
) is generated randomly for each Fisheye installation. Therefore, in the instructions below this alphanumeric part was replaced by an asterisk. After saving the
.css
file that you've changed, the file needs to be compressed into its corresponding.gz
file by running a command like below:tar -czvf concat.style.6b5bddea7adbb0cf89bfb560f8fab43b.cache.css.gz concat.style.6b5bddea7adbb0cf89bfb560f8fab43b.cache.css
- After that, refresh the browser tab and the CSS change should be seen. If that does not happen, try clearing the browser cache or using an Incognito window. Sometimes, a restart of Fisheye may be required.
Known customizations:
Change the Fisheye/Crucible Header Logo
See the instructions on the How Do I Change The Fisheye/Crucible Header Logo page.
Edit the JSP source directly
An alternative approach would be to use the JSP source download version of Fisheye/Crucible, which would allow you to inject your own CSS into the diff rendering. Unfortunately the diff rendering is complex, so we don't recommend this path unless you are comfortable with JSP syntax.
Look and Feel plugin
You also may try to use this experimental plugin Look and Feel for Fisheye and Crucible to easy customize colors of your application.