> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/recruit-participants/dscout-scout-panel/targeting-attributes/custom-targeting-attributes.md).

# Custom targeting attributes

{% hint style="info" %}
Custom attributes are a **paid add-on**. Contact your Dscout Account team for more information.
{% endhint %}

Custom targeting attributes are one of three attribute types offered by Dscout to help you recruit participants. These attributes leverage the wide breadth of behavioral data collected for Scouts who have joined Dscout XT, but they’re tailor-made to fit your organization’s unique needs.

## Custom attribute categories

Depending on your recruitment need, you’ll work with your Dscout Account team to create your custom attributes. However, they’ll always fall into one of these four categories:

* **Journey:** Identifies participants who move between two specific domains or URLs.
* **Frequency:** Identifies participants based on how often they engage with a specific domain or URL.
* **Engagement duration:** Identifies participants based on how much time they spend on a specific domain or URL.
* **Multi-condition:** Identifies participants based on a combination of the previous three categories.

For example, if you want to target participants who have visited your company’s website and ChatGPT within 60 seconds of each other, you can do that using a custom targeting attribute.

## Add custom attributes to a screener or study

You can combine up to 10 custom targeting attributes in a single screener or study using OR conditions to ensure you reach just the right audience. You’ll add these attributes on the **Screener** tab (or the **Intercept** tab of intercept studies).

{% hint style="info" %}
**Note:** Before you can add custom attributes to a study, they must first be created for your organization and added to your Dscout account. For more information, contact your Dscout Account team.
{% endhint %}

{% stepper %}
{% step %}
Navigate to the **Screener/Intercept** tab of your screener or study.
{% endstep %}

{% step %}
Select **Behavioral attributes** in the left sidebar.

![](/files/790a1f3fcea79e69f1cbe65bd7aacd32ddfc79b6)
{% endstep %}

{% step %}
Select **Custom attributes** in the right sidebar. The custom attributes block is added to the builder.

![](/files/65c501b109e8998e8d52fed5e42edba56e4f6900)
{% endstep %}

{% step %}
Select an **Attribute**. This drop-down displays all of your organization’s custom attributes.
{% endstep %}

{% step %}
Select a **Timeframe** in which you want participants to meet the selected attribute’s requirements.

{% hint style="success" %}
**Tip:** Once you’ve added one attribute, click **+ Add attribute (OR condition)** to add more. You can combine up to 10 custom attributes.
{% endhint %}

![](/files/bdddbdcc4f7d00fedac47fdf6cee5861d977ac03)
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, the selected attributes are added to your study. When you launch your study, only Scouts who meet your set criteria will be able to apply for your study in the Dscout app. Those who don’t meet your criteria won’t see the opportunity at all.

## Create custom attributes

Custom attributes are created in collaboration with your Dscout Account team to ensure they meet your specific needs. If you want to explore your options with custom attributes, contact your Dscout Account team.

For more information about other targeting attributes available in Dscout, see [Targeting attributes](/recruit-participants/dscout-scout-panel/targeting-attributes.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.dscout.com/recruit-participants/dscout-scout-panel/targeting-attributes/custom-targeting-attributes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.