The visibility of survey responses in Linear’s Reporting section is enabled in the Typeform integration by using the hidden field feature along with the primary_answer and primary_rating attributes. If you have enabled the Typeform integration by following the instructions on this page and selected Create Surveys Automatically, the necessary linking to Linear is automatically included. This ensures that responses (such as feedback) are visible in Linear’s reporting.
If you prefer, you can also create completely custom surveys in Typeform. This guide explains how to add a hidden field and a primary_rating attribute to your own Typeform surveys so that responses will also flow into Linear’s reports.
Create a new survey
You can create a new survey by selecting Create a new form.
Adding a hidden field
You can add a hidden field to any Typeform survey. By adding a hidden field, you enable the survey responses to appear directly in the Linear interface. Below are screenshots showing each step:
Open the survey you created and click the "+" button found under Workflow (below the “Pull data in” section).
Click Add new parameter, enter sent_survey_id into the field, and click Save.
And that’s it — your survey responses can now also be viewed in Reporting!
Displaying ratings and feedback in Linear and in reports
If your survey also asks for a numerical value (for example an NPS question), you need to add a primary_rating in Typeform for that specific question. This ensures that the numeric value is visible in Linear and included in reporting. The screenshots below show how to add a primary_rating to a question.
- Open the survey to which you want to add a primary_rating and open its settings.
Note: The survey must be “Published” first (see screenshot above). - In Form settings, select Block References and add the text primary_rating to the question that asks for a numerical score, then click Save:
If you wish, you can also add a primary_answer value to any question. This allows the response to appear in Linear’s reporting as well.
Note: If the collected feedback is intended to be used in marketing, such as on the agency’s website, we recommend adding a question in your Typeform survey asking for permission to use the feedback in marketing. In the question’s settings, enter permission_to_use_in_marketing in the Typeform Block References field to ensure the information is also stored in Linear.