Search for answers or browse articles about Sintel Apps
Upgrading from Sintel Forms to Sintel Apps (Forms Migration Guide)
This article explains how to migrate an existing Sintel Forms configuration to the new version of Sintel Apps.
The migration tool imports your existing form configuration into the new designer and rebuilds the form structure on the same SharePoint list.
Importantly, nothing goes live until you save it.
Before You Start
Before beginning the migration, please ensure:
-
You have Full Control permissions on the SharePoint site.
-
There are no critical workflows currently running.
-
If your form is complex (for example, it contains extensive JavaScript or advanced workflows), you consider testing the migration on a separate site first.
Step 1 – Install the New Version of Sintel Apps
- Add the new version of Sintel Apps to your SharePoint site. –
Installation instructions are available here
Configuring Sintel Apps on your site is available here - Once added, open the new version of the app from your site contents.
Step 2 – Import Existing Configuration
When you open the new version:
-
The system will automatically detect any existing Sintel Forms configurations on the site.
-
You will be prompted to import the existing configuration.
-
Select Yes to begin the import.
The system will then:
-
Read your existing configuration
-
Rebuild the form layout
-
Recreate logic rules
-
Recreate workflow configuration
-
Apply relevant settings
At this stage, the form is rebuilt in the new designer — but it is only a preview.
Nothing is live until you save.
Step 3 – Review Migration Notifications
After the import completes, a notification pop-up will appear.
This may include:
-
Warnings about deprecated settings
-
Features that require review
-
Minor compatibility notes
These are informational alerts to help you review the migration.
Colour Indicators
Within the migration summary:
-
Blue – Successfully migrated
-
Orange – Requires review
-
Red – Requires attention
Important: How Saving Works
It is essential to understand how publishing works during migration.
-
The imported form in the new designer is initially a preview.
-
It does not affect live users until you click Save.
-
The most recently saved designer (old or new) is always the version that is active on the SharePoint list.
Recommended Approach During Transition
If you are not ready to fully switch to the new version, we recommend the following approach:
- Allow the form to be rebuilt in the new designer during the migration process.
- Review the migrated form carefully.
- Make any required changes or improvements.
- If there are outstanding items but you would like to keep your progress, click Save in the new designer to store your updates.
- Then return to the old Sintel Forms designer and click Save there.
By saving in the old designer after saving in the new one, the old version becomes the active version that users will see and use.
This means:
-
Your progress in the new designer is retained.
-
Your live users continue using the familiar, stable version.
-
You can continue refining the new version in stages.
-
When you are completely satisfied, simply save in the new designer to make it live.
You can move between designers during your transition period. The version that is saved most recently is always the one that runs on the list.
This allows you to migrate, review and refine your form safely without disrupting users.
For complex forms contatining a lot of custon JavaScript, it is reccommmended you try the migtration on a test site and only migrate the live form when you bare confident everything works as expected
Summary
-
Migration rebuilds your existing form in the new designer.
-
Nothing is live until you click Save.
-
The last saved version (old or new) is always the active version.
-
You can safely return to the old designer at any time until you are ready to switch.
This approach ensures a smooth and controlled transition to the new version of Sintel Apps.