Reviewer management
This guide covers the complete reviewer lifecycle in Waldur's call management system: building reviewer pools, managing reviewer profiles, configuring reviewer-proposal matching, and handling conflicts of interest.
Reviewer profiles
Reviewers in Waldur maintain detailed profiles that enable intelligent matching with proposals.
Profile components
Each reviewer profile includes:
- Personal information: Name, ORCID ID, biography, alternative names
- Affiliations: Current and past institutional affiliations with type (employment, education, visiting, honorary, consulting), organization identifier, and date range
- Expertise: Self-declared expertise categories with proficiency levels (expert, familiar, basic)
- Publications: Academic publications with title, authors, venue, venue type (journal, conference, preprint, book, thesis, report), and year
- Availability: Whether the reviewer is available for new review assignments
Tip
Reviewers should keep their profiles up-to-date, especially expertise areas and affiliations. This data is used for automated reviewer-proposal matching and conflict of interest detection.
Managing your reviewer profile
- Navigate to your User Profile
- Select the Reviewer Profile section
- Fill in your biography, ORCID ID, and availability status
- Add affiliations with your current and past institutions
- Add expertise categories with your proficiency level for each
- Add relevant publications for matching purposes
- Set your profile to Published when ready to receive review assignments
Reviewer pool management
Call managers build a curated pool of reviewers for each call.
Building a reviewer pool
Performed by: Call manager
- Navigate to the call settings
- Select the Reviewer Pool section
- Add reviewers using one of these methods:
- By profile: Search and select from published reviewer profiles
- By email: Invite reviewers via email who may not yet have accounts
Invitation workflow
When a reviewer is added to a pool:
- An email invitation is sent with a unique acceptance token
- The reviewer can accept or decline the invitation without logging in
- On acceptance, the reviewer must have a published profile
- The reviewer is prompted to self-declare any conflicts of interest
Invitation statuses: Pending | Accepted | Declined | Expired
Note
Invitation tokens are generated using secure random bytes and do not require the reviewer to have an existing Waldur account to respond.
Conflict of interest (COI) detection
Waldur includes an automated COI detection system to ensure fair and unbiased peer review.
COI types detected
| COI Type | Description |
|---|---|
| Institutional (same) | Reviewer and proposal PI share the same institution |
| Financial (direct) | Reviewer has financial interest related to the proposal |
| Relational (family) | Familial relationship between reviewer and applicant |
| Co-authorship | Recent co-authored publications between reviewer and applicant |
Severity levels
- Real: Confirmed conflict that must be addressed
- Apparent: Circumstantial conflict that may need review
- Potential: Possible conflict flagged for awareness
Detection methods
- Automated: System cross-references reviewer affiliations and publications against proposal team data
- Self-disclosed: Reviewers declare conflicts during pool acceptance
- Reported: Third parties report potential conflicts
- Manager-identified: Call managers manually flag conflicts
Configuring COI detection
Performed by: Call manager
- Navigate to call settings
- Select the COI Settings section
- Configure per-call settings:
- COI type weights and severity thresholds
- Publication matching parameters (year range, author matching method)
- Automated detection sensitivity
Running COI detection
- Click Run COI Detection in the call management dashboard
- The system runs a batch detection job (processed in the background)
- Review detected conflicts in the Conflicts tab
- For each conflict, choose to Dismiss, Waive (with justification), or Recuse the reviewer
COI disclosure forms
Reviewers are presented with a disclosure form when accepting a pool invitation:
- General conflict declaration
- Financial interest details (entity type, relationship, amount range)
- Self-declared conflicts with specific proposals
Warning
Staff users can override COI blocks on specific assignments with an audit trail. All overrides are recorded with the overriding user, reason, and timestamp.
Reviewer-proposal matching
Waldur uses algorithmic matching to suggest optimal reviewer-proposal assignments.
Matching methods
| Method | Description |
|---|---|
| Keyword | Matches reviewer expertise keywords against proposal text |
| TF-IDF | Text similarity using Term Frequency-Inverse Document Frequency |
| Combined (default) | Weighted combination of keyword and TF-IDF scores |
Configuring matching
Performed by: Call manager
- Navigate to call settings
- Select the Matching Configuration section
- Configure:
- Affinity method: Keyword, TF-IDF, or Combined
- Weights: Keyword weight vs text weight (must sum to 1.0)
- Constraints: Min/max reviewers per proposal, min/max proposals per reviewer
- Threshold: Minimum affinity score for suggestions
- Reviewer bids: Whether to incorporate reviewer preferences
Generating suggestions
- Click Generate Suggestions in the matching section
- The system computes affinity scores for all reviewer-proposal pairs
- Results appear in the Suggestions tab with:
- Affinity score (0-1)
- Matched keywords
- Top matching proposals
- Accept or reject each suggestion
Reviewer bidding
If enabled, reviewers can express preferences for proposals:
- Want to review: Eager to evaluate this proposal
- Cannot review: Unable to review (workload, expertise mismatch)
- Conflict: Self-declared conflict with this proposal
Bids are factored into the matching algorithm with configurable weight.
Assignment workflow (Stage 2)
After matching, call managers create assignment batches to formally assign proposals to reviewers.
Creating assignment batches
- Review matching suggestions and confirmed reviewer pool
- Create an Assignment Batch for each reviewer
- Add specific proposals to each batch (with affinity scores shown)
- Add optional manager notes for the reviewer
- Review and send the batch
Batch lifecycle
1 | |
- Draft: Manager is preparing the batch
- Sent: Invitation sent to reviewer (email with unique token)
- Responded: Reviewer has accepted or declined all items
- Expired: Batch expired without full response (configurable expiration days)
Assignment item responses
For each proposal in a batch, the reviewer can:
- Accept: Creates a Review in IN_REVIEW state — reviewer can begin evaluation
- Decline: Records decline reason; may trigger auto-reassignment if configured
Auto-reassignment
If configured in the Assignment Configuration:
- When a reviewer declines, the system automatically finds the next-best reviewer
- Maximum auto-reassignment attempts are configurable (default: 3)
- Reminder emails sent before assignment expiry (configurable days before)

