Changing your user profile

You can change FishEye (and Crucible) settings such as password, notifications, profile image and display settings.

To change your FishEye settings:

  1. Log into FishEye.
  2. Choose Profile settings from the User Menu (with your avatar) at the top of the screen.
  3. Update your user settings as required. Each tab is described in more detail below.
  4. Click Close.

On this page:

Display Settings

Display Settings

File history view mode

Default is Logical.
In Subversion repositories, FishEye is able to show all operations on a single logical file spread across a number of physical paths - i.e. operations in different branches. When this is set to Logical, FishEye will show all the operations across all branches. In Physical mode, only the operations related to the physical path whose history is being viewed are shown.


Default is the timezone of the FishEye server.


Changesets per page

The default is 30 per page.

Always expand changesets in stream

Default is Yes.

Diff view

Diff mode

Default is Unified.

Line wrapping

Default is None i.e. long lines will never word-wrap. Soft is when long lines will word-wrap.

Context lines

Default is 3. The number of lines to show (for context), if the diff contains more than three lines of code.

Source view

Default annotation mode

Default is Age.

Highlighting colours

The default scheme uses bright colours for highlighting diffs in the code. If you prefer more muted colours, select Classic (muted).

Tab width

Default is 8. Can be changed to a number between 1 and 10.

Profile and Email

Email settings

Display Name

Name displayed for the user currently logged in.

Email Address

The address to which all email notifications will be sent.

Email Format

Default is Text. Can be sent as HTML.

Email watches

Send Watch Emails

The frequency at which emails will be sent for watch notifications. Immediately is the default value. Daily sends a summary of changes.

Profile Picture

Choose picture

Upload an avatar image of your choice. This image will be displayed next to your username throughout FishEye/Crucible.

Accepted formats are JPG, GIF and PNG. Image file size limit is 2Mb. Images will be automatically cropped on upload.

This is disabled if avatars are served from an external server – see  Configuring avatar settings.

Change Password

Change your password from this tab, if required. Please note that passwords are case-sensitive.

(warning) This tab is not displayed if your FishEye instance is connected to an external LDAP authentication source, such as LDAP. You will need to contact your administrator for assistance.

Open Authentication (OAuth)

Configure your OAuth settings on this page. You can choose to allow gadgets/applications to access FishEye data using your account.

Read more about Linking to another application.

Author Mapping

The Author Mapping tab allows you to make an association between you (as a logged-in user) and a committer, for each repository.

This is only necessary if the name or email of the user within FishEye is different from the committer name or email within the repository. By default, FishEye will automatically match users to committers where it can.

Note that FishEye/Crucible administrators can control whether author mapping is available. See Configuring user managed mappings.


By adding a 'watch', you can ask to receive emails about changes made to the repository. Any watches that you have set up in FishEye/Crucible will be displayed on this tab. You can watch the dashboard activity stream, changelogs and repositories. Watching an activity stream/repository allows you to receive emails when updates occur. Note, the option to add a watch may only be available if the administrator has enabled watches for the repository.

You can delete any of your watches by clicking Delete next to the watch.


This functionality is used by Crucible.

If the SMTP server is set up, then you will receive emails when different actions occur within Crucible.

You can change the options described below, to specify the stages at which emails will be sent.

Auto-mark files as 'read'

Default is Yes.  
Review Notifications Events State change

Default is Immediate. A Crucible review moves through different states e.g: 'Draft', 'Under Review'. An email is sent when the state changes.

Comment added

Default is Immediate. An email is sent when a comment is added to a review.

Comment reply added

Default is Immediate. An email is sent (to the Moderator only) when any reviewer has completed their review.

Participant finished

Default is Immediate. An email is sent when a reviewer is added or removed from a review, after it has gone into the 'Under Review' state.

General message

Default is Immediate. An email is sent when a reviewer is added or removed from a review, after it has gone into the 'Under Review' state.

File revision added

Default is Immediate.

Uncomplete review if defect is raised:

Default is Yes. This allows reviews to be resurrected automatically to deal with new code or defects.

Default is Yes. This allows reviews to be resurrected automatically to deal with new code or defects.

My actions

Default is No. If set to Yes, an email is sent every time you perform an action on a review.

Batch Notifications will be sent out by Crucible every 30 minutes.  All notifications will be rolled up into a single digest e-mail.

Screenshot: User Profile Settings

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport