--- title: Set up Departments & Locations slug: set-up-departments-and-locations docTags: BbnR9AB4o8SHMJbk1CPtS,SeVEvegRNJWo5MXuNBnEM,nbRxJeOylKrcr6-o8D2Fe createdAt: 2025-07-10T11:52:40.795Z --- This article covers how to configure departments and locations. Both are required for jobs and job postings and can be used for reporting and filtering candidates, jobs and job considerations. :::hint{type="warning"} **Permissions & prerequisites:** - You must have Organization Admin access to configure departments and locations. ::: # Permissions and access Locations and departments can be configured on Foundations, Legacy Plus, Plus and Enterprise plans: | Foundations | Legacy Plus | Plus | Enterprise | | ----------- | ----------- | ---- | ---------- | | ✅ | ✅ | ✅ | ✅ | # Department setup ::loom{url="https://www.loom.com/embed/400388c721cf41e7a7fd591446d8bcae"} :::hint{type="info"} Watching the video is optional. Follow the steps below to set up a department. ::: To set up a department: 1. Navigate to **Admin > Organization Setup >** [Departments & Teams](https://app.ashbyhq.com/admin/organizational-settings/teams). 2. Click `+ New Department`, then enter the department or team name. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/2dn8oZhCvLzOLaygE3brU_creating-a-new-department.jpg" size="100" isUploading="false" width="1028" height="476" darkWidth="1028" darkHeight="476" alt="The Create Department pop-up where you can enter the department details." showCaption="false" indent="1"} 3. You can also specify the department the new team/department is a part of. If it is a sub-team to be grouped under a department, select the parent department. If it is a top-level department, leave the **Is under** field blank. 4. Click `Create`. :::hint{type="info"} You can adjust the department a sub-team is under or remove parent teams after creating the department. ::: ## Editing a department To edit a department: 1. Navigate to **Admin > Organization Setup >** [Departments & Teams](https://app.ashbyhq.com/admin/organizational-settings/teams). 2. Click on the department or region you would like to edit. 3. When editing, you also have the option to set a candidate-facing name for your department. If you set one, it is displayed on the job posting listed on your Ashby job board if you opt to list your posting. 4. Make adjustments to the team name or assigned region. Changes are auto-saved. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/yxWCrcEZXL85xzM1JsTFZ_editing-a-teamdepartment.jpg" size="100" isUploading="false" width="1044" height="874" darkWidth="1044" darkHeight="874" alt="The screenshot shows an existing department." showCaption="false" indent="1"} :::hint{type="info" indent="1"} The Department Usage section shows all jobs and job postings associated with the department that are impacted by updates. ::: ## Archiving and restoring a department To archive a department: 1. Navigate to **Admin > Organization Setup >** [Departments & Teams](https://app.ashbyhq.com/admin/organizational-settings/teams). 2. Click on the department or region in question. 3. Click `Archive`. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/QmrHcZm8S9wRyAQnDBAme_archiving-a-department.jpg" size="100" isUploading="false" width="1041" height="561" darkWidth="1041" darkHeight="561" alt="The screenshot shows an existing department with the Archive button highlighted." showCaption="false" indent="1"} 4. If the department is linked to jobs, job postings, or has sub-teams, you are prompted to reassign jobs and review the impacted sub-teams. Edit the sub-teams separately and adjust or remove the team they are under before archiving a parent department if you do not want the teams to be archived along with the parent department. 5. Click `Start` to confirm your changes and archive the department. You can review the changes once complete. To restore a department: 1. Navigate to **Admin > Organization Setup >** [Departments & Teams](https://app.ashbyhq.com/admin/organizational-settings/teams). 2. Click the `Active` dropdown and change it to `All`. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/x9RuaGmJwrWhkiGEBaMb-_departments-teams-ashby-2026-09-02-at-101751-am.jpg" size="100" isUploading="false" width="2966" height="482" darkWidth="2966" darkHeight="482" alt="The screenshot shows the Departments & Teams page with the Active dropdown highlighted." showCaption="false" indent="1"} 3. Click on the department or region in question. 4. Click `Restore`, then `Restore` on the following pop-up to confirm. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/VpU1dc3hqkO5-wOAK5A_I_departments-teams-ashby-2026-09-02-at-101852-am.jpg" size="100" isUploading="false" width="1024" height="828" darkWidth="1024" darkHeight="828" alt="The screenshot shows an archived department with the Restore button highlighted." showCaption="false" indent="1"} :::hint{type="info"} If you archive a department, you also have the option to delete it when opening the department's details. Deleted departments cannot be restored. ::: # Location setup ::loom{url="https://www.loom.com/embed/bc3363b275f840749d2f567c7acd011a"} :::hint{type="info"} Watching the video is optional. Follow the steps below to set up a location. ::: To set up a location: 1. Navigate to **Admin > Organization Setup >** [Locations](https://app.ashbyhq.com/admin/organizational-settings/locations). 2. Click `+ New Location` to create a new location, or click `+ New Region` to create a region to group locations by. 3. When setting up locations, add location details if you want those jobs to appear on external job boards like LinkedIn and Indeed. Location details include the following: - **Name:** The name of the location. This is both internal and candidate-facing if you don't set a candidate-facing name. This is required. - **Is under region:** Determine the region the location is under. - **Address:** Enter a street address. - **City:** Add the city name. - **State/province/region:** Add further region details. - **Postal Code:** Enter the postal code. - **Country:** Determine the country here. - **Location Type:** Specify the type of location (for example, Remote or Hybrid) from the **Location Type** dropdown. - **Candidate-Facing Name:** If you want a different name listed on your job board and for job postings that have this location set, enter it here. ![The screenshot shows the Create Location pop-up, where you can enter the location details.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/IHONFe91gov66clKSvxee_locations-acent-ashby-2026-03-06-at-100509-am.jpg) ## Region setup Regions are used to group together locations and other regions. To configure a region: 1. Navigate to **Admin > Organization Setup >** [Locations](https://app.ashbyhq.com/admin/organizational-settings/locations). 2. Click `+ New Region`. 3. Add the region name and set whether it is underneath another region. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/RmwYZF4DWD8_KE9bDWfm7_creating-a-region.jpg" size="100" isUploading="false" width="860" height="550" darkWidth="860" darkHeight="550" showCaption="false" indent="1"} :::hint{type="info" indent="1"} Addresses can only be assigned to locations, you cannot assign a location to a region. ::: Regions will then show in your location list with drop-down arrows. You can click the arrow to open up the list of locations and sub-regions within that region. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/-FdJByihx7T4ljYqzw0xz_regions-with-locations.jpg" size="100" isUploading="false" width="1042" height="536" darkWidth="1042" darkHeight="536" alt="The screenshot shows the Locations page with two regions, one is open and the other is collapsed." showCaption="false" indent="1"} ## Editing a location To edit a location: 1. Navigate to **Admin > Organization Setup >** [Locations](https://app.ashbyhq.com/admin/organizational-settings/locations). 2. Click on the location in question. 3. Make adjustments to the location name, address, and type as needed. Changes are auto-saved. 4. Review the **Location Usage** section to see how many jobs and job postings your location is linked to. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/uElMcUXITevzCn6AIakG7_editing-an-existing-location.jpg" size="100" isUploading="false" width="1296" height="1064" darkWidth="1296" darkHeight="1064" alt="This screenshot shows the edit screen for an existing location." showCaption="false" indent="1"} :::hint{type="info" indent="1"} You can view the history of changes made to the location on the **History** tab. ::: ## Archiving and restoring a location To archive a location: 1. Navigate to **Admin > Organization Setup >** [Locations](https://app.ashbyhq.com/admin/organizational-settings/locations). 2. Click on the location in question. 3. Click `Archive` and confirm by clicking `Archive` on the following pop-up. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/q_rk5qCHmIrkrUcvx4Vmp_archiving-a-location.jpg" size="100" isUploading="false" width="1308" height="554" darkWidth="1308" darkHeight="554" alt="The screenshot shows an existing department with the Archive button highlighted." showCaption="false" indent="1"} :::hint{type="info"} If you archive a location, you can no longer link it to jobs, but existing assignments are preserved. An archived location can be unarchived at any point in time. ::: To restore a location: 1. Navigate to **Admin > Organization Setup >** [Locations](https://app.ashbyhq.com/admin/organizational-settings/locations). 2. Change the `Active` dropdown to `All` to view all locations, including archived ones. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/JsNVPcUP7W9gYClPOcXjX_locations-ashby-2026-09-02-at-102405-am.jpg" size="100" isUploading="false" width="2972" height="536" darkWidth="2972" darkHeight="536" alt="This screenshot shows the Locations screen with the Active dropdown highlighted." showCaption="false" indent="1"} 3. Click on the location in question. 4. Click `Restore` and `Restore` on the following pop-up to confirm. ::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/e69_vSZt38G125_HRbvCx_restoring-a-location.jpg" size="100" isUploading="false" width="1292" height="502" darkWidth="1292" darkHeight="502" alt="The screenshot shows an archived location with the option to Restore or Delete." showCaption="false" indent="1"} :::hint{type="info"} If you archive a location, you also have the option to delete it when opening the location's details. Deleted locations cannot be restored. ::: # FAQs ### When editing a location or department, I can see yellow dots in certain areas. What do these mean? When amending a location, you see a **Location Usage** section. When editing a department, you see a **Department Usage** section. ![The screenshot shows an existing location where you can view the Location Usage section.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/xJSMrUvul5wg2iddZxZQh_location-details-and-usage.jpg) In these sections, you see the number of jobs and job postings linked to this location or department. If the dot beside a value is green, it means no jobs or job postings are currently using the location or department. If the marker beside a value is yellow, there are jobs or job postings linked to this location or department that are updated if you make changes. ### Can I pull my interview locations from my job locations list? No, interview locations are different from job locations. Interview locations are set within the **Communications** tab of your interview activity and can either be a custom location, a phone number, or video conferencing (Google Meet, Microsoft Teams, or Zoom). For more on setting a default interview location, check out [Setting Scheduling Defaults](docId\:OByntivrG5pxERTem4Tml). ### How do I give a user access to jobs within a specific department? User permissions can be configured within **Admin > Organization Setup > Employees**. For more on providing users access to specific departments, check out [User Permissions](docId\:i5jHibmkQHYobnnvrl8rk). ### Can I show the location's street address in my job postings? You can set street addresses to be displayed on your job postings. To display the location address across all job postings on your job board, navigate to **Admin > Job Boards > Theme (Job Board)** and check the `Show Location Address?` checkbox within the **Job Board Options** section. ![The Show Location Address checkbox that can be enabled on the Theme (Job Board) page.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/PxM7Gfuy1SSlCmhFApRs4_show-location-address-checkbox.jpg) :::hint{type="info"} If an address has not been assigned to some of your locations, only the location name (or candidate-facing location name) is displayed on job postings assigned that location. :::