# Configuring the TMF Homepage

The TMF Homepage provides an overview of critical metrics related to trial master files with easy insight into the most important action items related to a study. The TMF Homepage is available in all eTMF Vaults but requires some configuration to be accessed by users.

## Configuration Overview

  * [Enable the TMF Homepage][1] in your Vault.
  * Optional: [Configure labels][2] for the widgets displayed on the TMF Homepage.
  * Configure your Vault to [calculate timeliness][3].
  * Optional: [Enable field-level security][4] for the _Quality Issue_ and _Timeliness_ document fields.
  * [Update permission sets](/en/lr/23647/) to [grant users access](/en/lr/52759/#related-permissions) to the TMF Homepage tab and related objects.
  * [Add picklist values](/en/lr/1269/) to the _Milestone Category_ picklist so that users can filter the list of _Milestones_ displayed in the **Upcoming Milestones** widget.

## Enabling the TMF Homepage {#enable}

Users will not be able to view or use the homepage until you enable it from **Admin > Configuration > Tabs > TMF Homepage**. Click **Edit** and set the **Status** to **Active**. Then, click **Save**.

## Configuring Widget Labels {#widget-labels}

The widgets displayed on the TMF Homepage will reflect the labels of the object, object type, and milestone type.

<table class="wbord" style="height: 216px;">
  <tr style="height: 56px;">
    <td style="height: 56px; width: 155px;">
      <p>
        <strong>Widget</strong>
      </p>
    </td>
    <td style="height: 56px; width: 550px;">
      <p>
        <strong>Widget Label</strong>
      </p>
    </td>
  </tr>
  <tr style="height: 80px;">
    <td style="height: 80px; width: 155px;">
      <p>
        Upcoming Milestones
      </p>
    </td>
    <td style="height: 80px; width: 550px;">
      <ul>
        <li>
          "Upcoming"
        </li>
        <li>
          Object Plural Label of the <em>Milestone</em> (<code>milestone__v</code>) object
        </li>
      </ul>
    </td>
  </tr>
  <tr style="height: 80px;">
    <td style="height: 80px; width: 155px;">
      <p>
        Quality Issues
      </p>
    </td>
    <td style="height: 80px; width: 550px;">
      <ul>
        <li>
          "Upcoming"
        </li>
        <li>
          Object Plural Label of the <em>Quality Issues</em> (<code>quality_issue__v</code>) object
        </li>
      </ul>
    </td>
  </tr>
</table>

## Calculating Timeliness {#timeliness}

Timeliness is a way for you to track how long it takes your organization to approve a document and file it in TMF. Vault can calculate this value for you using parameters you define. To set up your Vault to calculate timeliness:

  1. Navigate to **Admin > Settings > Application Settings > eTMF Features > Edit** and set the **Enable Timeliness Document Field Calculation** checkbox.
  2. Click **Save**.
  3. Select a date field for _Finalization Date_ and _Filed in TMF_.
  4. Select options for **Timeliness Start Date** and **Timeliness End Date**.
  5. Enter an amount (in days) for **Threshold**.
  6. Add the _Timeliness_ field to appropriate document types.

When you approve documents that have the date fields you selected in step 2, Vault populates the _Timeliness_ field with the _Threshold_ value. The threshold value also appears on the [Timeliness widget](/en/lr/52759/#Timeliness).

## Configuring Field-Level Security {#field-level-security}

We recommend enabling [field-level security](/en/lr/2942/) for the _Quality Issue_ and _Timeliness_ document fields to make them read-only. This ensures accurate counts for both fields.

 [1]: #enabling-the-tmf-homepage
 [2]: #configuring-widget-labels
 [3]: #calculating-timeliness
 [4]: #configuring-field-level-security