--- title: Configuring payroll apps slug: configuring-payroll-apps docTags: createdAt: 2022-06-14T00:25:05.000Z --- After you've installed your payroll app, you can adjust your payroll app settings if needed. This includes configuring settings or adjusting when it syncs. You can also add custom field mappings that allow you to sync additional data from your payroll system to ChartHop. The number of custom field mappings that you have will depend on your plan. ## Manage app settings You can update your payroll app settings and change the way that the payroll app synchronizes data and what data it includes. 1. From the left sidebar, select **Apps & Bundles**. 2. From the sub-menu, select **Apps**. 3. Select the **Installed Apps** tab. 4. Find your payroll system app and select the gear icon. 5. Select **edit** in any of the sections to view the settings and make changes. ## Configure sync settings You can change when the payroll app syncs data. You can turn the automated sync on or off or run an on-demand sync. :::hint{type="info"} If you turn off the payroll sync, your data in ChartHop remains unchanged. ::: ### Run a one-time sync You can run a one-time sync from your payroll app. You can do this even when you have configured an automated sync. An on-demand sync runs as soon as you select the option. When you run a one-time sync, you have the flexibility of syncing your current payroll data to a ChartHop scenario. ::Image[]{alt="One-time sync" src="https://lh3.googleusercontent.com/ymPjfNSTEPTJg_hH4WDiUKV-FkwHPAepiABCps--Us-L4wGiMK8QGghDa6HdOp0wavPhEUcrlqM46ocs33mjUm6rsTs18piv2mb1_T4671tObhAdxy6uOfQcMV4nqzqSFkDDCp4ZW79JKho0rskmBmE" size="54" width="648" height="551" position="flex-start" showCaption="false"} 1. From the left sidebar, select **Apps & Bundles**. 2. From the sub-menu, select **Apps**. 3. Select the **Installed Apps** tab. 4. Find your payroll system app and select the gear icon. 5. Select **Run a one-time sync** at the top right of the page. 6. Select whether you want sync to: - your primary org - to an existing scenario - to a new scenario that will be created when you sync 7. Choose if you want to exclude any employee IDs from your import. 8. Select **Run sync**. 9. Once completed, a message indicates that the sync has been completed. ### Run an automated sync ChartHop recommends configuring your payroll app to do a daily sync to Charthop. 1. From the left sidebar, select **Apps & Bundles**. 2. From the sub-menu, select **Apps**. 3. Select the **Installed Apps** tab. 4. Find your payroll system app and select the gear icon to view the Manage app page. 5. In the **App status & sync settings** section, select **Edit.** 6. Select **Autosync** to turn the automated sync on or off. 7. Select **Save**. ### Disable a payroll automated sync You can disable your payroll app's automated sync at any time from the settings section in your payroll app. 1. From the left sidebar, select **Apps & Bundles**. 2. From the sub-menu, select **Apps**. 3. Select the **Installed Apps** tab. 4. Find your payroll system app and select the gear icon to view the Manage app page. 5. In the **App status & sync settings** section, select **Edit**. 6. Set **Auto sync **to off. 7. Select **Save**. ### Exclude employees from payroll syncs In some cases you may wish to omit one or more employees from your syncs. 1. From the left sidebar, select **Apps & Bundles**. 2. From the sub-menu, select **Apps**. 3. Select the **Installed Apps** tab. 4. Find your payroll system app and select the gear icon to view the Manage app page. 5. In the **Advanced Settings** section, select **Edit**. 6. In the **Exclude \[Your payroll system] IDs** section, add the IDs of the employee(s) you wish to exclude from the sync. - All employee's who's IDs have been added to the list will no longer have their information updated during the sync. 7. Select **Save**. ## Configure email notifications You can add or change the list of people that get notified when a synchronization happens. 1. From the left sidebar, select **Apps & Bundles**. 2. From the sub-menu, select **Apps**. 3. Select the **Installed Apps** tab. 4. Find your payroll system app and select the gear icon to view the Manage app page. 5. If no email notifications are configured: 1. Select **Add user.** 2. Type a name to select someone from your organization. 3. Continue entering names if needed. 4. Select **Save**. 6. To add or delete someone from the list: 1. Select **Edit**. 2. Select the Trash icon next to a name to delete it. 3. Type a name to select someone from your organization. 4. Select **Save.** ## Configure advanced settings You can customize advance settings your payroll app data syncs to ChartHop. For example, you can exclude some data and set up notifications so that people in your org are notified when data is synchronized. Advanced settings are automatically configured, so you can review these settings and update them if necessary. After you've installed a payroll app, you can update these settings if you need to change them. | **Field** | **Description** | **Default setting** | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | Exclude IDs | If you want to exclude specific individuals from the sync, enter their unique IDs here, separated by commas. IDs can typically be found on employees' profile pages that were created via a payroll sync. | The list of IDs is blank. | | Sync historical data | Include historical changes in your sync. You can configure how many days of data to include. | Historical data is included. | | Job change history | Configure the number of days of history you want to include in your synchronized information. | | | Sync all changes made | Select the changes you want to include in your sync. You can include some or all of the following:
* Job titles * Managers * Groups * Compensation * Hire dates | All changes are included. | | Default location when not set | Define whether or not you want to set the location to Remote or leave it empty if it is not set in your payroll system. | Location is set to remote if it is not set in your payroll system. | | Overwrite person fields | When you choose this option, your payroll system remains the source of truth for the following fields in ChartHop: birthdate, gender, home address and so on. This means any edits you or an employee makes to this data in ChartHop is overwritten when the synchronization takes place. This can pose an issue when someone uses ChartHop to updates employee fields in ChartHop, without requesting an update in the source system. ChartHop recommends to set this to yes to avoid needing to update both ChartHop and your payroll system when a change is made to one of these fields. | Set to yes. Payroll system data overwrites any changes to person data in ChartHop. |