iFormBuilder Common Questions
The iFormBuilder platform allows you to add several different kinds of images to your forms. Adding images to a form can make your form more visually appealing while also increases the ease of use for your collectors. Below you will find the various ways to improve your forms through the use of images.
PLEASE NOTE: All images should be saved as png files. Any other file types will cause the images to fail.
Image Label
The purpose of the Image Label is to form builders to add images to their forms. Since these inputs are labels, they will not appear in your data, and will only be visible on the device. To use Image Labels you need to define the directory where the images live in the Edit Form Properties section of a form.



Element Input (Widget) Icons
Similar to image option lists, each element on your form can have an icon. The image file name needs to match the data column name within the form.
Since each new form could have a column named “iform”, you can re-use the same image across many forms but not in the same form. These images need to be placed in the same directory as your Image Label assets. So Lets say we have a Dropbox Folder called iform with the following 4 images inside the iform folder:
In the Edit Form Properties Page on the Parent Form, link to the dropbox folder housing the images via the Label Icons URL. The link should be similar to the one in the image below:
From here each data column name in FormBuilder should be called item1, item2, item3, and item4. These data column names will then reference the PNG files in the dropbox folder.
In the following example, the element's label is First Name. The Data Column name is item1.
Image Icon Option Lists
You can link images to options in a list by creating images with the same file name as the option key value. Similarly to how you had to define the Label Icon URL for the image icons above, you need to define the path where all of the images live for the Option Lists as well. This is done in the Option List Manager. Click on the Icons URL section in the Option List Manager to expose the URL field.
In this case these images are hosted in my dropbox folder iFormPics. Each image in the Dropbox Folder have the same name as the KeyValue of the option.
Note: KEY_VALUE is the name of each different option in the list and can be found under the Advanced tab of the Option List Manager.


Pick-List Option List


Comments
4 comments
will this work when offline?
Are there limitations to what formats the images are allowed to be in?
@Daryl, this will continue to work when disconnected from the web as all assets are downloaded to the device at the time of sync.
@Simon, you should be using .png for all assets.
Cheers,
Tony
When uploading a label image with dropbox, should this appear on other users profiles when you share the form. I am having a problem where i can get the uploaded images to appear on my own profile, but if i share the form to a different user group, and allocate viewing/collection rights, the images do not appear.
When you direct the image label to the correct .png, does iForms store a local copy or could this be related to users not having access to my dropbox?
Please sign in to leave a comment.