> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Pass values to a data model with source parameters

> Add a control element to a data model, then target it as a source parameter from a workbook control to filter the data model based on user input.

A source parameter passes a value from a control element to a control element in a data model, filtering the data model based on user input.

Use a source parameter when you want users to filter the data model used as the source for the workbook, instead of filtering specific workbook elements. For example, a user can select a date range in a workbook control to filter every element sourced from an underlying data model, rather than filtering only the elements on the current workbook page.

To set up a source parameter in Sigma, you must make updates in two places:

* Add a control element in the data model that targets the relevant elements to filter.
* Add a control element in the workbook to store the user input and target the data model control.

## Requirements

* You must be assigned an [account type](/docs/account-type-and-license-overview) with the **Create, edit, and publish data models** and at least **Full explore** permissions enabled.
* You must be the document owner or be granted **Can edit** [document permission](/docs/folder-and-document-permissions) for the data model and at least **Can explore** for the workbook.

## Add and target a control element in a data model

Before you can pass a value to a data model, it must have a control element that targets one or more of the data model's data elements.

1. Open the data model for editing.
2. Add a control element. See [Add a control element](/docs/create-and-manage-a-control-element#add-a-control-element).
3. Add one or more targets to the control so that it filters data elements in the data model when a value is selected. See [Specify the target of the control](/docs/create-and-manage-a-control-element#specify-the-target-of-the-control).
4. In the editor panel, in the **Settings** tab, note the **Control ID** for the control, or update it to a descriptive value. You select this control ID from the workbook in the next section. See [About control IDs](/docs/intro-to-control-elements#about-control-ids).
5. To make the control and its targets available to workbooks that use the data model as a source, publish the data model.

## Target the data model control from a workbook

After the data model has a configured control element, add the data model as a data source in a workbook, then target the data model's control from a workbook control element.

1. Open a workbook for editing or customizing.
2. If the data model isn't already used in the workbook, add it as a data source. See [Create a data element](/docs/create-a-data-element).
3. Select a control element, or [add a new one](/docs/create-and-manage-a-control-element#add-a-control-element).
4. In the **Properties** tab of the editor panel, select the **Targets** tab.
5. Select **Add source parameter**, then choose the data model with the control that you want to target.

   ![Target tab of a text control with add source parameter selected and the Events data model chosen. The available control IDs are listed in a dropdown menu.](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/sigma.docs.buildwithfern.com/a50c16bbfcc2c7769521083ccf75252c1976de462ac40b2f426c1b477122a707/assets/docs-images/a0a02630e4159069e038508de8da2971312d4c40bc0d1623f165239990eeeb84-control-add-a-param.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260910%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260910T212704Z&X-Amz-Expires=604800&X-Amz-Signature=f8e40b95811e91a3cd070ea7aa55c1e7b4cb2c3f10ef25399279274c55e0fb86&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)
6. In the dropdown list, select the control ID that you noted or set in the data model. Only control elements with a matching, supported data type are available to select.

   ![The Properties panel for a Traffic text input control with the EVENTS data model added as a source parameter and the dm-text-input control ID selected.](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/sigma.docs.buildwithfern.com/2aaa43cc1dbce41c8a231c7c365f81cbc18c5bebbe7c86c0e7e292d4998adae8/assets/docs-images/6f918f0746a0044e25197ab1b44fb6ede23c1e1c07f4f650ffa4d7793e94af28-control-add-param.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260910%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260910T212704Z&X-Amz-Expires=604800&X-Amz-Signature=2696c2a1b0fa6ed584a38781f17c8d3b2e074939f4b3ea52bd8e9030bc4507b5&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)
7. To make the changes visible to those without edit access, publish the workbook.

If the control ID you expect isn't available to select, confirm that the control element's data type in the data model matches the output type of the workbook control, and that the data model's control has at least one target configured. A control in the data model with no targets is not available to select as a source parameter.

## Related resources

* [Create and manage a control element](/docs/create-and-manage-a-control-element)
* [Intro to control elements](/docs/intro-to-control-elements)
* [Create and manage data models](/docs/create-and-manage-data-models)