---
title: Forms
description: Build forms to collect input, analyze responses, and trigger automations.
breadcrumbs: Docs > Actions > Forms
---

# Forms

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ().
{% /alert %}

{% /callout %}

## Overview{% #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.

Some ways you can use forms:

- Scaffold services from predefined templates.
- Survey engineering feedback in an internal developer portal (IDP).
- Create service requests and [cases](https://docs.datadoghq.com/incident_response/case_management.md) for security, platform, or IT teams directly from employee form responses.

## Create a form{% #create-a-form %}

When creating a form, you can use a blueprint, import an existing form, or start from scratch. Blueprints are starter forms that cover common use cases. They come loaded with a sample description and questions to help familiarize yourself with form elements, and some blueprints include a pre-configured automation. Blueprints include Developer Experience Survey, IDP Feedback, Case Management Service Request, Report an Incident, Bug Report, On-Call Escalation, Post-Incident Review, and more.

To create a form:

1. On the [Forms](https://app.datadoghq.com/forms) page, click New Form.
1. Select a blueprint, import a form, or start with a blank form. Click Continue.
1. Optionally, name your form and give it a description. Click Continue.
1. To add a new component, click **Add Component**, or on the Fields side panel, click the plus **+** icon. See [Form components](https://docs.datadoghq.com/actions/forms/components.md) for the full list of component types and their options.
1. Click Save.

To preview or share your form:

1. Click View to display the form as it appears to respondents. Click Edit to return to the creator view.
1. Click Share to copy the form link or configure sharing options.

## Import a form{% #import-a-form %}

You can import an existing form into Datadog from a PDF or JSON file.

To import a form:

1. On the [Forms](https://app.datadoghq.com/forms) page, click New Form.
1. Click Import a Form.
1. Choose a source to import your form fields, then follow the prompts.

## Form settings{% #form-settings %}

From the [Forms](https://app.datadoghq.com/forms) page, click a form. In the Fields panel, click the gear 
{% icon name="icon-cog-2" /%}
 icon to access the following settings:

| Setting             | Description                                                                                                                                                                           |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Accepting Responses | Toggle to set the form as active or inactive. When inactive, the form does not accept new responses. You can also set an end date to automatically close the form on a specific date. |
| Anonymous Responses | When enabled, respondent emails are not stored.                                                                                                                                       |
| Single Responses    | When enabled, prevents the same person from submitting more than one response by tracking user identity. You can enable this setting together with Anonymous Responses.               |
| Manage Permissions  | Configure who can view the form and submit responses. See Manage access.                                                                                                              |
| Edit Theme          | Change the form's color theme.                                                                                                                                                        |
| Clone Form          | Create a copy of the form.                                                                                                                                                            |
| Export Form         | Download the form as a JSON file.                                                                                                                                                     |

For more information on managing responses, see [Form responses](https://docs.datadoghq.com/actions/forms/responses.md).

## Share a form{% #share-a-form %}

To configure sharing for a form:

1. From the [Forms](https://app.datadoghq.com/forms) page, click a form.
1. Click Share.

The following sharing options are available:

{% collapsible-section %}
#### Share within Datadog

Share the form with users in your Datadog organization. Enable the **Self-Service Action** toggle to surface the form in the [Self-Service Actions](https://docs.datadoghq.com/internal_developer_portal/self_service_actions.md) catalog, a central place where platform and infrastructure teams publish tools that the rest of the organization can discover and use without leaving Datadog.
{% /collapsible-section %}

{% collapsible-section %}
#### Share with external users

Share the form with users outside your Datadog organization. You can configure an access expiration date for each sharing option, and create multiple sharing configurations with different settings and expiration dates.

The following options are available:

- **Specific individuals**: Add recipients by individual email address. For example, `alice@example.com` and `bob@example.com`.

- **Company domain**: Share with anyone in a specific email domain. For example, `*@yourcompany.com`.

- **Shareable link**: Generate a link that anyone can use to access the form without a Datadog account.

{% /collapsible-section %}

To pause or remove external sharing, click Share, then click Edit and select Pause Sharing or Delete Sharing.

## Add a form to a dashboard{% #add-a-form-to-a-dashboard %}

To embed a form directly in a dashboard as a widget:

1. Navigate to a [dashboard](https://docs.datadoghq.com/dashboards.md).
1. Click **Add Widgets** to open the side panel.
1. Click the **Apps** tab.
1. Select **Form Widget**.
1. Select your form, then click Save.

## Add automation{% #add-automation %}

After creating a form, you can add an [action](https://app.datadoghq.com/actions/action-catalog/) or [workflow blueprint](https://app.datadoghq.com/workflow/blueprints) that triggers automatically when a form is submitted.

1. From the [Forms](https://app.datadoghq.com/forms) page, click a form.
1. At the top of the form, select Automation.
1. Choose an action or blueprint.
1. The action or blueprint opens in a workflow canvas, where you can [edit it](https://docs.datadoghq.com/actions/workflows/build.md#build-a-workflow-with-the-workflow-builder).
1. Click Create.

**Note**: Automations triggered by forms appear under [Workflow Automation](https://app.datadoghq.com/workflow).

## Manage access{% #manage-access %}

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

1. From the [Forms](https://app.datadoghq.com/forms) page, click a form.
1. In the Fields panel, click the gear 
   {% icon name="icon-cog-2" /%}
 icon.
1. To change who can see the form and submit answers, click Edit Form Permissions.
1. To change who can see the submitted responses, click Edit Response Permissions.

## Further reading{% #further-reading %}

- [Turn feedback into action across your engineering org with Datadog Forms](https://www.datadoghq.com/blog/datadog-forms)
- [Turn developer feedback into operational insight with Datadog Forms and Sheets](https://www.datadoghq.com/blog/datadog-forms-sheets-developer-feedback/)