Skip to main content
All CollectionsAPI and Developer DocumentationAPI
Pre-fill form fields via GET or POST parameters in submission URL
Pre-fill form fields via GET or POST parameters in submission URL

Populate fields on a newly started submission by modifying the submission form URL.

Kunal Johar avatar
Written by Kunal Johar
Updated over 3 months ago

When creating a new submission it may be helpful to pre-fill some fields for the user.  A common use case of this may be a program that has many categories.  You may wish to have a home page that has a Begin Submission link for each category.

When the form loads it would be nice of the category was set exactly to avoid the user from having to select it.

To accomplish this you can use both GET and POST methods.

Configure Field Aliases
In the Submission Form > Developer Settings

You can see or edit the aliases for each field.


Build the Parameters
To pre-fill the form begin with the Direct to Program URL, for example
https://demo.secure-platform.com/a/solicitations/8/home

Then add the query string field.alias=value as follows:

Application Name Field
field.alias=value (when using 1 value)
field.alias.firstValue=first&field.alias.secondValue=second (when using 2 values)

Application Category
field.alias=categoryCode

Text Fields / Number / Date / Radio / Drop Down
field.alias=value

Checkbox Field
field.alias=value,value,value

Address Field
field.alias=countryCode:US,city:CityName,state:Name,zip:Zip,street:Street,line2:value

Table Field
field.tableName={field.alias=value, field.alias2.value}, {field.alias=value, field.alias2.value}

Rows should be in {} separated by commas; fields should be separated by commas


Example (POST)

<form action="https://demo.secure-platform.com/a/solicitations/8/home" method="POST">
<input type="hidden" name="field.yourName.firstValue" value="PostFirst">
<input type="hidden" name="field.yourName.secondValue" value="PostLast">
<input type="hidden" name="field.category" value="03-PLACES">
<input type="submit">
</form>
Did this answer your question?