Knowledge base / Intranet Builder / Limits & known trade-offs
Good to know
Design decisions that follow from delegated permissions and from how SharePoint works. Knowing them helps you plan.
- Audience targeting is presentation only. If a Graph membership check fails, items are shown. It never grants or restricts access.
- Configurations are release-pinned. A bundle refuses configurations from another release; keep each bundle until its sites are upgraded.
- Run site commands from the same folder so they find their pending jobs in
.intranet-builder/. Keep the folder until the job completes. - Hub association needs a SharePoint Administrator when the configuration registers or associates a hub.
- Site owners see resolutions; employees see safe messages. Every failure carries an error code (
IB1001–IB9999) with a correlation ID and a link to the guidance. - Graph approval is tenant-wide. Approving a permission for SharePoint Framework solutions makes it available to every SPFx solution in the tenant.
- Language. The interface is in English. Date and time formats follow the site locale.
Troubleshooting shortcuts
| Code | Meaning | Fix |
|---|---|---|
| IB8001 | PowerShell or PnP.PowerShell missing or too old | pwsh ≥ 7.4.6, PnP.PowerShell 3.1.0–3.x |
| IB8002 | Sign-in failed | Check the installer client ID and its consent |
| IB8003 | Needs a SharePoint Administrator | Site creation, package deploy, hub registration |
| IB4001 / IB4002 | Package missing or older than the release | Deploy the current packages tenant-wide; update the site app |
| IB1009 | Another job holds the lock | Wait, or clear with Repair -Resource Lock when sure idle |
| IB3001 | Graph permission not approved | Approve in API access |
| IB5001 / IB5002 | Extension missing or outdated | Repair -Resource Extensions |
| IB8006 | Verification found remaining work | Re-run the install; inspect the remaining plan |
Every code with its resolution: docs/TROUBLESHOOTING.md. Job logs: .intranet-builder/logs/<jobId>.log (personal data and tokens removed).
Still need help?Our team answers product questions by email, and we can walk you through it on a call.
Open in the full guideContact support