# Share and download reports

> Share reports with visibility and access levels, download files, save a copy, switch views, and understand what happens when someone loses access.

If you want a colleague to be able to view a report you’ve created in the Reports and Dashboards app, you can share it with them. Sharing a report lets your colleagues access current and accurate data in the Reports and Dashboards app, without the need to download and share files outside of Rippling.

When you share a report, you choose the recipient's level of data visibility and access.

> **Note:**
> You can also download reports in CSV, Excel, or PDF format if you need to access them offline by clicking the three dots in the top right corner and selecting **Download**. See [Download a report](https://developer.rippling.com/documentation/rippling-platform/reports/sharing#download-a-report) below.

## Data visibility

There are two levels of visibility you can provide to report sharing recipients.

-   **Sees their own data**. Give the recipient access to view data in the report according to their permissions. The recipient may be able to see more or less information than you can see.
-   **Sees owner's data**. Give the recipient access to view the data in the report as you see it. The recipient may be able to see more or less information than their permissions normally allow.

When you share a report with _Sees owner's data_ access, recipients will be able to toggle between the two report views by selecting the **View as** option at the top of the report. For more information, see [Switch your report view](https://developer.rippling.com/documentation/rippling-platform/reports/sharing#switch-your-report-view).

To learn more about how data permissions are managed, see [Permissions for data in Rippling](https://developer.rippling.com/documentation/rippling-platform/data-model/permissions).

## Access level

You can also set the report recipient's level of access to manipulate the report.

| Access | What recipients will see | Ability to share |
| --- | --- | --- |
| Can view | Can add filters; cannot remove filters or adjust report configurations. | Cannot share. |
| Can view and filter | Can change filters and configurations using selected fields. | Cannot share. |
| Owner | Can edit the report configuration and filters. Can delete the report. | Can share the report with others. Can transfer ownership to someone else. |

### Detailed breakdown

Below is a detailed breakdown of what each access level allows report recipients to do.

| Capability | Can view | Can view and filter |
| --- | --- | --- |
| Add or remove fields | No | Yes |
| Change layout/chart type | No | Yes |
| Change settings in the _Settings_ tab | No | Yes |
| Add filters | Yes | Yes |
| Update existing filters | No | Yes |
| Remove filters | No | Yes |
| Modify joins | No | Yes |
| Change currency or time zone | No | Yes |
| Download | Yes | Yes |
| Save as | Yes | Yes |
| Share | No | No |
| See who the report is shared with | Yes | Yes |

## How to share a report

To share a report, follow these steps:

1.  Click the **Share** button in the top right corner of the report.
2.  Select the people with whom you want to share the report.
    -   To share the report with a specific individual or with a group of people based on a single attribute, search or browse using the bar at the top of the screen. As soon as you select a person or attribute, they’ll be added to the list of people with access.
    -   To add people based on multiple attributes, click the filter icon, then create your Supergroup. For example, if you want to include everyone with a level of Management L7 who is in the Chicago location, select this filter option before building your Supergroup.
3.  Choose how you want the report recipient to be able to view the report.
    -   **Sees their own data**. Give the recipient access to view data in the report according to their permissions. The recipient may be able to see more or less information than you can see.
    -   **Sees owner's data**. Give the recipient access to view the data in the report as you see it. The recipient may be able to see more or less information than their permissions normally allow.
4.  Select the recipient’s level of access.
    -   **Can view**. The recipient can view the report and add filters.
    -   **Can view and filter**. The recipient can view the report, add or change filters, and change configurations using selected fields.
5.  By default, recipients will receive an email message letting them know a report has been shared with them. The email will only be sent to people who don’t already have access to the report. If you don’t want to send this email, uncheck the box **Send an email notification to new people**.
6.  Click **Share**.

The report is shared and recipients will be able to see it in the _Shared with me_ tab of the Reports and Dashboards app.

## Frequently asked questions

### If I share a report with someone, can they make changes to my report?

Recipients of a shared report cannot save changes to the original report. If they want to save modifications to a shared report, they can select **Save As** to create and save a new copy of the report, which gives them full editing permissions for their copy.

Note that the newly saved report will only include data they have permission to access. For more information, see [Save a copy of a report that has been shared with you](https://developer.rippling.com/documentation/rippling-platform/reports/sharing#save-a-copy-of-a-report-that-has-been-shared-with-you).

### If I have access to multiple Rippling accounts, can I copy a report from one entity to another?

No, reports cannot be duplicated across different Rippling accounts and need to be recreated within each entity.

### What happens if I share a report with someone and they don’t have permission to view a field?

If a viewer doesn’t have permission to see a certain field, the report will show an error, and that field will not be visible in the report. The recipient can remove that field and then use **Save as** to save a new copy of the report.

### What happens if someone opens a link to a report and the report hasn’t been shared with them?

If someone opens a report that hasn't been shared with them, they can request access directly from the report screen. The request is sent to the report owner as an approval request.

When a report owner receives a report access request, they can review the requester's name, the access level they requested, and their reason. They can adjust the access level before approving, or deny the request. Approved requests automatically update the report's sharing permissions.

## Switch your report view

When someone shares a report, they choose what visibility level to provide. Recipients may have the ability to view the data with their own permissions or with the permissions of the owner.

When a report has been shared with the owner’s permissions, it will open in the owner’s view by default. Recipients can switch between their own view and the owner’s view at any time.

Report owners can also switch their own view to see what a report or dashboard looks like for a sharing recipient.

To switch your view of a report, follow these steps:

-   Click the **Viewing as…** menu next to the name of the report.
-   Select the person whose view you want to switch to.

The view is updated to show the data based on the selected person’s permissions. You can switch back to the owner’s view at any time using the same **View as** menu.

Note that even if a sharing recipient has the ability to view the report as the owner, switching to view the report as the recipient will show just the data _their own permissions_ give them access to see.

When a sharing recipient views a report as the owner, their options for customizing the report are limited. The capability table in [Access level](https://developer.rippling.com/documentation/rippling-platform/reports/sharing#access-level) above lists what each access level allows.

## Save a copy of a report that has been shared with you

When a report has been shared with you, you can’t save changes to it directly. If you want to modify and save your own copy, you can click **Save as** and save a new copy under a different name.

### Permissions when using save as

When you save a report using **Save as**, you’re creating it as a new report that you own. Your permissions are applied just as they would be if you were creating the report from scratch. As a result, the data and settings you don’t have permission to use are automatically removed from the report, and the new copy may look different than the original. Filters, grouping, or pivot table settings may change, and certain rows or attributes may be removed from the report. This may happen if you were given the ability to view the report as the owner but you don’t have access to all of the data in the report.

For example, say someone shared an employee contact info report with you, giving you the ability to view it as the report owner. This gives you the ability to see email, phone number, home address, and emergency contact info for everyone in the company.

If you save a copy of this report but you don’t have access to see non-sensitive personal data, the new copy of the report will not include most of the data.

## Download a report

If you want to use the data from one of your reports outside of Rippling, you can download it.

### Download a chart

You can download a chart as a PNG, JPG, or PDF file. To do so, follow these steps:

1.  Click the three dots in the top right corner of the report and select **Download as**.
2.  Select your preferred format (PNG, JPG, or PDF), then click **Download**.

The file is saved to your computer.

Alternatively, click the three dots and select **Copy to clipboard** to save a copy of the chart to your computer's clipboard. You can then paste it into any document/message.

### Download a grid or pivot table report

To download a grid or pivot table report, follow these steps:

1.  Click the three dots in the top right corner and select **Download**.
2.  Select your preferred download format: Excel, CSV, or PDF.
3.  Select your preferred layout and formatting options for the downloaded data as described in the sections below.
4.  If your report contains a lot of data, it may take some time to export. Select **Email me a download link when export is ready** and Rippling will send you an email with a link to download the report when it’s ready.
5.  Click **Download**.

### Formatting options

#### Page layout options for PDF reports

When downloading a PDF report, you can select the page layout of the file:

-   **Page size**: A4 or letter.
-   **Orientation**: Landscape or portrait.
-   **Scale**: Normal, fit to width, or custom.
    -   Normal will not resize the report. Any columns that don't fit the width of the page will flow onto the following page.
    -   Fit to width will resize the report to fit the width of the page.
    -   Custom lets you specify a percentage to scale down the overall size of the report on the page.

> **Note:**
> Downloaded PDF reports include the table view of the report. If your report includes a chart, it will be not be included in the PDF download.

#### Format and convert times

If your report includes timestamps, you can choose how you want the times to be formatted in your downloaded data. In the **Date & time formatting** field, select whether you want to display the times in ISO format or as they're shown in the report.

#### Combine or split up currency type and amount

If your report contains currency values, you can choose whether you want the currency type and value to be in a single column or split into two columns.

-   Separate columns for currency type and value. When you choose this option, the currency type (USD, CAD, INR, etc.) and amount (4929.16) will be placed in two separate columns in the downloaded file.
-   Only one column with currency value. When you choose this option, the currency amount (4929.16) will be included in the downloaded file, and the type (USD, CAD, INR, etc.) will not. You'll also be asked to specify the currency you want to use. The amounts in the download will be converted to the specified currency.

#### Include or exclude totals

If your report contains aggregated data, you can choose whether or not you want the download to include the totals and subtotals.

Toggle this on to include the rows that have totals and subtotals. In the download, these rows will contain “All” in the cell for the field that is grouped.

Toggle it off to exclude the totals and subtotals.

#### Include or exclude Employee ID

If your report contains the Employee field, you have the option to include a column containing Employee ID in your download without having to add it as a field in the report.

Toggle this on to include the additional column.

#### Include report configuration details

If you want to include details about the configuration of the report in the download, enable Include report configuration details. The downloaded report will include a section with details such as who generated the report, the date and time when it was generated, how the report is aggregated, which filters are applied, and how the date range is set.

This provides important context for understanding the data in the report, and can be especially helpful when providing the report to an auditor.

#### How percentages are formatted

Percentages will be numeric only in downloaded reports. For example, 0.13 instead of 13%. When viewing the report in the Reports and Dashboards app, this will be displayed as 13%.

> **Tip:**
> If your report doesn't download, check to see whether you have a pop-up blocker enabled. If so, disable it for _app.rippling.com_ and then try downloading again.

### How to resolve the error “Failed to export the report”

If you attempt to download a report and receive the error “Failed to export the report,” your report may exceed the maximum number of rows that can be downloaded, which is 500,000. You can remove rows from the report by adjusting the filters to narrow it down, then try again.

## What happens when someone loses access to their reports

There are two situations where someone can lose access to their reports:

-   The report owner is offboarded from your company
-   The report owner loses permission to create reports

When this happens, their reports remain in Rippling and are accessible to other users as described below.

### The report owner is offboarded from your company

When a user who created reports is offboarded from your company, the person who completes the termination will have the option to transfer ownership of their reports to someone else. This is part of the responsibility transfer step in the offboarding flow.

By default, the reports will be transferred to the company's super admin, but the person completing the termination can select someone else. They can transfer all of the person's reports to one person, or select a different person for each report.

If any of the reports were shared with **Sees owner's data** visibility, then when the transfer occurs, the recipients' access is changed to **Sees their own data**. Because the new owner's permissions may be different than the terminated person's permissions, this prevents recipients from inadvertently seeing information they shouldn't. After the transfer, the new owner can update the sharing settings if they need to.

### The report owner loses permission to create reports

When someone loses their permission to create reports, they can still access the reports they own. Their access to view the data in the report is updated to match their new permissions. If needed, they can manually transfer ownership to someone else.

In addition:

-   Super and full admins can view all reports that were created by anyone at their company, including other super/full admins, on the _Shared with me_ tab in the Reports and Dashboards app.
-   Super and full admins cannot modify reports for which they are not the owner. However, they can save a copy of it by opening it and clicking **Save as**, and then transfer it to another owner as needed.
-   If a super/full admin created a report, and is then removed as a super/full admin but still has other admin permissions, they will still be able to access the report, but the data they can see will now match their new permissions.

When someone loses their admin permissions, the people with whom their reports were shared may lose the ability to see the data contained in them, depending on how the reports were shared.

-   If a report was shared with **Sees owner's data** visibility, the recipient may lose the ability to see the data in the report. This is because the data permissions are based on the report owner’s permissions, which have now been removed.
-   If a report was shared with **Sees their own data** visibility, the recipient will continue to see data in the report based on their own permissions.

## See also

-   [Get started with reports](https://developer.rippling.com/documentation/rippling-platform/reports/getting-started)
-   [Charts and grouping in reports](https://developer.rippling.com/documentation/rippling-platform/reports/visualization)
-   [Apply formatting to numbers or dates](https://developer.rippling.com/documentation/rippling-platform/reports/formatting)
-   [Report permissions](https://developer.rippling.com/documentation/rippling-platform/reports/permissions)
-   [Dashboard sharing and permissions](https://developer.rippling.com/documentation/rippling-platform/dashboards/sharing)
-   [Permissions for data in Rippling](https://developer.rippling.com/documentation/rippling-platform/data-model/permissions)
-   [Generate and Download Reports Using the API](https://developer.rippling.com/documentation/rest-api/guides/reports)

Source: https://developer.rippling.com/documentation/rippling-platform/reports/sharing

> For the complete documentation index, see [llms.txt](https://developer.rippling.com/llms.txt). Public pages have a Markdown version at the same URL with .md added.
