SharePoint troubleshooting
Search this page for the text you see on the SharePoint page. Setup itself is described in Widgets on SharePoint.
Setup and sign-in
| Message or symptom | Cause | Fix |
|---|---|---|
"This Microsoft tenant is not registered in Widget Builder yet." (API code TENANT_NOT_REGISTERED) | The tenant is not registered with this Widget Builder. Often it is registered with another installation, for example because the package came from there, or the registration was removed. | Click Register tenant in Widget Builder and confirm in Settings (step 5). |
| "This registration link has expired. Reload the SharePoint page to get a new one." | The registration link is older than 15 minutes or was already used. | Reload the SharePoint page and click the link again. |
| "This Microsoft tenant is already connected to a different Widget Builder client." | A tenant belongs to exactly one client. | Remove the registration from the other client, then register the tenant here. |
| "Widget Builder is not authorised in this tenant yet. …" or every call fails with 401 | The API permission Widget Builder SharePoint is not approved, or a different app was approved. | SharePoint admin center → Advanced → API access: approve Widget Builder SharePoint / user_impersonation (step 3). |
| The card says "No web part has reached Widget Builder yet" | The tenant is registered, but no web part has loaded a widget. Usually the API approval is missing. | Check step 3, then open a page with the web part. |
"Tenant awaiting release" (API code TENANT_PENDING) | Your Widget Builder client is still waiting for release. | Contact support@jasp.eu. |
| 403 "origin not allowed for installation" | The registration is limited to certain SharePoint addresses, and this page is not one of them. | Ask the operator of your Widget Builder to allow the address. |
| "Could not reach Widget Builder. Check that it is running." | The web part cannot reach the address written into the package at download: the package came from another installation, or a proxy or firewall blocks it. | Download the package from the Widget Builder your pages should use and upload it to the App Catalog again (upgrade the web part). |
| "This Widget Builder is not set up for SharePoint yet." | This installation has not set up SharePoint. | Self-hosted installations: the operator has to finish the Microsoft Entra setup. |
| Download package is disabled and the card says "This Widget Builder is misconfigured" | The package would ask for approval of a different Entra app than this installation accepts (SHAREPOINT_ENTRA_CLIENT_ID and SHAREPOINT_ENTRA_RESOURCE_NAME point at different app registrations). | Only the operator can fix this. Send them the message. |
Widget picker
| Message or symptom | Cause | Fix |
|---|---|---|
| "No widgets or built-ins are active for your Widget Builder client yet." | No widget and no built-in widget is active in Widget Builder. | Activate a widget in Widget Builder and reload the page. |
| "No widget selected — A widget can only be chosen while the page is in edit mode." | The web part sits on a published page without a widget. | Edit the page, select the web part and pick a widget. |
| Tile greyed out with Not available here | SharePoint cannot show this item. The tile's tooltip names the reason. | See Item not available. |
Item not available
| Tooltip | Fix |
|---|---|
| "This item has no template and no native bundle, so SharePoint cannot render it." | The widget has neither a Handlebars template nor a bundle. Give it a layout in Widget Builder. |
| "Native widgets are not included in this licence. Ask a Widget Builder administrator to enable them." | The built-in widget needs native widgets, which your licence does not include. Contact JASP. |
| "This widget has no active bundle version. Ask a Widget Builder administrator to publish one." | No bundle version is active for this built-in widget. Contact JASP. |
Rendering
| Message or symptom | Cause | Fix |
|---|---|---|
| "This widget needs to be configured before it can be shown." | Required settings are empty. | Open settings and fill in the fields marked *. Readers see "Ask a page author …" — someone with edit rights has to set them. |
| "This widget is no longer available" | The widget was deactivated or deleted in Widget Builder. | Activate it again, or use Choose another widget in edit mode. |
| "Problem rendering this widget" (edit mode only) | Widget Builder reported warnings while rendering, for example missing data or settings. | Test the widget in the Widget Builder preview with the same settings. |
| "This widget is not supported on SharePoint." | The widget has no renderable template. | As Item not available. |
| "This widget renders through a native bundle, which the server cannot render. Update the Widget Builder web part …" | The web part in the App Catalog predates support for native widgets. | Upgrade the web part. |
| "This widget could not be loaded" with "The widget bundle could not be loaded from …" | A native widget's bundle did not arrive: a network error, or a Content Security Policy in your tenant blocks scripts from the Widget Builder address. | Check in the browser console which request is blocked and allow the Widget Builder address for scripts. |
| The widget appears but looks unstyled | Server-side styling was not available. | Check the widget in the Widget Builder preview. |
| The widget shows Staffbase content as unavailable | Staffbase users, spaces and sign-in do not exist on SharePoint. | Not an error. Such widgets are built for Staffbase. |
| "Something went wrong. Cannot read properties of undefined (reading 'replace')" | Web part older than 0.16.9 on a page created from a template, with PnP or via REST. | Upgrade the web part. |
Changes do not show up
| Symptom | Cause | Fix |
|---|---|---|
| A change to a widget does not appear | The page was not reloaded since you saved. | Reload the page. Widgets need no new package. |
| A new feature or fix of the web part does not appear | The App Catalog still holds the old package, or a package with the same version was uploaded again. | Download and upload the current package, then check the App version column (upgrade the web part). |
| The card shows Installed web part: not reported | No web part has loaded a widget since the registration, or it is older than 0.16.9 and does not report its version. | Open a page with the web part; if it stays, upgrade the web part. |