# Importing data into Timebook

> **In short:**
>
> This article guides you through the process of importing your existing data into Timebook using .csv files. It covers the steps to upload your data, map .csv columns to Timebook properties, and handle any issues that may arise during the import.

## Bring your existing data into Timebook

In Timebook, you can create multiple types of items, and many of them support .csv imports for easier data migration. If you already have data stored in a .csv file, you can quickly import it into Timebook instead of adding items manually.

The following Timebook item types support .csv imports:

* [Goal](/hc/product-guide/strategy-objects/goal.md)
* [Interview](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/interview.md)
* [Survey](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/product.md)
* [Insight](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/insight.md)
* [Opportunity](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/opportunity.md)
* [Work Item](/hc/product-guide/core-concepts-and-objects/delivery-objects/work-item.md)
* [Feedback](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/ticket.md)

## Importing data using .csv files

Importing data into Timebook using a .csv file is a straightforward process that ensures your existing work is properly structured and integrated. This step-by-step guide will walk you through selecting your file, mapping your data to Timebook properties, and resolving any potential issues.

{% stepper %}
{% step %}
**Two starting points**

You can begin the import process from different locations, depending on the state of your module:

* If your module already contains items, use the \[**Import from a .csv file**] button in the top-right corner of the working area.
* If your module is empty, you’ll find a dropdown below the \[**Create your first...**] button, allowing you to start the import.

<div align="left"><figure><img src="/files/Gy2DmFXdq8MOiESdTn8o" alt=""><figcaption><p>There are two different starting points for import, depenind on the state of the module.</p></figcaption></figure></div>
{% endstep %}

{% step %}
**Upload the .csv file and select a Team**

1. Click the \[**Upload**] button to choose a .csv file from your device containing the items you want to import into Timebook.
2. Use the \[**Assign to a Team**] dropdown to select the Timebook [Team](broken://pages/QbXiEeUhBL6iBL35OuIB) that will receive the imported items.
3. Click \[**Next**] to continue.

<figure><img src="/files/FH9orEx1kSrYz4Ts0DOj" alt=""><figcaption><p>Upload a .csv file from your device and choose the Timebook Team that will receive the imported items.</p></figcaption></figure>
{% endstep %}

{% step %}
**Map columns to Timebook properties**

{% hint style="info" %}
Timebook will automatically match its properties—such as Title, Description, and Priority—to columns in your .csv file when a direct match is found. You'll need to map the rest manually.
{% endhint %}

1. Select a .csv column for each Timebook property. The data from this column will be used as the property’s value in items imported into Timebook. Leave fields unmapped if you don’t wish to import them.
2. Click \[**Next**] to continue.

<figure><img src="/files/im8clKrlPwT7rzhbTcLf" alt=""><figcaption><p>Map the contents of your .csv file to Timebook properties.</p></figcaption></figure>
{% endstep %}

{% step %}
**Importing items and reviewing the final report**

Timebook will import items based on your mapping configuration. You will see one of the following outcomes:

* All items were successfully imported into Timebook.
* Some items require attention. Certain properties couldn’t be mapped correctly. You can review the affected items and see which fields couldn’t be imported.

<div align="left"><figure><img src="/files/fmzhBVJofSGqtiWUlCqu" alt=""><figcaption><p>The import report highlights items that need your attention, showing which fields couldn’t be mapped.</p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

Your import is now finished, and the new items—along with their mapped properties—have been added to the module. You can now review and manage them just like any other Timebook items.

***

## Related articles

[Goal](/hc/product-guide/strategy-objects/goal.md)

[Interview](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/interview.md)

[Insight](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/insight.md)

[Opportunity](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/opportunity.md)

[Work Item](/hc/product-guide/core-concepts-and-objects/delivery-objects/work-item.md)

[Feedback](/hc/product-guide/core-concepts-and-objects/research-and-planning-objects/ticket.md)


---

# Agent Instructions: 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:

```
GET https://help.timebook.ai/hc/product-guide/importing-data-into-timebook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.