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

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# 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). ({% placeholder "user-datadog-site-name" /%}).
{% /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 %}

On the [Forms](https://app.datadoghq.com/forms) page, click New Form, then select a creation method:

{% tab title="Create with AI" %}

1. Select Create with AI and click Continue. The form editor opens with [Bits Chat](https://docs.datadoghq.com/bits_ai/bits_chat.md).
1. Describe the form you want to build in the Bits Chat panel.
1. Click Publish or Publish Changes to make the form available to respondents.

You can also ask Bits Chat to create a form from anywhere in Datadog, not only from the Forms editor. See Create and manage forms with MCP.
{% /tab %}

{% tab title="Blank form" %}

1. Select Start with a blank form and click Continue.
1. Name your form and optionally add a description and theme color. Click Continue.
1. To add a component, click Add Component, or in the Fields 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 Publish or Publish Changes to make the form available to respondents.

{% /tab %}

{% tab title="Blueprint" %}
Blueprints are starter forms for common use cases, pre-loaded with sample questions. Some blueprints include a pre-configured automation. Available blueprints include Developer Experience Survey, IDP Feedback, Case Management Service Request, Report an Incident, Bug Report, On-Call Escalation, Post-Incident Review, and more.

1. Select Create from blueprint and browse the available templates.
1. Select a blueprint and click Continue.
1. Name your form and optionally add a description and theme color. Click Continue.
1. To further customize your form, see [Form components](https://docs.datadoghq.com/actions/forms/components.md).
1. Click Publish or Publish Changes to make the form available to respondents.

{% /tab %}

{% tab title="Import" %}
You can import an existing form from a PDF or JSON file.

1. Select Import a form. An import dialog opens.
1. Choose a source and follow the prompts.
1. Name your form and optionally add a description and theme color. Click Continue.
1. To further customize your form, see [Form components](https://docs.datadoghq.com/actions/forms/components.md).
1. Click Publish or Publish Changes to make the form available to respondents.

{% /tab %}

To preview or share your form:

1. Click Preview to view the form as it appears to respondents.
1. Click Share to copy the form link or configure sharing options.

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

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

| Setting             | Description                                                                                                                                                                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Accepting Responses | 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. Only available for published forms. |
| Anonymous Responses | When enabled, respondent emails are not stored.                                                                                                                                                                 |
| Manage Permissions  | Configure who can view and edit the form, and who can view submitted responses. See Manage access.                                                                                                              |
| Clone Form          | Create a copy of the form.                                                                                                                                                                                      |
| Import Form         | Import fields from a PDF or JSON file into the current form.                                                                                                                                                    |
| Export Form (JSON)  | 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.

Under Add to Dashboard, use the dropdown to add the form to an existing dashboard or create a dashboard.

Enable the Add to IDP Self-Service Actions toggle to surface the form in the [Self-Service Actions](https://docs.datadoghq.com/internal_developer_portal/self_service_actions.md) catalog. This is a central place where platform and infrastructure teams publish tools for the rest of the organization to discover and use.
{% /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 add a form to a dashboard from the form editor:

1. From the [Forms](https://app.datadoghq.com/forms) page, click a form to open it in the editor.
1. Click the Share dropdown and select Share within Datadog .
1. Under Add to Dashboard, select an existing dashboard or create one, then click Add.

You can also add a form to a dashboard directly from the dashboard:

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).

## Create and manage forms with MCP{% #create-and-manage-forms-with-mcp %}

Connect an external AI agent to the [Datadog MCP Server](https://docs.datadoghq.com/mcp_server.md) to create, update, publish, and read forms and their responses. Enable the `forms` toolset (or `all`) when you [connect to the MCP Server](https://docs.datadoghq.com/mcp_server/setup.md#toolsets). You can also ask [Bits Chat](https://docs.datadoghq.com/bits_ai/bits_chat.md) to build a form from anywhere in Datadog. See [Forms](https://docs.datadoghq.com/mcp_server/tools.md#forms) in the Datadog MCP Server tools reference for the full list of available tools.

## 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 to open it in the editor.
1. In the editor header, click the gear 
   {% icon name="icon-cog-2" /%}
 icon.
1. Click Manage Permissions. A modal opens with two sections:
   - **Form Access**: Controls who can view and edit the form.
   - **Response Access**: Controls who can view submitted responses. This section is only available after the form receives its first submission.

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

Additional helpful documentation, links, and articles:

- [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/)