Documentation for Crucible 3.0.x. Documentation for other versions is available too.

Skip to end of metadata
Go to start of metadata

Once a project is created, an administrator can edit the default values for settings such as repository, moderator, allowed reviewers, allowed groups and permissions scheme. These are the settings that are applied to any new review created for the project.

To edit project settings:

  1. In the admin area, click Projects (under 'Project Settings'). 
  2. In the list of projects, click Edit in the ('Crucible' column) for the required project.
  3. Modify the available settings, as required:

    • Name – the plain language name as displayed in the Crucible interface.
    • Key – the project key used when giving reviews their unique code names. If you change the key for a project all open, and closed, reviews in the project are updated with the new key.
    • Default Repository – the repository that contains the source code for this project. This is the repository that will be searched by default when you add files to a review.
    • Store the contents of files in reviews – check to have the source files under review stored in the Crucible database, along with the comments and review data. This retains a copy of all the source files under review even if the repository is disconnected from Crucible. See Storing all revisions under review.
    Permission SchemePermission Scheme – the permission scheme applied to this project. (A permission scheme controls who can perform particular actions, for example, create a review.)
    • Enable the Moderator role – clear to have reviews run by the author only. See Enabling the moderator role.
    • Default Moderator – the user who will be set as the moderator for all new reviews created in the project. Leave this field blank to force the review's creator to choose a moderator. See Creating a review.
    Default Reviewers
    • By default, allow anyone to join reviews after creation – sets the default state of the Allow anyone to join checkbox on the 'Choosing reviewers' screen.
    •  Users – set the individual users to whom new reviews will be assigned by default.
    •  Groups – set the groups to which new reviews will be assigned by default.
    Allowed Review ParticipantsUse Users and Groups to restrict who can have a role (author/creator/moderator/reviewer) in this project's reviews. These users will be the only ones whose names appear when a review is assigned. Leave these fields blank to allow all users to have access.
    Review DurationDefault duration – the default length of time (in week days) for reviews in this project. If you leave the field blank, then no time restriction is applied.  Reviews that are overdue will show up in red on the reviewer's dashboards. Note that the review duration only affects the default due date that appears when creating a review. The review's creator or moderator can specify a different date if they wish.
    Default Review ObjectivesDefault Objectives – specify some text that will appear by default in the Review Objectives field of each new review. This text can be edited, as with any text in the Review Objectives text box. See Setting default review objectives.




Screenshot: The Edit Project screen in Crucible

  • No labels


  1. What happens to all existing (open & closed) code reviews if you change the project name or key?

  2. I would like to know the answer to the above question as well.

    1. Good question!  The new key is applied to all open, and closed, reviews in the project. The name only relates to the project.

      1. thank you very much for your help.

  3. thank you for the response!