# Customizing settings and forms for a Journal

These are the settings that you can change for your journal:

Note: AE - Action Editor; EIC - Editor-in-Chief

### Journal Settings

* **website\_urls**
  * Definition: URLs to relevant pages of the website
  * Possible values: dictionary in the format {page\_name : url}
  * Default value: None
* **editors\_email**
  * Definition: List of emails of the editors-in-chief of the journal
  * Possible values: list of strings
  * Default value: None
* **issn**
  * Definition: ISSN of the journal
  * Possible values: string
  * Default value: "XXXX-XXXX"
* **has\_publication\_chairs**
  * Definition:
  * Possible values:
  * Default value: False

### Submission Settings

* **submission\_public**
  * Definition: Whether submissions can be seen by the general public (anyone with the link)
  * Possible values: True, False
  * Default value: True
* **author\_anonymity**
  * Definition: True if authors are anonymous.
  * Possible values: True, False
  * Default value: True
* **assignment\_delay**
  * Definition: Delays the notification to the reviewer in case the AE make a mistake and decides to remove the assignment (in seconds)
  * Possible values: integer
  * Default value: 5
* **expertise\_model**
  * Definition:
  * Possible values:
  * Default value: "specter+mfr"
* **submission\_name**
  * Definition: The name of the submission invitation in the system
  * Possible values: string
  * Default value: "Submission"
* **submission\_length**
  * Definition: The type of the submission
  * Possible values: List of strings from this set: 
  * Default value: \[ "Regular submission (submissions may be any length)" ]
* **submission\_license**
  * Definition:
  * Possible values: 
  * Default value: "CC BY-SA 4.0"
* **release\_submission\_after\_acceptance**
  * Definition:
  * Possible values: True, False
  * Default value: True
* **eic\_submission\_notification**
  * Definition:
  * Possible values: True, False
  * Default value: False
* **skip\_camera\_ready\_revision**
  * Definition:
  * Possible values: True, False
  * Default value: False

### **Review Settings**

* **skip\_ac\_recommendations**
  * Definition: Set as True to skip the phase where authors recommend AEs for their paper.
  * Possible values: True, False
  * Default value: False
* **number\_of\_reviewers**
  * Definition: Number of reviewers needed to trigger the next step.
  * Possible values: integer
  * Default value: 3
* **reviewers\_max\_papers**
  * Definition: Maximum number of papers that can be assigned to a given reviewer per year
  * Possible values: integer
  * Default value: 6
* **action\_editors\_max\_papers**
  * Definition:
  * Possible values: integer
  * Default value: 12
* **archived\_action\_editors**
  * Definition: If True it allows AEs to keep current assignments, however AEs are moved to the archival group so they aren't given new assignments.
  * Possible values: True, False
  * Default value:  True
* **archived\_reviewers**
  * Definition:
  * Possible values:
  * Default value: False
* **expert\_reviewers**
  * Definition: If True creates the Expert\_Reviewers group. Related to certifications.
  * Possible values: True, False
  * Default value: True
* **skip\_reviewer\_responsibility\_acknowledgement**
  * Definition:
  * Possible values: True, False
  * Default value: False
* **skip\_reviewer\_assignment\_acknowledgement**
  * Definition:
  * Possible values: True, False
  * Default value: False
* **show\_conflict\_details**
  * Definition:
  * Possible values: True, False
  * Default value: False

### Duration Settings

* **ae\_recommendation\_period**
  * Definition: Number of weeks authors are able to recommend AEs. (soft deadline)
  * Possible values: integer
  * Default value: 1
* **under\_review\_approval\_period**
  * Definition: Number of weeks the AE has to approve a submission for review.
  * Possible values: integer
  * Default value: 1
* **reviewer\_assignment\_period**
  * Definition: Number of weeks the AE has to assign reviewers.
  * Possible values: integer
  * Default value: 1
* **review\_period**
  * Definition: Length of the review period (in weeks)
  * Possible values: integer
  * Default value: 2
* **discussion\_period**
  * Definition: Length of the discussion period between reviewers (in weeks)
  * Possible values: integer
  * Default value: 2
* **recommendation\_period**
  * Definition: Length of the reviewer recommendation period (in weeks)
  * Possible values: integer
  * Default value: 2
* **decision\_period**
  * Definition: Length of the decision period for AEs (in weeks)
  * Possible values: integer
  * Default value: 1
* **camera\_ready\_period** 
  * Definition: Length of the camera ready revision period for authors (in weeks)
  * Possible values: integer
  * Default value: 4
* **camera\_ready\_verification\_period**
  * Definition: Length of the camera ready verification period (in weeks)
  * Possible values: integer
  * Default value: 1

### Form customizations:

See [here](https://github.com/openreview/openreview-py/blob/6afa3b9c6152aaab5993e276e619d71e445c58a2/openreview/journal/invitation.py#L893) to see the default fields of the different forms. (Search for the set\_\[Form Name]\_invitation function).

* **submission\_additional\_fields**
  * Definition: Additional fields/customization for the submission form
  * Possible values: JSON
  * Default value: None. 
* **review\_additional\_fields**
  * Definition: Additional fields/ customization for the additional review form
  * Possible values: JSON
  * Default value: None. 
* **official\_recommendation\_additional\_fields**
  * Definition: Additional fields/ customization for the official recommendation form
  * Possible values: JSON
  * Default value: None. 
* **decision\_additional\_fields**
  * Definition: Additional fields/ customization for the decision form
  * Possible values: JSON
  * Default value: None. 

### **Certifications**

* **certifications:**
  * Definition:
  * Possible values: string\[]
  * Default value: 
* **eic\_certifications:**
  * Definition:
  * Possible values: string\[]
  * Default value: 
* **event\_certifications**
  * Definition:
  * Possible values: string\[]
  * Default value:

These settings are formatted into JSON and updated in the Journal Request Form. An example JSON is below: 

```
'submission_public': True,
'author_anonymity': True,
'assignment_delay': 5,
'submission_name': 'Submission',
'certifications': [
    'Featured Certification',
    'Reproducibility Certification',
    'Survey Certification'
],
'eic_certifications': [
    'Outstanding Certification'
],                            
'submission_length': [
    'Regular submission (no more than 12 pages of main content)', 
    'Long submission (more than 12 pages of main content)'
],
'issn': '2835-8856',
'website_urls': {
    'editorial_board': 'https://jmlr.org/tmlr/editorial-board.html',
    'evaluation_criteria': 'https://jmlr.org/tmlr/editorial-policies.html#evaluation',
    'reviewer_guide': 'https://jmlr.org/tmlr/reviewer-guide.html',
    'editorial_policies': 'https://jmlr.org/tmlr/editorial-policies.html',
    'faq': 'https://jmlr.org/tmlr/contact.html'                     
},
'editors_email': 'tmlr-editors@jmlr.org',
'skip_ac_recommendation': False,
'number_of_reviewers': 3,
'reviewers_max_papers': 6,
'ae_recommendation_period': 1,
'under_review_approval_period': 1,
'reviewer_assignment_period': 1,
'review_period': 2,
'discussion_period' : 2,
'recommendation_period': 2,
'decision_period': 1,
'camera_ready_period': 4,
'camera_ready_verification_period': 1,
'archived_action_editors': True,
'expert_reviewers': True,
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openreview.net/getting-started/hosting-a-venue-on-openreview/customizing-settings-and-forms-for-a-journal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.