How to install SharePoint Smart Forms
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 Forms at a glance
- Product
- SharePoint Smart Forms
- 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.Download the package
Download the latest .sppkg file from the SharePoint Smart Forms GitHub Releases page. It is a single file — there is no installer and nothing runs on a server.
2.Open your tenant App Catalog
In the SharePoint admin center, go to More features > Apps > App Catalog, then open Apps for SharePoint.
3.Upload the package
Drag the .sppkg file into the Apps for SharePoint library. SharePoint reads the manifest and shows a trust dialog.
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.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.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: Publish a working intake form that writes to a SharePoint list.
1.Create the target list
Create a list with the columns you want to collect. Enable attachments if the form will accept files.
2.Add the web part and point it at the list
Add Smart Forms to a modern page and select the list. Fields map to columns.
3.Lay out the questions
Add your fields, mark the required ones, and group them into steps if the form is long.
4.Add one branching rule
Hide or show at least one field conditionally — it is the feature people notice immediately.
5.Submit a test response
Fill the form as a normal user would and submit.
6.Open the list item
Confirm the values and any attachments landed on the item, then share the page link with your first real submitters.
First run: what to do next
- Start from one of the built-in templates and edit it, rather than building your first form from an empty canvas.
- Open Collect responses and pick the destination list before sharing — Smart Forms provisions one typed column per question.
- Use the person picker and lookup question types deliberately so the data lands as real SharePoint columns instead of text.
- Preview the form and walk your branching rules once; the pre-flight check flags unreachable questions.
Troubleshooting
- The destination list does not appear
- You need at least Contribute on the target list, and the list must be in the same site as the web part.
- A column was not created
- SharePoint rejects some column names and internal-name collisions. Rename the question or point it at an existing column of the matching type.
- External or anonymous people cannot submit
- That is by design. Smart Forms writes as the signed-in user, so respondents must be signed in and have Contribute on the list. Use Microsoft Forms for anonymous or external collection.
FAQ
- Do I need Power Automate?
- No. Smart Forms writes the list item directly, as the signed-in user, using their existing SharePoint permissions.
- Can respondents be anonymous?
- No. Smart Forms runs inside SharePoint as the signed-in user by design. Anonymous collection belongs in Microsoft Forms.
- Where are the responses stored?
- In an ordinary SharePoint list in your own site — one item per response, one typed column per question.
- Which languages does the interface support?
- Smart Forms supports 30 interface languages. It follows each signed-in user's Microsoft 365 display language, or the site's default, and falls back to English when needed. Form titles, questions, choices, and responses 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.
