The FormAssembly Form Transfer tool makes it easy for you to move your forms and connectors from your main app account (at the Professional or Premier level) to your Enterprise instance, as well as Enterprise to Enterprise instances.
You can move your forms and connectors on your own without needing to start a support ticket, of course we're here and ready to help if you run into difficulties!
Please note, that forms cannot be downgraded from Enterprise to App accounts. They can only be transferred from App (Professional and/or Premier) to Enterprise.
For information on upgrading, please contact our Sales Department at firstname.lastname@example.org.
Step 1 - Enable the API: In order to use this tool you will need to make sure that you enable the FormAssembly API for your enterprise instance. You can do this by first logging into your Enterprise instance and going to Admin Dashboard → User Roles:
Step 2 - Select the User Role: Next, you'll need to select the role of the user you want to transfer forms for, and then check Can use the API:
Step 3 - Enable your Server: Then you will need to add any servers that you want to tranfer forms to or from. You can add them by going to Admin → Settings → Miscellaneous → Form Transfer Settings. The main FormAssembly server (for Professional and Premier plans) is enabled by default:
Step 4 - Register the Third Party App: Finally, you will need to go to Admin Dashboard → Settings → Third Party Apps and choose Create new app
You will need to set the name to exactly: "FormAssembly Form Transfer" and then choose Save.
Edit the app you just created by clicking on the pencil icon and set the Client ID to VosD7L0xJzL7dkjJXTK2 and the Client Secret to m5xjILyKJNv8IuuNQaXJ then click save again.
Prior to beginning your form transfer, please make sure to read the Important Note about Form ID's below. You will need to ensure that the form you are transferring does not have the same ID as a form that already exists in the destination location.
To start your form transfer, make sure that you are logged in as the desired user (as defined above) on your Enterprise instance. This may require you to do an admin override as the user you want to transfer forms to.
Next, go to the Form Transfer Tool. It can be found here:
From here you will need to select the server to log into. You will need to select both the server you will be copying forms from, and the server you will be copying forms to. Select one on the right and one on the left, it does not matter which server is on which side.
Select the one that you want to connect to and choose to log in. Once there you will need to authorize the external access:
After logging in you will need to select the forms you want to move over and choose "Copy Selected # forms".
If you do not see any forms after authenticating, try refreshing the webpage without selecting "Log out all connections."
After that, you're ready to go! Your new forms will have been transferred over to the server you selected.
If you get any red exclamation points (!) when copying your form, you can visit your Admin Dashboard → Settings → Miscellaneous and at the bottom of the page increase your API quota to a large number (e.g. 10000) and try again.
What Gets Copied
When you use the Form Transfer tool, you are essentially copying the form to a new location, so the form will still be available in its original location as well, once the transfer is complete.
Additionally, when you transfer a form, the connectors and theme will be transferred along with the form.
The only things that are not transferred are form settings you have on the display, configuration, and/or notification tabs, any associated images that were uploaded into a form, and response data (including form attachments).
You are able to reconfigure your notification and display/processing options on your new form once it has been transferred. Currently, we have no way of transferring response data or form images.
Predefined content can be added by transferring this form via the Form Transfer Tool. After transferring this form to your instance, follow the instructions below.
- Admin Dashboard - Templates - Predefined Content
- Click Edit Settings
- Click Start all new form with this template
- Click Apply
- Click Back to Forms List
- Click New Form (The predefined content form will open.)
- To add Google Analytics to your Predefined, click on the last page, page 8.
- Now click on the Google Account ID field
- Click Options
- Click Save as Predefined Content from the menu
- Give it a name and click Save
This element will be available in the Add Content menu for the Enterprise user that you currently logged into.
To get back out of Predefined mode so that when you create a new form it won’t auto open that form:
- Click on Admin Dashboard - Templates - Predefined Content
- Click Edit Settings
- Uncheck Start all new form with this template
- Click Apply
If you are transferring your forms to an Enterprise instance, you will need to update any links pointing to the form. The links should reflect the URL of your newly transferred forms. The correct URL may be located on the Publish page of your form.
If you are running into difficulties with the Form Transfer Tool, please check that you have whitelisted the following IP Addresses:
|Start IP Address||End IP Address|