> 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/diary-studies/create-a-diary-study.md).

# Create a diary study

Once you've created a Dscout project, you can create a new diary study. You can start from a blank study, duplicate an existing diary study, or begin from one of Dscout's diary templates.

### Create a new diary study

If you want to build a diary study from scratch—or if you're building one for the first time—you'll do so from within your Dscout project.

**To create a new diary study:**

{% stepper %}
{% step %}
Click **Create study** in the top-right corner of your project. The **Create something new** modal is displayed.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FGrrU7QKq0Qg7Kx7pMc6I%2FDiary_create.jpg?alt=media&amp;token=bce514db-d3f6-437d-a548-6019363f67d9" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Under **Diary study**, click **Create**.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FS6ytY9dBmP8ahaelAfZV%2FDiary_create%20(2).jpg?alt=media&amp;token=bd0e80ac-e507-4685-9689-f497f8f51059" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Select **New blank study**.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FE3AUejM49i50UDLJBbvu%2FDiary_create%20(4).jpg?alt=media&amp;token=4de6e9c2-d484-477c-b63e-21a08c3929e4" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

Now, your new study opens in the builder. A diary study has three tabs: you'll build the study and invite participants on **Setup**, track participation and issue payments on **Manage**, and review the data participants submit on **Entries**.

### Start from a diary study template

If you'd rather not start from a blank study, Dscout offers diary templates that come with activities and questions already built. You can use one as-is or adjust it to fit your research.

**To create a diary study from a template:**

{% stepper %}
{% step %}
Click **Create study** in the top-right corner of your project. The **Create something new** modal is displayed.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FGrrU7QKq0Qg7Kx7pMc6I%2FDiary_create.jpg?alt=media&amp;token=bce514db-d3f6-437d-a548-6019363f67d9" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Under **Diary study**, click **Create**.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FS6ytY9dBmP8ahaelAfZV%2FDiary_create%20(2).jpg?alt=media&amp;token=bd0e80ac-e507-4685-9689-f497f8f51059" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Hover over the template you want to use, then click **Customize**. The template's details open in a modal.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2F1X9Xua25da3MitSU1Tnc%2FDiary_create%20(5).jpg?alt=media&amp;token=6373bca1-8f7a-4e9f-aff5-d1a1226dd1fb" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Customize the **variables**, **number of moments**, and **prompts**. Then, click **Create study**.

{% hint style="success" %}
**Tip:** For more information on customizing diary study templates, see [Diary study templates](/diary-studies/what-are-diary-studies-in-dscout/diary-templates-overview.md).
{% endhint %}
{% endstep %}
{% endstepper %}

Now, your new study opens in the builder, including the template's original questions. You can adjust these questions further, add your own, or delete any you don't wish to use.

### Duplicate an existing diary study

If you have a diary study you want to use as a starting point, you can duplicate it. Duplicating copies the study's activities and questions, so it's the fastest way to run a second wave of the same research.

**To duplicate a diary study:**

{% stepper %}
{% step %}
Click **Create study** in the top-right corner of your project. The **Create something new** modal is displayed.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FGrrU7QKq0Qg7Kx7pMc6I%2FDiary_create.jpg?alt=media&amp;token=bce514db-d3f6-437d-a548-6019363f67d9" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Under **Diary study**, click **Create**.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FS6ytY9dBmP8ahaelAfZV%2FDiary_create%20(2).jpg?alt=media&amp;token=bd0e80ac-e507-4685-9689-f497f8f51059" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Click **Duplicate an existing study**. Other diary studies across your projects are displayed.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FchywzMbmxP4q5uIQzEJ9%2FDiary_create%20(1).jpg?alt=media&amp;token=ecbb7447-5222-4269-abb3-def23ac81efb" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Find the study you want to duplicate, then click **Copy**.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FEtMlQk50FflVnLeW5QLx%2FDiary_create%20(3).jpg?alt=media&amp;token=70b5bf7f-16bf-4709-b84f-1aa7a20cd25b" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

Now, your study has been duplicated and opens in the builder. You can rename it in the top-left corner, adjust its activities and questions on the **Setup** tab, or launch it to start gathering entries.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.dscout.com/diary-studies/create-a-diary-study.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
