AvePoint Docs
Contact support
Contact support
English

Home > Installation > tyGraph Pages Web Part Installation

Export to PDF

tyGraph Pages Web Part Installation

tyGraph Pages offers a powerful web part that democratizes insights without requiring Power BI licensing or analytical training. Once installed, you can deploy the tyGraph Pages Web Part to any page, allowing your audience to view tenant, hub, site, or page statistics in a self-serve format. This web part uses the same data model as your analyst team views in Power BI, ensuring the reliability of a common data model.

To add the tyGraph Pages Site Analytics web part to a SharePoint page, you will need to download and install the app packages for tyGraph Pages Engine and tyGraph Pages Web Parts into your SharePoint. The tyGraph Pages Engine package enables data collection on your SharePoint pages, while the tyGraph Pages Web Parts package activates the web parts and report bar. Download tyGraph Pages Engine and Web Parts

Click the corresponding downloading links to install the tyGraph Pages Site Analytics web part to a SharePoint page:

EnvironmentDownloading linkDownloading link
Commercial production environmenttyGraph Pages Web PartstyGraph Pages EnginetyGraph Pages Web PartstyGraph Pages Engine
U.S. Government production environmentGCCtyGraph Pages Web Parts GCCtyGraph Pages Engine GCC
U.S. Government production environmentGCCHtyGraph Pages Web Parts GCCHtyGraph Pages Engine GCCH
Project Hosts production environmentGCCtyGraph Pages Web Parts GCCtyGraph Pages Engine GCC
Project Hosts production environmentGCCHtyGraph Pages Web Parts GCCHtyGraph Pages Engine GCCH

Install tyGraph Pages Engine and Web Parts

Complete the following steps to install the app packages for tyGraph Pages Engine and tyGraph Pages Web Parts into your SharePoint:

  1. In the SharePoint admin center interface, navigate to More features > Apps and click Open.

  2. In Apps > Manage Apps, click Upload.

  3. Select the downloaded app packages and click Open. The app packages are successfully uploaded.

  4. Enable all uploaded apps and approve the access for each app in the following instructions:

    *Note: To manage APl access, you need to be assigned the Global administrator role in Microsoft 365.

    • Approve access for tyGraph Pages Engine

      1. Select the tyGraph Pages Engine app package and click Enable to configure the settings for data access.

        In the panel, select the Enable this app and add it to all sites option, and then click Confirm.

      2. After the app has been enabled, click Go to API access page.

      3. In API access > Pending requests, select the tyGraph Pages Engine package and click Approve to approve the access. You will be asked to approve User.Read and tygraph_users_impersonation permissions.

      4. In the Approval access panel, click Approve.

    • Approve access for tyGraph Pages Web Parts

      1. Go back to Manage apps, select the tyGraph Pages Web Parts app package, and click Enable to configure the settings for data access.

      2. In the panel, select the Enable this app and add it to all sites option, choose whether to Add to Teams, and then click Confirm. If you select the Add to Teams checkbox, the app will be added to Teams.

        *Note: After the web part is installed, you will need to add it to the desired pages and sites.

        After the app has been enabled, click Go to API access page.

      3. In API access > Pending requests, select the tyGraph Pages Web Parts package and click Approve to approve the access.

      4. In the Approval access panel, click Approve.

  5. When you finish installing the two app packages, navigate to your desired page in SharePoint, and then click Edit.

*Note: Starting later in 2025, the trusted script sources settings in the SharePoint admin center decide if the scripts from external sources can be loaded. To ensure the functionality of the tyGraph Pages Engine and tyGraph Pages Web Parts, the following CDN links must be allowed to load in the environment based on your scenario:

- Commercial production environment: [https://config.tygraph.cdn.avepointonlineservices.com/pagesengine](#missing-link)/ [https://config.tygraph.cdn.avepointonlineservices.com/pageswebpart/](#missing-link) - U.S. Government production environment - Government Community Cloud (GCC) users [https://configgov.tygraph.cdn.avepointonlineservices.com/pagesengine/](https://configgov.tygraph.cdn.avepointonlineservices.com/pagesengine/)[ ](#missing-link) [https://configgov.tygraph.cdn.avepointonlineservices.com/pageswebpart/](https://configgov.tygraph.cdn.avepointonlineservices.com/pageswebpart/) - GCC High users [https://config-gcc.tygraph.cdn.sharepointguild.com/pagesengine/gcch/](https://config-gcc.tygraph.cdn.sharepointguild.com/pagesengine/gcch/)[ ](#missing-link) [https://config-gcc.tygraph.cdn.sharepointguild.com/pageswebpart/gcch/](https://config-gcc.tygraph.cdn.sharepointguild.com/pageswebpart/gcch/)[ ](#missing-link) - Legacy tyGraph users [https://tygraphpagescdn.azureedge.net/logger/](https://tygraphpagescdn.azureedge.net/logger/)[ ](#missing-link) [https://config.tygraph.cdn.avepointonlineservices.com/pageswebpart/](https://config.tygraph.cdn.avepointonlineservices.com/pageswebpart/) Installing the SharePoint packages should add the required URLs to your trusted script sources. However, you should validate that the above entries were added. Existing customers will need to add these URLs manually or uninstall and reinstall the SharePoint packages to add them.

Add the Site Analytics Web Part to a Page

The tyGraph Pages Site Analytics web part provides reporting capabilities for any site, hub site, or tenant. You should decide on which sites or pages you would like to add it into. The web part is not added to pages automatically because we can't alter content on your SharePoint sites.

Complete the following steps to add the Site Analytics web part to a page:

  1. After you have finished installing the app packages for tyGraph Pages Engine and tyGraph Pages Web Parts, navigate to your desired page in SharePoint, and then click Edit.

  2. Click the Add button where you would like to add the web part.

  3. Search for "tyGraph" and click tyGraph Site Analytics web part.

    Add the web part.

*Note: To control who can use the web parts throughout your SharePoint environment, you first need to grant users permission role to use tyGraph Pages web part before they can add the web part to any page! Refer to Add/Edit Users for more information on grant permission role for the web part.