PDF Appearances

The generation of PDFs from survey data can be styled using appearances in the survey. Hence this reference section on styling PDFs is included here even though it is not related to the collection of data but the viewing of it. The online editor will guide you through setting appearances for PDFs however here is the complete reference which will be useful if you are using the spreadsheet editor.

PDF Appearances:

Appearance	Result	Comments
pdfaddto_xxxxx	replace xxxxx with the name of another question. The answer to the question that has this appearance will be appended to the answer of the specified question.	Answers from different question are comma separated. Commonly you would use this on an 'other please specify' question and you would also set the appearance 'pdfno' so that the other response appears with the select question.
pdfapp	Put the question in an appendix after all the other questions
pdfbarcode	Show the data as a barcode
pdfbs	Show a date in Bikram Sambat	Note the timezone of Bikram Sambat dates will always be Kathmandu time.
pdfcols_##_##_##....	This sets the number of columns in which to place the data. Each ## is a column. Replace each one with a number indicating the width of the column, all of these numbers should add up to 10. Hence the maximum number of columns is 10.	For example: pdfcols_3_4_3 3 columns pdfcols_5_5 Two equal sized columns pdfcols_10 Single column The column settings apply to the question that you add the appearance to, and all subsequent questions until it is overridden by another pdfcols appearance.
pdfheight_##	Set the height of the box allowed for the question answer. This is in points.	This value only applies when exporting a blank template. If there is data in the export then the size of the data will determine the height of the box. A value of 150 would be roughly 10 rows. For example pdfheight_150
pdfhideindex	Hide the indentation and repeat index shown in sub fomrs	Use with begin repeat questions
pdfhiderepeatinglabels	In subforms only the label for the first record will be shown	Set this on each question in a subform that you want to have this behaviour
pdfhyperlink	Show a link for a picture question instead of the image
pdflabelbg_##_##_##	Sets the background color for the label. Use Hex RGB values	For example: pdflabelbg_FF_00_00 Set the background to red.
pdflabelbold	Make the label bold
pdflabelcaps	Put the label in capitals
pdflabelw_##	Set the width of the question label. Replace '##' with a number from 0 to 10.	Setting the width to 10 will make the question answer appear on the next line.
pdflocation_xxxx	Replace xxxx with the default location and zoom of your map in the format: longitude, latitude, zoom	Use with maps Example: pdflocation_121,14.6,16 Would create a default map of part of Manila.
pdfmap_xxxx	Replace xxxx with the id of the mapbox map that you want to show in your PDF exports	You will need to set a map box id if you are running your own server. The Mapbox vector map style ids can be found here. https://docs.mapbox.com/api/maps/#styles
pdfmapsource_xxxx	Replace xxxx with either "google" or "mapbox" to specify the source of a static map image to include in the PDF	pdfmapsource_google pdfmapsource_mapbox
pdfmarkercolor_##_##_##	Sets the color for the marker used to show location on maps. Use Hex RGB values	For example: pdmarkercolor_00_FF_00 Set the background to blue.
pdfnewpage	Start the question on a new page
pdfno	Question will not be included in a generated PDF
pdfround_##	Set the number of decimal places.	Use with decimal questions to restrict the number of decimal places that are shown. For example pdfround_2
pdfshowimage	The choice image will be displayed instead of the choice label.	Use with select one questions that include images in the choice list. Available in v21.12
pdfspace_##	Insert a gap in the table before this question.	The spacing is in points. 1/72 of an inch.
pdfstretch	Stretch an image to fit the space it has been allocated. This only works when exporting to a pdf template.	The ratio between width and height will not be maintained. Available in v21.12.
pdfvalue	Show the value for a choice rather than its label	Use with select and select one questions By default, when displaying data from a select question, the labels of the selected choices are shown. If this appearance is added to the select question then the values of the choice are shown.
pdfvaluebg_##_##_##	Sets the background color for the value. Use Hex RGB values	For example: pdfvaluebg _FF_00_00 Set the background of the value cell to red.
pdfzoom_xx	The longitude, latitude of the data being displayed will be combined with the specified zoom value to show the map	Use with maps Available zoom levels will depend on the map you are showing. Often between 1 and 21. Example pdfzoom _5