Overview

Datadog Forms allow you to collect input, analyze responses, and trigger automations in Datadog. Forms and their responses can be shared across your organization, allowing you to collect and analyze data with your team.

Examples

Here are some ways you can use forms:

• Scaffold services from predefined templates.
• Collect engineering feedback in an internal developer portal (IDP).
• Create service requests for security, platform, or IT teams, directly from employee form responses.

Create a form

When creating a form, you can use a template or start from scratch. Templates are starter forms that cover common use cases. They come loaded with a sample description and questions to help familiarize yourself with form elements. Templates also showcase best practices for setting up form elements.

To create a form:

1. On the Forms page, click New Form.
2. Select a template or Start with a blank form, then click Continue.
3. Optionally, name your form and give it a description. Click Continue.
4. New forms are auto-populated with placeholder components. To edit the form, click a placeholder component, or click the icon to add a new component. Component types include short answer, paragraph, dropdown, checkboxes, ratings, and toggle. The following table lists the elements available inside components:

   Element	Description	Component Availability
   Required	Determines whether the question requires an answer from the respondent; required questions are marked with a red asterisk on forms.	All components
   Field name	The name of the field. Appears in the JSON version in Responses. Not visible to respondents.	All components
   Placeholder	The text the respondent sees before entering any text.	Short answer, paragraph, and dropdown
   Default value	The default item or text that is selected before the respondent makes a selection.	All components except ratings and checkboxes
   Data	The available options that respondents can choose from.	Dropdown and checkboxes
   Questions	The questions respondents are asked when rating their experience.	Ratings

5. Click Save to save your changes.

To preview, share, and debug your form:

1. Click View to display the form as it appears to respondents. Click Edit to return to the creator view.
2. Click Share to copy the form link.
3. In the Debug section, you can:
   • Click Form to show a mini-preview of your form.
   • Click Data Definition to show the JSON version of the components’ definition.
   • Click UI Definition to show the JSON version of the form’s UI.

Add automation

After creating a form, you can add an action or workflow blueprint that triggers automatically when a form is submitted.

1. From the Forms page, click a form.
2. Click Automation.
3. Choose an action or blueprint.
4. The action or blueprint opens in a workflow canvas, where you can edit it.
5. Click Create.

Note: Because forms are powered by workflows, automations triggered by forms appear under Workflow Automation. Additionally, there is no charge associated with workflow executions that are triggered by a form.

Manage access

By default, only the creator of a form can access it. To change the permissions on a form:

1. From the Forms page, click a form.
2. Click the gear icon.
3. To change who can see the form and submit answers, click Edit Form Permissions.
4. To change who can see the submitted responses, click Edit Response Permissions.

Analyze your data

View in forms

To view form responses in a table format:

1. From the Forms page, click a form.
2. Click Responses.
3. Click the edit icon on a response to view the JSON version.

Note: Datadog stores responses in a datastore, which is listed in Datastores.

View in a dashboard

To visualize form responses in a dashboard:

1. Navigate to the DDSQL Editor.
2. In the Data tab, click Actions Datastores.
3. Select the datastore associated with your form, then click Insert into editor.
4. Optionally, click the query’s title to rename it.
5. Click Save.
6. Create a dashboard, then add a widget. For forms, all widgets except Timeseries are supported.
7. When defining the metric, select DDSQL Editor and the datastore query you created earlier.
8. Finish configuring your widget, then click Save.