Using images in instructions

Adding Images to survey instructions
mWater allows for photos to be added surveys to provide a reference for enumerators. These can be added within "Instruction" questions or within the help button of each question. In mWater Surveyor the enumerator will then see this image from within the survey.

1) Create a photo link

The image needs to be hosted somewhere online so that it can be loaded into a survey. This can be a third-party service like imgur.com or it can be an image uploaded to mWater. The simplest way to upload images to mWater is to create a dashboard with an image widget and upload an image to it. Then open the image URL and make a note of it.

2) Paste photo link into the Survey

The two places where images can be added to surveys are within Instructions questions and any question with a "Help" option. Both methods use the same text to refer to the image link created in step 1. 

Please see the example for the special text that must be added to the image link to function correctly. 

Example image URL (Created in step 1):

https://api.mwater.co/v3/images/bda9ee0227374f538a0d9e6d2fea6261


Referencing the image:

![Alt text](PASTE_THE_IMAGE_LINK_HERE)

Complete example:

![Alt text](https://api.mwater.co/v3/images/bda9ee0227374f538a0d9e6d2fea6261)


You can adjust the size of the image by specifying the allowed height of the image. This can be done by adding "?h=[number]" to the end of the image URL. Thus

https://api.mwater.co/v3/images/bda9ee0227374f538a0d9e6d2fea6261?h=200

will limit the image to 200px tall.


Add an image in an Instuctions question
Add image in a question's Help section
Changing the image size
The image link will often be too large for the survey format, so it is important to resize the image in the surveyor by changing the height value in the image URL.
Example with h=200
Example with h=200
Example with h=1200
Example with h=1200