Smart Solutions
Need help?
  • 100% Free & MIT Licensed
  • No third-party data hosting

How to install SharePoint Smart Charts

SPFx web part · about 10 minutes · Last updated · By Sean Regan

Stuck on approvals or tenant policies?

Let our team handle setup with you

Our Quick Start setup covers App Catalog deployment, permission approvals, and a guided first run, and we can help you prepare what your change board needs.

Smart Charts at a glance

Product
SharePoint Smart Charts
Type
SPFx web part (.sppkg)
Where it runs
Inside SharePoint Online pages, as the signed-in user
Admin needed
SharePoint Administrator, once, to deploy the package
Setup time
About 10 minutes
License
Free, MIT open source

Before you start

  • A Microsoft 365 tenant with SharePoint Online.
  • A tenant App Catalog site. If you do not have one, a SharePoint Administrator can create it in the SharePoint admin center under More features > Apps.
  • SharePoint Administrator or Global Administrator rights to upload and deploy the package once. End users need no elevated rights.
  • Site Owner (Full Control) rights on the site where you add the web part.

Install, step by step

  1. 1.Download the package

    Download the latest .sppkg file from the SharePoint Smart Charts GitHub Releases page. It is a single file — there is no installer and nothing runs on a server.

  2. 2.Open your tenant App Catalog

    In the SharePoint admin center, go to More features > Apps > App Catalog, then open Apps for SharePoint.

  3. 3.Upload the package

    Drag the .sppkg file into the Apps for SharePoint library. SharePoint reads the manifest and shows a trust dialog.

  4. 4.Deploy and trust

    Choose whether to make the solution available to all sites in the organization, then select Deploy. Deploying tenant-wide saves adding the app to each site individually.

  5. 5.Add the app to a site

    On the SharePoint site where you want the tool, open Settings > Add an app (or Site contents > New > App) and pick the solution. Skip this step if you deployed tenant-wide with the app auto-installed.

  6. 6.Add the web part to a page

    Edit a modern site page, click the + to add a web part, search for the tool by name, and place it on the page. Publish the page.

Your first real result, in about 10 minutes

Installing is not the win — the win is one result you can show someone. Goal: Put a chart of a real list on a page in one sitting.

  1. 1.Pick the question first

    Decide what the chart must answer — 'which team has the most open tickets', not 'chart the tickets list'.

  2. 2.Choose the chart type

    Use the chart type picker if you are unsure: bar for comparison, line for trend, treemap for hierarchy.

  3. 3.Point the web part at the list

    Add the web part to a modern page and select the list and view.

  4. 4.Map the axes and grouping

    Set the category field, the value field and any aggregation such as count, sum or average.

  5. 5.Add a filter

    Filter to the period or status that makes the chart answer the question rather than describe the list.

  6. 6.Publish and title it as the answer

    Title the web part with the finding, not the data source — the chart is read by people in a hurry.

First run: what to do next

  • Pick the data source list first, then the chart type — the type picker filters to what your columns can actually plot.
  • Group by a choice or person column for the fastest useful chart.
  • Add several web parts to one page to build a dashboard without leaving SharePoint.

Troubleshooting

The chart is empty
Check the selected view and any filters — the web part reads through the list view you choose, including its item limit.
A column is not selectable
Chart axes need a plottable type. Convert text columns holding numbers to a number column.
Large lists render slowly
Aggregate with a grouped view rather than plotting tens of thousands of raw items.

FAQ

How many chart types are there?
17.
Do I need Power BI?
No. The web part reads the SharePoint list directly and renders in the browser.
Does the chart update automatically?
Yes. It reads the list live, so there is no dataset refresh to schedule.
Which languages does the interface support?
Smart Charts supports 30 interface languages. It follows the SharePoint page language for each signed-in user, based on their Microsoft 365 display language or the site's default, and falls back to English when needed. Chart titles, labels, and source data are not translated.

Stuck on approvals or tenant policies?

Let our team handle setup with you

Our Quick Start setup covers App Catalog deployment, permission approvals, and a guided first run, and we can help you prepare what your change board needs.

Install another tool