---
title: Google Workspace 
slug: google-workspace
docTags: 
createdAt: 2021-09-29T02:09:24.000Z
---

The Google Workspace app automatically updates Google Workspace profiles with ChartHop source data. You can configure both Google Workspace profile fields and group memberships. Optionally, you can set the app to create Google Workspace profiles when people are hired into ChartHop.

When you install Google Workspace, you'll need to make decisions about how you want to handle Google Workspace profile and what fields you want to include in your sync.

| **Field**                        | **Description**                                                                                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Google Workspace profiles        | - Automatically create new Google Workspace profiles from ChartHop on sync
- Don’t create new profiles only update existing Google Workspace profiles on sync |
| Sync new hires before start date | The number of days before a start date to begin syncing new hires                                                                                             |

### Install the Google Workspace app

To install the **Google Workspace** app, follow the steps below.

1. From the left sidebar, select **Apps & Bundles**.
2. From the sub-menu, select **Apps**.
3. Select the **Availible Apps** tab.
4. Locate and select the **Google Workspace** app in the list of available apps.
5. Select **Install**.
6. Follow the steps outlined in the setup wizard to connect the **Google Workspace **app to ChartHop.

:::hint{type="info"}
To connect Google Workspace to ChartHop, you must be an *Google Workspace administrator*.
:::

### Run a single, on-demand sync to Google Workspace

Any ChartHop user with sufficient permissions can trigger an on-demand sync to Google Workspace at any time. To sync your data for the first time, or subsequently, on-demand at any time, follow the steps below.

1. From the left sidebar, select **Apps & Bundles**.
2. From the sub-menu, select **Apps**.
3. Select the **Installed Apps** tab.
4. Locate and select the **Google Workspace** app in the list of installed apps.
5. At the top of the page, select **Run one-time sync**.
6. Select **Run sync **to perform the sync. 

### Export dry runs

Any ChartHop user with sufficient permissions can trigger a test integration between Google Workspace and ChartHop at any time. 

1. From the left sidebar, select **Apps & Bundles**.
2. From the sub-menu, select **Apps**.
3. Select the **Installed Apps** tab.
4. Locate and select the **Google Workspace** app in the list of available apps.
5. At the top of the page, select **Run one-time sync**.
6. Select **Export dry run** to test the integration.
7. When the integration is complete, select **Download** to receive the test results file.

### Create sync groups (mailing lists)

You can create and populate Google Workspace sync groups (mailing lists) from the app config page by following the steps below.

1. From the left sidebar, select **Apps & Bundles**.
2. From the sub-menu, select **Apps**.
3. Select the **Installed Apps** tab.
4. Locate and select the **Google Workspace** app in the list of available apps.
5. Under the **Advanced Settings** section, select **Edit**. 
6. Under the **Sync Groups (Mailing Lists) **section, select **+ Add group.**
7. Enter a name for the group in the **Group Name** field.
8. Enter a corresponding Carrot query in the **Include People Matching** field, or use the filter controls to the left.
9. Select **test** to confirm your query. It should open the Data Sheet in a new tab with your query applied.
10. Select **Save** at the bottom of the page.

### Create sync profile fields

For each custom **Google Workspace** profile field, you may define a ChartHop field or expression to be synced. To do this, follow the steps below.

1. From the left sidebar, select **Apps & Bundles**.
2. From the sub-menu, select **Apps**.
3. Select the **Installed Apps** tab.
4. Locate and select the **Google Workspace** app in the list of available apps.
5. Under the **Advanced Settings** section, select **Edit**. 
6. Under the **Sync Profile Fields **section, select + **Add field**.
7. Enter the name of a custom **Google Workspace** profile field that you wish to populate with data.
8. Enter the corresponding query or field that you wish to copy from ChartHop.
9. Select **Save** at the bottom of the page.

:::hint{type="info"}
[Modules](https://www.charthop.com/pricing/)**:&#x20;**<font color="#000000">**HRIS** | </font>Engagement | Goals | Performance | <font color="#000000">Compensation Reviews | </font>Headcount Planning
:::