> For the complete documentation index, see [llms.txt](https://help.sdocs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sdocs.com/sdocs/administration/install-configure/configure-the-s-docs-usage-metrics-lwc-on-home-page.md).

# How To: Configure the S-Docs Usage Metrics LWC on Home Page

The **S-Docs Usage Metrics Lightning Web Component (LWC)** provides a real-time view of your organization's document generation and e-Signature activity. This LWC makes it easier to monitor consumption, stay within entitlements, and proactively manage your document workflows.

By adding the Usage Metrics LWC to a Lightning Home Page, organizations can quickly understand how S-Docs is being used and ensure they remain within their entitled limits.

<figure><img src="/files/G8IxJAvDQmWInMzn8YiU" alt=""><figcaption></figcaption></figure>

***

## Configure the Usage Metrics LWC

The Usage Metrics LWC can be added to Lightning home page layouts. [**Click here to learn more about setting up Lightning Experience home page layouts**](https://help.salesforce.com/s/articleView?id=xcloud.admin_home_lex_intro.htm\&type=5).

{% hint style="info" icon="bullhorn" %}
**Note:** LWCs are not a supported component type for dashboard layouts.
{% endhint %}

### Navigate to the Lightning Builder for a Home Page

Navigate to the home page you'd like to add the **Usage Metrics** LWC to. Click the **Setup** gear, then click **Edit Page**.

<figure><img src="/files/2uy46MMqoQtQWl3HPR0k" alt=""><figcaption></figcaption></figure>

### **Add the Usage Metrics LWC to your page**

Within the Lightning App Builder, scroll down the list of components in the left sidebar to the *Custom - Managed* section. Drag the **S-Docs Usage Metrics** LWC onto the page.

<figure><img src="/files/aNPjciPDZns221n10KV5" alt=""><figcaption></figcaption></figure>

### Configure the Usage Metrics LWC

After dragging the **S-Docs Usage Metrics** LWC onto your home page layout, click on the component to open the configuration options.

<figure><img src="/files/6O1xrZY070a1qFoUBhZY" alt=""><figcaption></figcaption></figure>

You can customize the data that the Usage Metrics LWC displays here:

1. **Hide Manual Count:** Hide the number of documents that users generate manually (via button clicks).
2. **Hide Automation Count:** Hide the number of documents generated programmatically (through Flows, Apex, etc. via the SDK or S-Docs Jobs).
3. **Hide Document Limit Progress Bar:** Hide the progress bar that displays how generated documents compare to your org's document entitlement limits. *We recommend checking this box if you have a seat-based S-Docs plan.*
4. **Hide e-Signature Limit Progress Bar:** Hide the progress bar that displays how e-Signature requests created with [**S-Docs e-Signature**](https://kb.sdocs.com/knowledge-base/sdocs/sdocs-e-signature/configuring-s-docs-e-signature/) compare to your org's e-Signature entitlement limits.
5. **Set Component Visibility:** You can optionally configure *Component Visibility* to display/hide this LWC based on your own conditions in Salesforce.

### Save your configurations

Click **Save** to save your configurations. If you're customizing a new page or the page hasn't been activated before, you will also need to click **Activate** and assign the page as a [**default home page**](https://help.salesforce.com/s/articleView?id=xcloud.admin_home_lex_set_default.htm\&type=5) for different levels based on your organization's needs (e.g. an org default, an app default, or specific app and profile assignments).

The Usage Metrics LWC will now appear on your home page.

<figure><img src="/files/gM4otsA8GTrBrrAnFAWD" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="bullhorn" %}
**Note:** The **Usage Metrics** LWC automatically updates every 24 hours. However, you can view the latest live data by clicking **Refresh** at the bottom of the LWC. You can also see when the data was last updated next to the **Refresh** button.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.sdocs.com/sdocs/administration/install-configure/configure-the-s-docs-usage-metrics-lwc-on-home-page.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
