Troubleshooting Guide
Common issues and how to resolve them. Can't find your issue here? Contact support@sharepointtoolkit.com.
Most Common Issue: Licensing Service Connectivity
If you see "Unable to confirm licence" or trial activation doesn't work, the licensing service may be blocked by a corporate proxy or firewall.
See Solution"Unable to confirm licence" or licensing error after install
Cause: The licensing service cannot be reached — usually a network or proxy issue
Solution
SP Toolkit connects to a cloud licensing service to validate your trial or licence. No API permission approval is required — it works automatically.
sharepointtoolkitgr81e7.azurewebsites.netTrial activation button does nothing or shows an error
Cause: The licensing service cannot be reached — usually a network or proxy issue
Solution
Trial activation connects to the SP Toolkit licensing service automatically. If it's not working:
- Clear your browser cache and refresh the page
- Check if you're behind a corporate proxy that blocks external APIs
- Try a different browser or incognito/private mode
- Contact support@sharepointtoolkit.com if the issue persists
Cross-tenant authentication fails or pop-up is blocked
Cause: Pop-up blocker or missing app registration in source tenant
Solution
Cross-tenant migrations require an app registration in the source tenant:
- Ensure pop-ups are allowed for your SharePoint site
- Verify the app registration exists in the source tenant with correct redirect URIs
- Check that the required Graph API permissions are granted with admin consent
- See Cross-Tenant Migration Guide for detailed setup
"Access denied" or "Insufficient permissions" on target site
Cause: Current user lacks required SharePoint permissions
Solution
The user running the migration needs sufficient permissions on both source and target sites:
- Target site: Full Control or Site Owner permissions
- Source site: At least Read access (for same-tenant migrations)
- For cross-tenant: delegated permissions via app registration
Contact your SharePoint administrator to grant the necessary permissions.
Migration slows down or items fail with 429 errors
Cause: SharePoint Online is throttling requests due to high volume
Solution
SharePoint throttling is normal for large migrations. The toolkit handles this automatically, but you can help:
- Switch to Conservative throughput preset in Migration Options
- Run migrations during off-peak hours
- Break large migrations into smaller batches
- Enable "Skip errors and continue" to handle transient failures
Fields are missing or data appears incorrect after migration
Cause: Field type mismatch or unmapped fields
Solution
Review the field mapping step before executing migrations:
- Check the Field Mapping step for any warnings or unmapped fields
- Use Structure Only mode first to verify field compatibility
- Review the migration results JSON for detailed field-level issues
- See Field Types Reference for supported types
Still Need Help?
If you're experiencing an issue not listed here, our support team is ready to help.