> ## Documentation Index
> Fetch the complete documentation index at: https://docs.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shared Links Report

<div className="article_labels_list" style={{display: 'none'}} dangerouslySetInnerHTML={{__html: "Overview , Reporting , Admin , Article , Account Administration , Established"}} />

The Shared Links report lists all active shared links created for files or folders in your Box account. This report is useful when you want to see what content in your enterprise has been shared. You must define filters for the Shared Links report before you can run it. See [Shared Links Report Filters](#shared-links-report-filters) for more information.

If you would like to report on Custom URLs attached to content in your enterprise, see [Reporting on Custom URLs](/en/box-admin-tools/reporting-and-insights/reporting-on-custom-urls).

## Shared Links report details

* **File format**: comma-separated value (.csv) file
* **Filename format**: `shared_links_run_on_YYYY-MM-DD-HH-MM-SS.csv`
* **Folder name format**: (each report run is placed in its own folder): `Shared Links run on YYYY-MM-DD HH-MM-SS`
* **Filename and folder name time zone**: the local [date and time](/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data) of the admin who ran the report or who set up the report [schedule](/en/box-admin-tools/reporting-and-insights/scheduling-reports).

### Shared Links report data columns

This section describes the data columns that are generated in Shared Links reports. You can select which data columns appear in the report. All columns are selected by default, and the columns marked with an asterisk and grayed out in the dialog box are required.

<table>
  <thead>
    <tr>
      <th>Data Column</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Item Owner Login\*</td>
      <td>Required. The value in the <em>Name</em> field in User Account Details of the owner of the item.</td>
    </tr>

    <tr>
      <td>Item ID</td>
      <td>A number that uniquely identifies the file or folder.</td>
    </tr>

    <tr>
      <td>Item Name\*</td>
      <td>Required. The name given to the file or folder.</td>
    </tr>

    <tr>
      <td>Path</td>
      <td>The path to the file or folder from the root of your Box instance.</td>
    </tr>

    <tr>
      <td>Shared Item Type</td>

      <td>
        <p>The type of item shared. Values in this field can be:</p>

        <ul>
          <li class="ck-list-marker-italic" data-list-item-id="e0c37bbf22ed91953aa39637dbc2635d9"><em>file</em></li>
          <li class="ck-list-marker-italic" data-list-item-id="e00154b7022d35e129de6581b58ce4e89"><em>folder</em></li>

          <li data-list-item-id="ec9d2b6001d6976a7b8c7f8bcb2eb93cf">
            <em>web\_link</em> (represents a <a href="/en/box-fundamentals/for-users/staying-organized/organizing-and-tracking-content/creating-bookmarks">bookmark</a>)
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Shared Link Status</td>

      <td>
        <p>The status of the shared link. Values in this field can be:</p>

        <ul>
          <li data-list-item-id="e71f72324e0204e3d163b0ade42732c92">
            <em>Open</em> - The shared link is publicly accessible and no sign in is required.
          </li>

          <li data-list-item-id="ee4005095613c78a102236eee3260f8d3">
            <em>Collaborators</em> - The shared link is available only to people who are invited as collaborators to the item.
          </li>

          <li data-list-item-id="e428969e4e3801a08f58f580ddaadd365">
            <em>Company</em> - The shared link is available only to people in your company
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Derived Status (calculated value)</td>

      <td>
        <p>The derived status of the shared link precedes the original shared link status. It includes cases of sharing a file or folder that is controlled by an enterprise setting, individual setting, or an account setting. Values in this field can be:</p>

        <ul>
          <li data-list-item-id="e959edf4aade502b04fd90d5a2037eb72">
            <em>Open</em> - The shared link is publicly accessible and no sign in is required
          </li>

          <li data-list-item-id="e7bce8db27c27f6d8d41b0d2644a9055e">
            <em>Company</em> - The shared link is available only to people in your company
          </li>

          <li data-list-item-id="ed1c579cce3f4013041cc7d595c90ae7b">
            <em>Collaborators</em> - The shared link is available only to people who are invited as collaborators to the item
          </li>
        </ul>

        <p>If the <a href="/en/box-shield/shield-smart-access-policies/security-control-types#shared-link-restriction">Shared Link Restriction</a> security control is enabled, it will impact the value shown. Specifically, the <strong>People in your company and invited people </strong>restriction will appear as <em>Company</em> while the <strong>Invited people only</strong> restriction will show as <em>Collaborators</em>.</p>
        <p>If there is no action that overrides a shared link status, the value displayed in Shared Link Status and Derived Status will be the same.</p>
      </td>
    </tr>

    <tr>
      <td>Shared Link URL\*</td>
      <td>Required. The Box-generated URL of the shared link. If the <a href="/en/box-admin-tools/box-admin-reference/enterprise-settings-custom-setup-tab#custom-subdomain">custom subdomain</a> is changed in Enterprise Settings, the updated URL will display in the report. </td>
    </tr>

    <tr>
      <td>Custom URL</td>
      <td>The custom URL, if any, of the shared link. The value is <em>None</em> if no custom URL.</td>
    </tr>

    <tr>
      <td>Password Set</td>

      <td>
        <p>Whether a password is required to access the item. Values in this field can be:</p>

        <ul>
          <li class="ck-list-marker-italic" data-list-item-id="e3ff241c22c3302a5d01f11a5365685d5"><em>Yes</em></li>
          <li class="ck-list-marker-italic" data-list-item-id="e5b8af94c199888da38da47e399715e8c"><em>No</em></li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Created Date</td>
      <td>The <a href="/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data" target="_self">date</a>, in UTC, that the shared link was created.</td>
    </tr>

    <tr>
      <td>Expiration</td>
      <td>The <a href="/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data" target="_self">date</a>, in UTC, that the shared link expires. If no expiration date, the field is blank.</td>
    </tr>

    <tr>
      <td>Permissions</td>

      <td>
        <p>The permissions for the shared link. Values in this field can be:</p>

        <ul>
          <li data-list-item-id="e93388d8bda83da8899ab1cb06c8e8a53">
            <em>none</em> - for links shared with <em>Invited people only</em>; in this case, permissions are not defined in the shared link dialog box, but are inherited from the collaboration invite. 
          </li>

          <li data-list-item-id="e6c1ccbeecb4e8707e9351cf7a45eac42">
            <em>preview</em> - for links shared with <em>People with the link</em> or <em>People in your company</em> and the <em>Can view only</em> permission selected.
          </li>

          <li data-list-item-id="ed1d2e620737fe3f491bb70210067d520">
            <em>preview and download</em> - for links shared with <em>People with the link</em> or <em>People in your company</em> and the <em>Can view and download</em> permission selected.
          </li>

          <li data-list-item-id="ee9ee14d8d279a4f1930cdfa0e8ee903a">
            <em>preview, download, and edit</em> - for links shared with <em>People with the link</em> or <em>People in your company</em> and the <em>Can edit</em> permission selected.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<Note>
  **Note:**

  * Restrictions applied at enterprise, folder, and user level are visible only in the **Derived Status** column.
  * When the link is shared with *Invited people only*, the **Permissions** column can be disregarded. The **Permissions** field may show random values other than *none* (such as *preview*). This value should be ignored. It is a known issue in the system.
</Note>

<h3 id="shared-links-report-filters">
  Shared Links report filters
</h3>

This section describes the filters that you can configure to run Shared Links reports.

<table>
  <thead>
    <tr>
      <th>Filter</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Owner</td>
      <td>Optional. Enter one or more names or email addresses of managed users or of user groups to limit the Shared Links report to specific owners of shared links.</td>
    </tr>

    <tr>
      <td>Expiration Date</td>

      <td>
        <p>Optional. The date range in which shared link expiration dates are set.</p>

        <ul>
          <li data-list-item-id="e27eb643b0fb3fdf957e3c38cbf363204">
            <strong>Custom Range</strong> (and then select a start and/or end date)
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Created Date</td>

      <td>
        <p>Optional. The date range in which shared links were created. Select from:</p>

        <ul>
          <li class="ck-list-marker-bold" data-list-item-id="e7eff36e8a40cd49f38ecd30082ab16c4"><strong>Last Day</strong></li>
          <li class="ck-list-marker-bold" data-list-item-id="e6a9cbb8f210cd951ec9fb6a3aad8ee0e"><strong>Last Week</strong></li>
          <li class="ck-list-marker-bold" data-list-item-id="e3a9952f2d5a104903e0096f464308f13"><strong>Last Month</strong></li>

          <li data-list-item-id="e3b268fac23b4db30aca66c1344cc4f9d">
            <strong>Last Years</strong> (and then select a number of years from 1 to 7 or All Time, which is as long as you have had an account tariff with reporting access)
          </li>

          <li data-list-item-id="e230b7adfe846c8c6696ba8ff765bb992">
            <strong>Custom Range</strong> (and then select a start and/or end date)
          </li>
        </ul>

        <p>If you do not select a date range, the value used will be Past Years > All Time, which is equivalent to 7 years, or as long as you have an account tariff with reporting access if less than 7 years.</p>
      </td>
    </tr>

    <tr>
      <td>Shared Link</td>

      <td>
        <p>Optional. Enter a specific shared link URL to get a report on that shared link.</p>
        <p>You can't fill in this filter when you don't have access permissions to the shared link. </p>
      </td>
    </tr>
  </tbody>
</table>
