# Work settings

{% hint style="info" %}
To access this section:

1. Find your Team in the \[**Team spaces**] section of the Navigator.
2. Click the \[**Team settings**] icon next to your Team’s name.
3. Open the \[**Work**] section.
   {% endhint %}

## Configuring Work Item experience

The \[**Work**] section in the \[**Team settings**] module helps you configure various aspects of [Work Items](/hc/product-guide/core-concepts-and-objects/delivery-objects/work-item.md). You can enable and define custom statuses for your work or allow [Sprints](#sprints)–defined and repeating cycles in which a Timebook Team tackles sets of Work Items. You can also turn on automation features to make your Timebook experience smoother.

There are several tabs in the \[**Work**] section, each dedicated to a different aspect of work management at the [Team ](broken://pages/QbXiEeUhBL6iBL35OuIB)level. See the sections below for specific information on settings available in particular tabs.

<div align="left"><figure><img src="/files/VbXdHTrk9w2SQhntS89y" alt="" width="563"><figcaption><p>Tabs available in the [<strong>Work</strong>] section of [<strong>Team settings</strong>].</p></figcaption></figure></div>

{% hint style="warning" %}
Only the Team Owner and Admins can access the options in the \[**Work**] section.
{% endhint %}

### Statuses tab

This tab helps you manage your Work Items’ \[**Status**] field. You can create custom statuses for specific stages of Work Item progression.

Unlike predefined statuses, such as “To do,” “In progress,” and “Done,” custom statuses are user-defined, and you can align them more closely with your project’s unique workflow.

This is how you can manage Work Item statuses in this tab:

{% embed url="<https://go.screenpal.com/watch/cTnX6RnhbHj>" %}
Create and manage work statuses in the dedicated section of Team settings.
{% endembed %}

* Click anywhere on the status tile to change its name.
* You can have multiple statuses for each progress stage, for example, two different “To do” statuses, four “In progress” statuses, and two “Done” statuses. But you must have at least one status in each of these stages.
* You can create as many as eight “In progress” statuses. They should represent different stages in your workflow, like “Design,” “Review,” or “Testing.” You can also rename any of them.
* Optionally, you can use the “Draft” and “Canceled” stages and have multiple statuses there, too.
* You can drag and drop statuses within one stage to change their order. You can also use the \[**Trash bin**] icon on the right side of a status tile to remove it from the list.

### Sprints tab

Use this tab to enable Sprints in your Team. A Sprint is a period during which a Timebook Team handles a set of Work Items. This ensures a continuous flow of work and enables you to move unfinished Work Items from one Sprint to another. For more information, see [Sprint](/hc/product-guide/core-concepts-and-objects/delivery-objects/sprint.md)

With this feature enabled, your Team will receive an additional module where you can manage all the Sprints and their Work Items. Also, Timebook will automatically generate future Sprints for this Team.

To turn on Sprints in your Team:

{% embed url="<https://go.screenpal.com/watch/cTnXXfnhbHR>" %}
Enable and manage Sprints in the dedicated section of Team settings.
{% endembed %}

> 1. In the Navigator, select a Team and click the \[**Team settings**] icon next to it.
> 2. Select the \[**Work**] section and then the \[**Sprints**] tab.
> 3. Click \[**Turn on Sprints**]. Your Team now has an additional module for Sprint management.
> 4. Use the settings explained below to customize Sprints for your Team.

You can use the following settings to adjust Sprints to your work style:

<table><thead><tr><th width="264">Option</th><th>How to use it</th></tr></thead><tbody><tr><td><strong>Sprint starts on</strong></td><td>Use this setting to select the day of the week on which the current and upcoming Sprints will begin.</td></tr><tr><td><strong>Sprint cadence</strong></td><td><p>Use this setting to define the repetition cycle for your Sprints (in weeks).</p><p>Timebook will mark the current Sprint as completed after the selected period and automatically create a new one for you.</p></td></tr><tr><td><strong>Upcoming Sprints to create</strong></td><td>Use this setting to decide the number of upcoming Sprints we will automatically create for your Team.</td></tr></tbody></table>

### Automation tab

Use this tab to enable automated processes in your Team. This feature reduces manual effort and allows you to focus more on the actual work.

The \[**Automation**] tab helps you manage the integration between your Work Items and Git code repositories. In short, the statuses of your Work Items in Timebook can change automatically after certain events in Git. And this tab is where you can define these relationships.

{% hint style="warning" %}
To use the Git automation features, the integration between Git and Timebook must first be configured for your Workplace.

For more information, see [https://github.com/TimebookDev/gitbook-prod/blob/master/settings/team-settings/broken-reference/README.md](https://github.com/TimebookDev/gitbook-prod/blob/master/settings/team-settings/broken-reference/README.md "mention")
{% endhint %}

To turn on Work Item automation in your Team:

{% embed url="<https://go.screenpal.com/watch/cTnXXjnhbJg>" %}
Enable and manage work automation in the dedicated section of Team settings.
{% endembed %}

> 1. In the Navigator, select a Team and click the \[**Team settings**] icon next to it.
> 2. Select the \[**Work**] section and then the \[**Automation**] tab.
> 3. Click \[**Turn on automation**]. You can now configure the automation of Work Items in this Team.

Once you enable automation, you can define how Timebook Work Items should react to changes in Git. Use the dropdowns to select different statuses for different scenarios. For example, you can decide that a Work Item should change its status to “Done” whenever a related Git pull request is merged.

***

### Jira integration tab

Use this tab to configure the synchronization between your Team’s [Work Items](/hc/product-guide/core-concepts-and-objects/delivery-objects/work-item.md) and a linked Jira project. This integration provides the following benefits:

* **Real-time synchronization:** Items created or updated in either Timebook or Jira automatically stay up to date on both platforms.
* **Property consistency:** Essential properties—including Title, Description, Status, Priority, and Item Type—reflect any changes instantly.
* **Easy navigation:** Synced items in Timebook feature a Jira project banner, allowing quick navigation to the related Jira issue or easy unlinking from the integration.
* **Data safety:** Deleting an item in either platform will stop synchronization, but the corresponding item won’t be deleted, ensuring important data remains intact.

{% hint style="warning" %}
Before you can configure Jira integration at the Team level, a Workplace Admin must first enable it for your entire Timebook Workplace.

For more information, see [https://github.com/TimebookDev/gitbook-prod/blob/master/settings/team-settings/broken-reference/README.md](https://github.com/TimebookDev/gitbook-prod/blob/master/settings/team-settings/broken-reference/README.md "mention")
{% endhint %}

Configuring Jira integration for your Team involves two steps:

* **Selecting a Jira project** to synchronize your Work Items with.
* **Mapping Timebook Work Item types** to corresponding Jira issue types.

<div align="left"><figure><img src="/files/v24kMEiSOyD52dXiexYf" alt=""><figcaption><p>Synchronize your Team’s Work Items with a Jira project and map item types between the two platforms.</p></figcaption></figure></div>

{% hint style="info" %}
To access this section:

1. Find your Team in the \[**Team spaces**] section of the Navigator.
2. Click the \[**Team settings**] icon next to your Team’s name.
3. Open the \[**Work**] section.
4. Open the \[**Jira integration**] tab.
   {% endhint %}

<table><thead><tr><th width="197.86773681640625">Integration stage</th><th>Details</th></tr></thead><tbody><tr><td><strong>Select a Jira project to sync with your Team</strong></td><td><p>Use the dropdown menu to select a Jira project. You can choose from all projects available in the Jira workspace integrated with your Timebook Workplace.</p><p><br>However, each Jira project can only be connected to one Timebook Team at a time. Projects already linked to another Team in your Workplace will appear greyed out in the dropdown, and you won’t be able to select them.</p></td></tr><tr><td><strong>Map item types between the platforms</strong></td><td><p>Use the dropdown menus next to each Timebook Work Item type to map them to corresponding Jira issue types. If Timebook detects exact matches, it will automatically map them for you.</p><p>All Timebook Work Item types must be mapped. To ensure this, you can select multiple Jira issue types from the dropdown or map the same Jira issue type to more than one Timebook Work Item type.</p></td></tr></tbody></table>

Once Jira integration is configured for your Team, you’ll notice the following:

* **Linked banner on Work Items:** Each Work Item created in this Team will display a banner at the top, showing its linked counterpart in Jira. The banner includes a link to open the Jira item directly, along with its current status.
* **Two-way syncing:** Creating an item in the synced Jira project will automatically create a corresponding Work Item in your Team.

<figure><img src="/files/otUENOUEak5YkSN9ulQ8" alt=""><figcaption><p>This banner shows your Work Item is synced with Jira—it displays the Jira status and lets you jump directly to the Jira issue.</p></figcaption></figure>

***

## Related articles

[Team settings](/hc/product-guide/team-settings.md)

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

[Sprint](/hc/product-guide/core-concepts-and-objects/delivery-objects/sprint.md)

[https://github.com/TimebookDev/gitbook-prod/blob/master/settings/team-settings/broken-reference/README.md](https://github.com/TimebookDev/gitbook-prod/blob/master/settings/team-settings/broken-reference/README.md "mention")


---

# 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/team-settings/work-settings.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.