This advanced guide includes tips and tricks, and also solutions to common issues you may face when using Form. This section is updated regularly, so feel free to check back once in a while.
Where is the signature field?
There are a few variants of electronic signatures available on Form, all of which, according to the Electronic Transactions Act, are not legally weaker than a wet ink signature. Agencies such as IRAS and MOM have used the following for electronic signatures: a) an NRIC field, b) an attachment of a wet ink signature and c) SingPass Login.
Is there an address field? How can I auto-populate one?
You may create a Postal code field with Short Text that validates 6 characters, together with a few more fields for block and unit numbers. Do not use a Number field for Postal code as Numbers cannot start with zero. If verified addresses are needed, you may enable SingPass on your form, and drag in a Registered Address MyInfo field.
When should I use a radio button vs a dropdown field?
For 6 or fewer choices, it is advised to use a radio button, as there are only a few options to display:
For >6 choices, you should use a dropdown field:
Can my forms support multiple languages?
Yes it can. Form title has to be in English, but instructions and fields can be in any language. For example, you can specify form fields in English, and provide translations in field descriptions. Your users can also submit your form in any language they want - they just have to switch to the respective keyboard on their device.
How do I increase attachment size limit? And what if there are many attachments for my form?
The current attachment size limit for one form is 7MB for email mode and 20 MB for storage mode. We auto-compress images to 1024x768 resolution, which is typically less than 1 MB. Because the smallest unit you can attach per attachment field is 1 MB, you can have a max of 7 (email) and 20 (storage) attachments on your form. Zip files are considered one attachment.
How do I send users’ responses to them?
You can currently do that in Email mode, under the “Email” field.
What is pre-fill?
Selecting ‘Enable pre-fill’ on a form field allows the field value to be pre-filled or pre-populated when a public form is loaded, before the respondent has entered any value. This is done by adding the pre-filled value in a specific format to the public form’s URL which the respondent accesses.
Pre-filling adds convenience for the respondent when field values are known beforehand. For example, a customer service ID can be pre-filled and added to a URL before sending it to a customer for feedback; or the form URL made available to respondents from a specific school or location can be customised to pre-fill that school or location in the relevant field.
Note that anyone, not just the form admin, can pre-fill values in a form URL and disseminate it. This is an important security consideration and should be taken into account when deciding which fields to enable pre-fill on. You might not want to enable pre-fill on certain fields if doing so could allow your form to be used for scams.
Pre-fill is currently only available on Short Text fields and may be released for other fields in future.
How do I use it?
Step 1: Activate ‘Enable pre-fill’ on your Short Text field. After saving the field for the first time, a Field ID will be generated. You will need this to pre-fill your value in the form URL.
Step 2: Add the Field ID and value you want to pre-fill behind your regular form link in this format: ?<Field ID>=<Your pre-filled value>. For example, if:
- Your form URL is https://www.forms.gov.sg/60879eb7bdb1e20012f0a5d3
- The Field ID is 6087cae5c873820012830619
- The pre-filled value is Yew Tee Primary School
Then the pre-filled URL would be https://form.gov.sg/60879eb7bdb1e20012f0a5d3?6087cae5c873820012830619=Yew%20Tee%20Primary%20School
Spaces are allowed for the pre-filled value, represented as %20 in the URL. For #, please use %23.
Can I have more than one pre-filled value?
Yes. In that case, you should separate the Field ID / Pre-filled Value pairs with an ampersand &. For example, if:
- Your form URL is https://www.forms.gov.sg/60879eb7bdb1e20012f0a5d3
- The first Field ID is 6087cae5c873820012830619
- The first pre-filled value is Yew Tee Primary School
- The second Field ID is 608800e140ea4700110c4f0e
- The second pre-filled value is Class 1A
Then the pre-filled URL would be https://form.gov.sg/60879eb7bdb1e20012f0a5d3?6087cae5c873820012830619=Yew%20Tee%20Primary%20School&608800e140ea4700110c4f0e=Class%201A
Can form users modify the pre-filled value(s)?
Yes, respondents are able to edit any values that have been pre-filled. Editability ensures that all field values are truly what form respondents intend to submit, and is a form of protection against scams.
If you do not want your respondent to edit the pre-filled value, such as a tracking ID, please inform them not to do so in the field instructions. This method has been proven effective in national-scale operations with over 1 million responses.
Is pre-fill available for all fields?
Pre-fill is currently only available on Short Text fields and may be released for other fields in future, depending on demand.
How do I know if the logic for the form is correct?
When you implement a new logic, you should test it yourself via the preview page. Note that the onus is on you to verify the correct logic for your form.
How do I route responses to different emails based on form option selected?
This might apply for an enquiry form. If user chooses “Complaint” response should route to Complaints Department, but if user chooses “IT” response should route to IT Department. There’s no such feature within the Form interface, but you can set mail forwarding rules on your email. For example, one such rule can detect “Complaint” in the form response email, and forward this to the Complaints Department automatically.
To set such mail forwarding rules, you have to Create Rule, then select Advanced Options. Next, select the condition as “with specific words in the body”:
Click on the underlined “specific words”, and specify “IT department”. Next, select the action as “forward it to people or public group”:
Click on the underlined “people or public group” and specify the IT department’s email.
What is Storage mode?
Storage mode is a method of receiving form responses. Form admins can choose between
Storage mode and
Email mode for each form.
Under Storage mode, form administrators can view responses within form.gov.sg and export collated responses in spreadsheet format. To access these responses, form administrators must first enter a secret key that was generated upon form creation.
All responses are stored in encrypted format, meaning no one except form administrators will be able to view or download responses. Storage mode is permissible for data up to “Restricted” classification and “Sensitive Normal” sensitivity.
Note: The following features are currently not available in Storage mode. If you need to use these features with your form, please select Email mode.
- MyInfo fields
- Emailed copy of response to respondent
What browsers are compatible with Storage mode?
Respondents can use any browser to submit a form on Storage mode. For form admins, we strongly recommend using Chrome, Edge or any browser other than Internet Explorer (IE) for quicker response retrieval, as IE tends to have low processing power and will take a longer time to decrypt responses.
When should I choose Storage mode?
Storage mode will be more convenient for the majority of users, especially when there is a high volume of anticipated responses. You will no longer have to manage or manually collate your form responses from your email inbox. Storage mode is permissible for data with “Restricted” classification and “Sensitive Normal” sensitivity.
However, you should choose Email mode if
- your data is classified “Confidential” or “Sensitive High”
- you require MyInfo fields or emailed response copies to respondents
How do I switch my form from Email mode to Storage mode?
You will have to duplicate your Email mode form and recreate it as a Storage mode form. On your dashboard, hover over your Email mode form and click the duplicate icon. Then select ‘Storage mode’ and follow the steps below to create a duplicate form in Storage mode.
How do I use Storage mode?
1. Create a new form and select Storage mode
2. Download your secret key
You and any collaborators will need this secret key to activate your form and access form responses. Learn more about secret keys.
Note that if you lose your secret key, your form responses will be permanently lost. Here’s how to avoid accidentally losing your secret key.
3. Share your secret key with collaborators (if any)
Any collaborators you invite will need the secret key to view form responses. Share your secret key with collaborators through a secure channel, according to your agency’s security policies.
4. Build your form as per usual
5. Activate your form
To activate your form and start sharing it with respondents, enter or upload the secret key you downloaded at form creation.
6. Unlock form responses
With Storage mode, you can access form responses and feedback within Form in the new ‘Data’ tab (previously ‘Results’).
To unlock your responses, enter or upload the secret key you downloaded at form creation. This will give you access to view and export your form responses.
7. View and export responses
Once you have unlocked your responses with your secret key, you will be able to view your collated form responses within Form. Download your form responses by clicking the Export button.
Click on each list item to view the full response.
You can also view and download your feedback data in the Feedback tab.
What is a secret key?
Your secret key is a string of text and numbers used to encrypt and decrypt your form responses. Each secret key unlocks the responses to one form only. No one will be able to view your form responses unless they have your Secret Key.
You will need your secret key at 3 points in your Form journey:
- Form creation: download secret key
- Form activation: enter/upload secret key
- Access responses: enter/upload Secret Key
Your secret key is generated by your browser during form creation, and downloaded to your computer or mobile phone. We do not save or store your secret key, and it is the only way to access your response data. This is why you should be careful not to lose your secret key, as if you do we will not be able to help you regain access to your response data.
I am encountering a secret key error or I have lost my secret key! Are you able to help me recover the secret key or my response data?
If you have lost your secret key, take these steps immediately:
If your form is live, duplicate your form, save the new secret key securely and replace the original form’s link with the new form’s link to continue collecting responses. Deactivate the original form as soon as possible to avoid losing further responses. Do note that duplicating your form only copies all the fields but not existing responses.
On the computer you used to create the original form, search for ‘Form Secret Key’. Secret keys typically downloaded into your Downloads folder as .txt files with ‘Form Secret Key’ in the filename.
If you have created multiple forms with similar titles in the past, it is possible that you have confused the different forms’ secret keys with each other, as form titles are in the secret keys’ filenames. Try all secret keys with similar filenames on your form.
If you remember sending an email to share your secret key with collaborators, search the Sent folder in your email for the keyword ‘secret key’ and your form title.
If you are still unable to find your secret key, you will not be able to access your existing response data. Additionally, it’s not possible for us to recover your lost secret key or response data on your behalf. This is because Form does not retain your secret key or any other way to unlock your encrypted data - the only way to ensure response data is truly private to agencies only. This is an important security benefit, because that means even if our server were to be compromised, an attacker would never be able to unlock your encrypted responses.
How do I make sure I don’t lose my secret key?
To make sure you don’t lose your secret key(s), and permanently lose access to your form responses, you can
- Share secret key(s) with colleagues that are also authorised to view form responses;
- Store secret key(s) in a third-party password manager tool, if your agency uses one;
- Store multiple secret keys and associated form links on a spreadsheet in your government-issued laptop;
- Regularly check in on your form responses to make sure that you still have your secret key.
What if my secret key has been accidentally circulated?
- Promptly back-up your form data by downloading form responses and feedback from Form.
- Duplicate your old form and publish a new form with a new secret key, and continue gathering responses with this new form.
- When you have done Steps 1-2, email us to delete encrypted responses from the old form so that no one will be able to access your responses with the leaked secret key.
Is there a storage limit for Storage mode?
No. There have been forms with over a million submissions on Storage mode. In the future with the release of attachment, we will still not impose a limit on number of responses for Storage mode.
Can I delete my responses in Storage mode?
For audit reasons, deleting responses is not allowed. However, if you wish to reset your response count to zero after testing your form, you can simply duplicate your test form and create another Storage mode form. You can then use your new form as your live form instead.
What is the storage duration? How long will my responses be stored for?
Form will store your encrypted responses permanently, and they will be accessible as long as you have the secret key.
If you no longer need to access your form responses, you can simply discard your secret key. Without your secret key, your form responses cannot be decrypted, and are as good as gibberish.
How does end-to-end encryption work?
When a respondent submits a response, response data is encrypted in the respondent’s browser before being sent to our servers for storage. This means that by the time Form’s servers receive responses, they have already been scrambled and are stored in this unreadable form. Your response data remains in this encrypted state until you decrypt your responses with your secret key, transforming them into a readable format.
The benefit of end-to-end encryption is that response data enters and remains in Form’s servers in an encrypted state. This ensures that even if our servers are compromised by an attack, attackers will still not be able to decrypt and view your response data, as they do not possess your secret key.
Who can see my form responses in Storage mode?
To view responses from Storage mode forms, you have to
- be a form owner or collaborator, and
- know the secret key generated at form creation
The secret key is the only way to view your responses in a readable format. As Form’s servers do not store your secret key, no one can view your response data, except you and collaborators that you share the secret key with. Even Form developers and administrators with full access to the server cannot view your response data, as we do not possess your secret key.
Can I enable both Storage and Email mode?
You may select either Storage or Email mode for a single form, but not both.
What is Email mode?
Storage mode is a method of receiving form responses. Form admins can choose between
Storage mode and
Email mode for each form.
If you select Email mode, your form responses will be sent to email addresses that you specify. Form will not store your form responses for security purposes.
Email mode is permissible for individual responses classified Restricted Sensitive High and below, and collated data classified Confidential and below.
When should I choose Email mode?
You should choose Email mode if
- your data is Confidential or Sensitive High
- you require MyInfo fields, or emailed response copies to your respondent
In most other situations, Storage mode is expected to be more convenient, especially for forms with a high volume of anticipated responses.
How do I ensure my form responses will not bounce?
If your mailbox is full or your email address is no longer valid, form responses will bounce and be permanently lost. Here are some ways to prevent this:
Set up auto-archiving on your mailbox to ensure that your mailbox will never hit full capacity.
You can set up auto-archiving in your Outlook by navigating to
AutoArchive Settings(right). Run
AutoArchiveas often as you expect your mailbox to be full - if you expect high response volume, you can run
Enter 2 or more email addresses where responses will be sent, for all your Email mode forms.
You can find this setting by logging in to form.gov.sg, clicking on your form, navigating to
Emails where responses will be sent.
If you are leaving your department, make sure to update “Emails where responses will be sent” so that form responses will go to a colleague after you leave.
My form responses are lost! Can Forms help me recover them?
If your form is on Email mode, Forms does not store your response data for security purposes. We cannot recover any form data that you have lost.
If you cannot find your email responses, they might have been routed to an obscure Outlook folder set by your mail forwarding rules. Or they might have been quarantined by your agency firewall, which you can contact your AFM/IT department for. If you accidentally delete your email responses, they might still be on the email server, which you should contact your AFM/IT department for help.
Will my emails be blocked?
If emails are non-malicious, they typically will not be blocked. There are two junctures where they might be blocked, but the form submitter will know about it and will be able to retry:
When a user clicks Submit on his form, the response first goes to our server. Before reaching our server, we have a web application firewall that detects for malicious content and might block the submission. If blocked, a user will see a “Please try again later” message on the form.
If the form passes the web application firewall, it goes to our server, and we email it to your government email (SGMail) without storing it on our servers. If the government email does not exist then your response will bounce and the user will see a “Please try again later” message on the form.
From here on out, if the email is blocked, your user will not be aware. But there is still a way for you as the form creator to retrieve the blocked responses:
- If the government email exists, it proceeds to SGMail servers. Before it enters SGMail, it will arrive at SGMail’s firewall. This firewall will block out emails if there are attachments with non-whitelisted file extensions, for e.g. “.abc” or “.mov”. We are not aware of the full list of file extensions that SGMail whitelists, but most of the file extensions that are whitelisted can be viewed here on our spreadsheet. If your email gets blocked due to non-whitelisted attachment file extensions, you will receive a mail hygiene notification. You may contact SPEAR (email@example.com) within 1 month from receiving the mail hygiene notification to retrieve the dropped mail.
How do I recover my mail when I receive a mail hygiene notification?
You may recover your blocked email within 1 month if you email SPEAR (firstname.lastname@example.org) and attach the mail hygiene notification.
Is there any way to receive my responses in an Excel spreadsheet?
Yes! Other than using Storage mode to download a spreadsheet of your responses directly, you can also collate your Email mode responses into a spreadsheet using the Data Collation Tool.
Data Collation Tool
Where is the Data Collation Tool? I can’t find it.
Since we moved to the Intranet start of 2020, Data Collation Tool has shifted from the old link of https://form.app.gov.sg to the new link of https://collate.form.gov.sg.
If you are not able to access the new link, visit Proxy Settings, toggle “Use setup script” on, and insert: http://proxy.sgnet.gov.sg:4714/files/proxy.pac. Appreciate if you can also approach your agency IT to push this proxy setup to your colleagues.
If this does not work, use the old link of https://form.app.gov.sg on the Intranet. If you are not able to access it, get your IT team to whitelist 10.54.9.38, 10.54.9.34 and 10.54.9.57 on your agency firewall
As a last resort, you can use our Internet collation tool at https://collate.form.gov.sg. Transfer your .pst file of responses to your Internet machine via a secure thumb-drive, visit the link, and follow the instructions to collate your responses. Note that your data is not exposed to the Internet as the tool does not upload data to a server. Data is collated offline on the browser.
Excel responses from table style questions are clumped into one line, how do I separate them?
- Open the excel sheet generated from our Data Collation Tool
- Select the entire column of the responses
- Go to the Data tab and choose Text to Columns > Delimit by comma (,).
Does my data go to your server when I use the Data Collation Tool?
No, your data is not seen by our server during the Data Collation Tool process. Aggregation of your email responses happens offline on your browser.
SingPass, CorpPass and MyInfo
How do you enable SingPass or CorpPass?
All you have to do is enter an e-service ID on the Settings tab of your form to enable SPCP:
An e-service ID is a unique billing ID given by the SingPass/CorpPass office to your department’s finance team. An invalid e-service ID will yield a 138 error for SingPass and 328 error for CorpPass. If you don’t already have an e-service ID, you can either ask your agency IT department to find an e-service ID to reuse, or contact SPCP rep email@example.com to create a new one. When testing your e-service ID you may log in to our UAT server, https://uat.form.gov.sg and create test forms there. Note that accounts and forms are separate on UAT and Live servers and cannot be transferred over.
To track number of submissions at your e-service ID you may visit the Billing Panel tab on the top right of your forms dashboard:
It is up to you to decide if you want 2FA or 1FA e-service ID. For CorpPass, it is also up to you to decide whether you want authorisation work flows at your e-service ID. Consult SPCP rep on this if you have concerns.
What are webhooks, and why are they useful?
Webhooks are a standard means for applications like Form to send real-time data to other applications and servers.
Webhooks are useful for agencies who wish to have form response data sent directly to existing IT systems. This removes the need for a human user to periodically export form response data from form.gov.sg, then upload it to an internally-used application. The permissions of that webhook handler, including which databases/tables it can write to are left up to respective agencies. Agencies should follow the usual security practices of software development to limit the reach of the handler.
Examples of Webhooks used
TemperatureSG: One of the early responses to COVID was to record and report temperature daily. Many agencies did that with formSG forms, but sifting through the data, to figure out who had a fever or who had not responded was too onerous. TemperatureSG was a webhook integration, which made it easy to automate handling temperature responses. It would alert admins when one of their staff had high temperatures, and it would check daily for staff that had not reported their temperature.
Zendemic operations: When people were tested positive for Covid, a form was sent to them, so they can list their close contacts, and give additional details about their health situation (which would dictate the sorting logic for them under MOH guidelines). As cases grew, handling the form responses became too onerous to do by hand, we implemented webhooks to read and process covid form responses, and inject data into a case management system.
Who should use webhooks?
Webhooks are worth considering if your agency
- expects to receive a high volume of responses
- needs to integrate internal systems/workflows with form data collection (e.g. sorting responses, and channeling them to specific officers for case management)
- has IT expertise capable of using our software development kit to prepare an endpoint for receiving response data
- only requires one way API where FormSG sends responses over
Webhooks are not necessary or beneficial in most form use cases, where officers are following up over email or Excel spreadsheet, since Form already outputs responses in those formats.
Are webhooks secure?
Yes - as webhooks are a Storage mode feature, your data is end-to-end encrypted as with all Storage mode responses. Our software development kit (SDK) provides instructions on setting up your receiving system to
- verify that each submission was sent by Form and not any other server
- decrypt submissions using the secret key that only you own
If you are required to validate webhook calls by whitelisting a fixed origin IP, please whitelist FormSG (184.108.40.206) and provide us your IP addresses through our Form support. If your agency can validate FormSG webhook calls based on payload and signature, there is no action required.
How do I set up webhooks for my form?
Pre-requisite: You must be able to expose a HTTPS endpoint that is accessible over the Internet.
Follow these instructions to prepare your system to receive, verify and decrypt form responses. Please lock down the version of the SDK you are using and disable automatic upgrades to avoid disruption from breaking changes.
Navigate to the form you want to set up a webhook for. In the Settings tab, enter your endpoint URL in the ‘Webhook Endpoint URL’ field and save changes.
Test that responses are received at your endpoint URL.
Important to note
- Please lock down the version of the SDK you are using and disable automatic upgrades to avoid disruption from breaking changes.
- You are responsible for correctly setting up your system to receive, verify and decrypt Form responses using our SDK. Form is not responsible for your setup, and only bears responsibility for ensuring our servers are correctly routing responses in accordance with our SDK.
There is a problem and my system is not receiving data from Form. Are my responses lost?
Your responses are not lost as all Storage mode responses are stored encrypted in Form’s database. As with all Storage mode forms, you can retrieve your data by simply logging in to Form and using your secret key to decrypt and export responses in .csv format.
What are webhook retries? Should I enable them?
If you switch on “Enable retries” under the Settings tab, Form will resend webhooks if your IT system fails to receive them. In order to safely receive webhook retries, your system should be designed to handle:
- Duplicate webhooks. A webhook for a given submission may be re-attempted multiple times, even if the earlier attempts were successful. We advise you to guard against duplicate webhooks by making your submission processing idempotent. One way of doing this is storing the submission IDs you’ve already processed, and then not processing already-logged events.
- Out-of-order delivery. Retries may not be delivered in order of the time that the form was submitted, but you may use the
createdproperty on the decrypted body to determine when the submission was made.
- Non-realtime submissions. Retries may not be appropriate for a system that relies on real-time behavior for user interactions.
- Submissions even after the form is no longer active. If your form is submitted successfully while it is active, the webhook for that submission will be retried for up to 24 hours after the time of submission, even if the form is made inactive during that time.
How does Form determine whether my system received the webhook successfully?
If your IT system returns any HTTP-2xx response code, the webhook is considered to have been successful. However, due to technical limitations, there is a small chance that even when your system returns an HTTP-2xx response, a duplicate webhook may be subsequently sent for the same submission. Your system should account for such duplicates if you wish to enable retries.
Conversely, the webhook will be retried if your system returns any non-2xx response code.
How many times does Form retry the webhook for each submission?
The webhook is first attempted once immediately after the form is submitted. If this first attempt fails, the webhook will be retried up to 6 additional times over the next 24 hours, at the following intervals from the time of submission:
- 5 ± 1 minute
- 60 ± 15 minutes
- 2 ± 0.5 hours
- 4 ± 1 hours
- 8 ± 2 hours
- 20 ± 4 hours
Retries will cease whenever the webhook is successful. For example, if the initial webhook attempt fails but the first retry attempt 4-6 minutes later succeeds, there will most likely be no more retries. Again, there is a small chance of duplicate webhooks even when previous attempts were successful, and your IT system must be able to handle these duplicates.
If your system fails to receive the final retry 16-24 hours after the form is submitted, the webhook will no longer be attempted. You may still retrieve the submission data under the Data tab.
Verified SMS Paid Service
The Verified SMS feature on the Mobile Phone field triggers an SMS containing a One-Time Password (OTP) to the entered mobile phone number, so that form respondents can verify that the entered number belongs to them.
Do I have to pay for Verified SMS?
Verified SMS is free up to 10,000 responses per user. The free smses are tied to owner of the form.
However, if your form might receive over 10,000 responses, your agency will have to pay for verified SMS by setting up your own Twilio account (see instructions below). To be safe, please arrange payment before activating your form. Once your form has exceeded 10,000 responses, either the Verified SMS feature or the form itself will have to be deactivated, and Form reserves the right to charge your agency for past SMS expenditure.
How do I arrange payment for Verified SMS?
We recommend that you arrange payment before activating your form, in case a high volume of responses are submitted and bust your free tier. Once your form has exceeded 10,000 responses, either the Verified SMS feature or the form itself will have to be deactivated, and Form reserves the right to charge your agency for past SMS expenditure. Agencies are also responsible for monitoring their own billing.
Step 1. Obtain approval within your agency to pay for verified SMS through Twilio. Twilio is the paid SMS service that Form uses to send OTP verification SMSes to mobile numbers. Twilio is the only SMS service provider that Form is integrated with, and provides paid SMS at a competitive price. Twilio’s SMSes cost 0.0395 USD per SMS. To find out more about the cost of each SMS, you may visit this link.
Step 2. Create an account at https://twilio.com, and set up payment to your agency. Set up the rest of your account according to the instructions below in the ‘Twilio account setup’ section.
Step 3 Email us at firstname.lastname@example.org but do not include any Twilio account details in your email. We will advise you on how to securely pass the following 4 items to us:
i. Account SID
ii. API Key SID
iii. API Key Secret
iv. Messaging Service SID
Twilio account setup
Upon logging in, you should be able to see your account SID on the dashboard when you arrived on Twilio’s console.
📌 Item 1: We will need your Account SID from this step.
Set up API Key
Click on Settings > API Keys on the left-side menu and select Create new API Key.
Create a new standard API key. You can rename the friendly name.
You will need to pass us your SID and secret. Please keep these safe. Remember to save the secret somewhere before you click on Done! Or else you will not be able to view your secret again and will have to recreate a new API key.
📌 Items 2 and 3: We will need your API Key SID and Secret from this step.
Buy a phone number
You need to purchase a phone number to start sending SMSes.
We recommend buying a US number ($1 a month) and masking the number with an alphanumeric sender ID. A Singapore phone number is $75 per month but a Singapore number is not required to send Singapore SMSes.
Click on the button with 3 dots on the left side menu and then click on Phone Numbers
You can change the country code to USA, and click on search to purchase a phone number
Do not release your number: Releasing a number means that you are returning the number you have purchased back to Twilio. This is irreversible. They will charge you for a new number when you purchase it again.
Optional: Alphanumeric Sender ID
Once you have bought a phone number, you can configure the Alphanumeric Sender ID to mask it with your agency info. This means SMS recipients will see the SMS as coming from the name (Alpha Sender ID) you specify instead of a phone number.
You can do this by navigating to Programmable SMS > Messaging Service > Select the name of the Messaging Service > Features > Add sender > Add Alpha Sender
Alternatively, you may wish to watch the video on Postman.gov.sg’s workplace group on adding an Alpha Sender ID.
Set up Messaging Service
Click on the button with the “chat message” icon on the left side menu and then click on Programmable Messaging > Messaging Services > Create new Messaging Service.
Once you click on the button, you can enter a name for your messaging service and click OK.
Click on Add Senders
Select Phone Number for Sender Type and click Continue
Your purchased number should appear here. Select the number and click Add Phone Numbers
Now, your phone number will be added to the messaging service. Go back to the messaging services landing page.
📌 Item 4: We will need your Messaging Service SID from this step.
I did not receive my OTP. Where is it?
The OTP is sent immediately, but might take a while to arrive in your government email if there is high traffic on the government network. OTPs expire in 15 minutes, after which you have to resend another one. After logging in, you will remain logged in for 24 hours. This means you need not have both Intranet and Internet devices at all times; you can log in to your Internet device before you leave your office, and for 24 hours be able to create forms from one Internet device.
My form is really long. Why can’t users save draft?
Prior to the launch of Storage mode, we did not enable draft-saving functionality because there was no good place to store draft form data. Our servers did not store data, and saving data on local machines might leak this out to unintended recipients if form is filled from a library computer. With the launch of Storage mode, we might consider re-enabling Save Draft. Stay tuned!
I am leaving the organisation or switching over to a new email. How do I transfer ownership/add collaborators for my forms?
You can transfer ownership on the top right hand corner of each form by clicking the round Add Collaborator button.
Note that you might not need to transfer ownership of your form. You may simply add your colleague as a collaborator. Collaborators have the same rights as form creators, except they cannot delete the form.
The previous form administrator has left the department without transferring their forms or adding collaborators. Their email address is no longer valid. How can we regain access to their forms?
Obtain internal approval and make a request to your IT Department to temporarily reinstate the email address of the previous form admin, so that you can log in to form.gov.sg using their email to transfer their forms. You can transfer ownership on the top right hand corner of each form by clicking the round Add Collaborator button.
To prevent such incidents from occurring, we strongly recommend that all IT departments add form ownership transfer in offboarding steps for staff leaving the organisation.
My forms are particularly sensitive and I do not want other public officers to see them on the Examples tab.
We no longer list forms on the Example tab since January 2021. That means if you have created any forms after this period, they will not be listed.
How do I restrict access to my form to selected users to submit?
The unguessable form link acts as a password. You can circulate the form link to only users that you intend to gather responses from. As long as you don’t add the form link to public channels such as on your agency’s Internet website, the form link will not be indexed by search engines. If the form link ends up widely circulated with non-authorised users submitting the form, you may then filter off such non-authorised submissions.
How can I split the form into multiple pages?
We don’t support multiple pages, because >70% of our users fill in forms from their phones, and are used to navigate through content by scrolling not tabbing through pages, such as when they scroll through their social media feeds. Hence we built the Header field to separate your form into sections that your user can scroll through.
What tech stack is Form built on?
Form is built on a MEAN stack (MongoDB, Express.js, AngularJS, Node.js). We will be migrating from AngularJS to React (MERN stack) in Feb 2021.
What is Form’s infrastructure? How secure is Form?
We have undergone rigorous penetration testing, vulnerability assessment and infrastructure review by both world renowned security testers and CSG. Our July 2020 pentest report by renowned security firm Cure53 found a solid security standing. We have also written a >74 page NIST security review documenting our security best practices.
Support for Internet Explorer
Support for internet explorer is no longer available for Forms. Please use alternatives like Chrome, Firefox and Edge.
How do I suggest changes to this user guide?
Our user guide is hosted by OpenDoc and is written in Markdown, which is a laymen-friendly language. The code for our user guide is open-sourced, and you may visit our Github repository, and send us a Pull Request if you have corrections or suggestions to the guide.