OdooWiki OCA HUB

Appraisal Oca

hr_appraisal_oca folder_open OCA/hr open_in_new
Human Resources/Employees License: AGPL-3

This module helps maintain the employee motivation process through periodic performance appraisals.

Managers can evaluate employee performance and enable employees to perform self-assessments. Review forms can be customized according to organizational needs.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Manage employee performance appraisals in Odoo: create appraisal records, collect employee self-assessments and manager feedback, and control when each side can see the other's comments.

This module adds a full appraisal process to the Human Resources area. Users can create appraisal records for employees, set an appraisal date, choose a template, and add tags. Each appraisal moves through three statuses: To Confirm, Confirmed and Done, shown as a status bar on the form.

  • The appraisal form has two feedback areas: the employee's self-assessment and the manager's feedback. Buttons let the manager publish or hide each feedback, and the system decides who is allowed to see or edit it depending on the status and the user's role.
  • Confirming an appraisal sends emails to the employee and managers and creates activities asking them to fill the form. Marking it as Done sends completion emails and closes those activities.
  • A 'Send by email' button opens a wizard to request an appraisal by email, choosing recipients and a subject.
  • Appraisal templates (with default employee and manager feedback text) can be configured, and a default template can be set in Settings. Tags can be created for classifying appraisals.
  • On the employee form, users can see the number of appraisals, the last appraisal and its status, and open previous appraisals.
  • A visibility option lets an appraisal be visible to everyone or only to managers and HR officers.

Depends on

basehrmail

Menus it adds

AppraisalsAppraisalsConfigurationAppraisal TagsAppraisal TemplatesSettings
Models and fields (9)
  • hr.employee · extends an existing modelappraisal_ids (Appraisal), appraisal_count, allowed_user_ids (Allowed Users), last_appraisal_state (Status), ongoing_appraisal_count
  • hr.appraisal · new modelnote (Private Note), color (Color Index), state (Status), active, job_id (Job Position), tag_ids (Tags), company_id (Company), created_by, date_close (Appraisal Date), is_manager, visibility, employee_id (Employee), manager_ids, activity_ids, department_id (Department), employee_user_id (Employee User), manager_feedback, manager_user_ids (Manager Users), employee_feedback, employee_domain_ids, appraisal_template_id (Appraisal Template), can_see_manager_publish, can_see_employee_publish, employee_appraisal_count (Appraisal Count), manager_feedback_published, employee_feedback_published
  • hr.appraisal.tag · new modelname (Tag Name), color
  • hr.employee.base · extends an existing modellast_appraisal_id, can_open_last_appraisal
  • hr.appraisal.wizard · new modelres_id (Resource ID), res_model (HR Appraisal)
  • res.config.settings · extends an existing modelappraisal_default_template_id (Default Appraisal Template)
  • hr.appraisal.template · new modelcompany_id, is_default, description, appraisal_manager_feedback_template (Manager Feedback), appraisal_employee_feedback_template (Employee Feedback)
  • send.email.with.template · new model
  • hr.appraisal.request.wizard · new modelsubject, user_body (User Contents), appraisal_id, recipient_ids (Recipients), recipient_users (Recipients Users)

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 18.0

To create a new appraisal for an employee, first navigate to the main Appraisals dashboard by opening the Appraisals app. The Appraisals dashboard is the default view.

All appraisals are displayed on the dashboard in a default Kanban view. To view the details of any appraisal, click on the card to open the appraisal form.

  • Create an appraisal: To create a new appraisal, click the New button in the

upper-left corner of the Appraisals dashboard. Doing so reveals a blank appraisal form. After entering a name in the first blank field, proceed to enter the following information on the form: * Employee: Select the employee for whom you are creating the appraisal. * Managers: Select the managers who will be involved in the appraisal process. * Date Close: Select the date when the appraisal is expected to be completed. * Appraisal Template: Select the template that will be used for this appraisal. * Appraisal Tags: Add any relevant tags to categorize the appraisal.

Once the form is complete, click the Confirm button to confirm the appraisal request.

Visibility control

Appraisals include a visibility option that allows restricting access to managers only.

  • Visible to all: standard behavior. The employee and assigned managers can access the appraisal.
  • Visible to managers: the appraisal is only visible to the assigned managers and HR officers.

When the visibility is set to Visible to managers:

  • The employee cannot see the appraisal in any view (kanban, list or form).
  • No activities are created for the employee.
  • No automatic notifications are sent to the employee.

This allows creating confidential appraisals visible only to managers.

Once confirmed, the employee may receive an email depending on the visibility configuration and is then prompted to schedule an appraisal date. The next steps require the employee to fill out the self-assessment, after which the manager completes their assessment.

The status changes to Confirmed, and the Employee’s Feedback section of the Appraisal tab is grayed out. The information in that section only appears after the self-assessment is published by the employee.

If there are any existing appraisals for the employee, an Appraisal smart button appears at the top of the page, listing the total number of appraisals there are for the employee.

  • Employee’s feedback To complete their portion of feedback, employees should navigate

to the main Appraisals application dashboard, where the only entries visible are appraisals for the employee, themselves, and/or anyone they manage and have to provide manager feedback for.

Click on the appraisal to open the appraisal form. Enter responses in the Employee’s Feedback section, under the Appraisal tab.

When completed, click the Not Visible to Manager toggle (the default setting once an appraisal is confirmed). When clicked, the toggle changes to Visible to Manager.

  • Manager’s feedback After the employee has completed the Employee’s Feedback section,

under the Appraisal tab, it is time for the manager to fill out the Manager’s Feedback section.

The manager enters their responses in the fields in the same manner as the employee.

When the feedback section is completed, click the Not Visible to Employee toggle (the default setting once an appraisal is confirmed). When clicked, the toggle changes to Visible to Employee.

  • Private Note tab If managers want to leave notes that are only visible to other

managers, they can be entered in the Private Note tab. This can be done before or after meeting with the employee to discuss the appraisal.

The employee being evaluated does not have access to this tab, and the tab does not appear on their appraisal.

  • Complete an appraisal After the appraisal is complete, and both the manager and

employee have met to discuss the appraisal, the appraisal can be marked as Done. When completed, click the Mark as Done button on the appraisal form, located in the top-left corner.

Once the appraisal is marked as Done, the Mark as Done button disappears, and a Reopen button appears.

  • Permissions and User Types To manage access permissions to the Appraisals app, go to

Settings > Users & Companies > Users and select the desired user. In the Access tab, you will find the Appraisal Permissions section. The following user types are available:

  • User: Can access their own appraisals and complete evaluations of their direct and indirect reporting employees.
  • Human resources officer: Has full access to all appraisals and settings, and can manage templates, tags, permissions, and all records.

Make sure to assign the appropriate access type based on the user's role in the organization. Permissions determine what actions each user can perform within the Appraisals module.

  • Archive and Restore Appraisals To archive an appraisal, open the record and select

Archive from the Action menu. Archived appraisals are hidden from the main views.

To view archived appraisals, use the Archived filter in the search bar.

To restore an appraisal, open it (with the Archived filter active) and click Restore.

Archiving does not delete the record; you can archive or restore appraisals at any time.

  • Tip

Modifications are not possible once the appraisal is marked as done.

To make any changes to an appraisal that is marked as Done, click the Reopen button.

Then, click the Confirm button that appears, and make any modifications needed. Once all modifications are complete, click the Mark as Done button again.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.