JotForm is an easy-to-use online form builder used by businesses, educators, and entrepreneurs worldwide. It allows you to construct and customize forms to collect various applications and submissions and store and upload media, as well as other files. JotForm can be easily integrated with Uploadcare File Uploader.
With Uploadcare added to your JotForm forms, you’ll get the features of our File Uploader in addition to the benefits of JotForm: namely, serverless file uploads and in-browser image editing. Moreover, every file uploaded via Uploadcare gets instantly cached on our CDN and can be swiftly and reliably delivered across 130+ countries. Uploadcare File Uploader is highly customizable and adapts to your flows and layouts.
This article will guide you through the integration process by using an example of a form created to collect speakers’ data for an industry conference. We will combine JotForm with two file uploaders: one for speakers’ photos, and another for collecting the presentations.
If you’re familiar with JotForm, it should take you about 10 minutes to build a form like this using our File Uploader integration. Here’s what we’re going to get in the end:
Step 1. Creating an Account and Setting the Public Key
Since you’re here, you probably already have a JotForm account. If not, go to jotform.com and either sign up with your email or use your Google or Facebook profile.
To start working with Uploadcare, simply create an account by signing up on the website. Once you’re done, navigate to your dashboard: here, you can create a new project or have a look at the Public and Secret API Keys for an existing one.
Step 2. Create a Form and Add the Uploader
Creating a Form
Once you’re on JotForm, navigate to the My Forms tab. Here, you can find all the forms you’ve ever created with JotForm. You can manage the forms by creating folders and sorting different forms by categories (e.g., Submissions, Reports), archive and delete forms, and designate Favorites for quick access.
Let’s see what’s inside by checking the box to the left of the form title. Hit Edit Form, and you’re in. As you can see, there are two buttons for uploading files: one is called Choose an image, and the other, Upload images. Here’s how you add those:
Adding the Uploader
Click Add form element. Navigate to Widgets and type in “File Uploader” to run a quick search for our integration. You’ll see Uploadcare’s yellowish logo; click on it to add our File Uploader to your form. It’ll be added with default settings, but you can configure it to better fit your preferences. To do that, click on the Widget settings button to the left of the Upload File element of the form.
Step 3. Configure the Uploader
First of all, let’s set the label for your new file uploader. To do that, click on the Properties button represented by the gear icon to the right of the form:
This will open the Properties menu on the right side of the screen. Navigate to the Advanced properties tab. You can change the label by modifying the text shown in the Question Text field. For instance, instead of the default “Choose images” you can change it to “Your photo”:
Once the label has been modified, we can get more advanced. Go back to the Upload File element of the form and click on the Widget Settings button represented by the magic wand icon to the right of the form:
Here you can change the settings of your file uploader. To start with, paste your Public API Key into the relevant field. In the picture above, we’re using YOUR_PUBLIC_KEY as a placeholder. Below the public key, you’ll find further configurable settings for the file uploader.
First, let’s configure it to get the conference speakers’ photos. A single photograph will be enough, so let’s set the Multiple setting to No. It would be good to show the speaker a preview of the photograph she uploaded, so let’s set the Preview step to Yes. Finally, to avoid unnecessary clutter and confusion on the users’ side, let’s allow image files only by setting the Images only setting to Yes.
Uploadcare File Uploader is famous for its on-the-fly image transformation capabilities, so let’s give the speakers an opportunity to edit their photos while they’re being uploaded. To do that, go to the Effects Tab and tick the Yes box. You will then be able to choose which effects can be applied to uploaded images.
By default, the plugin removes the original trailing filename from the URL. There’s a setting called Add filenames: if you set it to Yes, it will add the original filenames to Upload CDN URLs, thus preserving your own file classification. This could be useful when passing URLs to a third-party system for further processing, for instance.
You can also automatically add a set of image transformations to a CDN URL. The Custom string setting allows you to process your files on the fly by adding URL directives to the CDN URLs. The Custom string field will hold a string to append to the CDN URLs in accordance with the transformation requirements. For example, it will add something like
/blur/ in your URL to apply a blur effect to the image. You can learn more about this by checking out our documentation.
Last but not least, you may also want to change the button caption. To do that, go to Additional global settings and modify the parameters there. Here’s a simple example of what you can do with the global settings: for the full list of File Uploader settings, please refer to the relevant chapters of our documentation.
Now you can add further uploaders to your form and configure them, e.g. to accept multiple uploads of images only. Actually, it’s possible to add multiple file upload elements to your form; as many as you need. For example, you may want to collect the speakers’ photographs and presentations, but also CVs, cover letters, and other additional documents.
Creating separate forms for each type of file may not be practical, though; it’s easier to allow multiple uploads through one form. Plus, it’s more useful to separate images from other files by using two separate uploading elements in your form.
You can tinker with the settings by allowing multiple file uploads, and changing the label and button caption. This second button will allow form users to upload slides for their presentations. In fact, you might want to create a separate Uploadcare project (and specify another Public API Key for the second file uploader) to collect those slides; this helps organize content in your account.
Step 4. Publishing and Testing
Now it’s time to publish the form and see how it performs. Before actually publishing it, however, it would be good to preview the form and make sure everything looks as expected. Simply flip the Preview switch in the top right corner of your screen and choose the device:
JotForm allows you to see how the form will look depending on whether it’s viewed from a phone, a tablet, or a desktop. On the left side, you’ll also see the direct link to your form. After making sure the form looks good, you can make it public. Publishing a form is as easy as hitting Publish. You’ll also see the automatically generated direct link to your form. You can then send that link to your speakers.
To test the form, click Open in new tab. That shows how your users will see the form. Fill in the fields and upload a photo:
Go back to My Forms and click the sheet icon to the left of your form title. This will open a list of your form submissions. You can navigate through those by clicking the arrows in the top right corner.
Please note that the files uploaded by form users become either a single URL for an avatar photo or a list of URLs for slides. Those are your file permalinks. You don’t need to have any storage for uploaded files: just put those links in your database. Check out this article to learn more about how those URLs are made and what they mean.
And that’s it! You now have your JotForm form powered up by Uploadcare’s File Uploader, giving you serverless file uploads, a CDN, and image transformations.