A project is a standing chat in the Viktor app for one ongoing piece of work, such as hiring or a weekly marketing review. You say what the project should get done and choose who can open it. Viktor works on it from there and keeps a board of where each task stands. Use a project when the work runs for days or weeks. Use a normal chat for a one-off question.

Some workspaces call projects missions or goals. The steps are the same.

## Start a project

1. In the Viktor app, click **New project** in the sidebar.
2. Give it a name if you like. The name is optional.
3. Under **Who can open it?**, pick **Team** (everyone in the workspace), **Only me** or **Pick people** (you and the teammates or groups you add). **Team** is selected when the page opens.
4. Under **What should this project get done?**, say the outcome and what done looks like. You can attach files.
5. Click **Create**.

The project opens with your goal as its first message, and it shows up in your sidebar. On a phone, New project opens as a short dialog with no name field. Say what the project should get done and tap **Next**, then pick who can open it and tap **Start project**.

## Join and leave team projects

Projects shared with **Team** are listed under **Team projects**.

1. Click **Browse projects** in the sidebar, or open [Team projects](https://app.viktor.com/projects/browse).
2. Search or sort the list. Click **Preview** to look inside a project before you join.
3. Click **Join**. The project moves into your sidebar.

To leave a project, choose **Leave project** from its menu in the sidebar, then click **Leave**. A team project leaves your sidebar, and you can join it again from Team projects. A project shared with picked people stays closed to you until someone in it adds you back.

## Share a project or hand it over

Open the project's details from its row's menu or its header.

- **Access** shows who can open it. Only the project's owner changes who can open it. In a project shared with picked people, any member can add more teammates or groups.
- **Copy link** copies a link to the project to send to teammates.

To give the project to someone else:

1. In the project's details, open the **More actions** menu at the top and choose **Hand over…**. It shows once the project is shared, so share an **Only me** project under **Access** first.
2. Pick a person and click **Send offer**.
3. They see an offer card with **Accept** and **Decline**. Nothing moves until they accept.

Until then, the offer shows under the project's name with **Take back**. The owner must hand a project over before leaving it.

## Track the work

Each project has a board, pinned beside the chat as the **Status** tab. Viktor keeps it up to date.

- The **Tasks** section lists each task under **Needs you**, **In progress**, **Next**, **Done** or **Dropped**. Switch between **List** and **Board** at the top. Your choice is kept.
- Move a task with its status icon's menu, or drag its card on the Board. A move that asks Viktor to act shows **Undo** for a few seconds, then reaches him.
- A **Needs you** task shows Viktor's question with its answer buttons, so you can answer it on the board.

The side pane's **Contents** lists what the project holds: its running agents, its scheduled tasks, documents, images and links. While a task runs, hover the project's icon in the sidebar and click the arrow to see its running tasks.

To keep something at hand, right-click a row in Contents (or long press on a phone) and choose **Pin to top**. Pins sit in a Pinned section on top and everyone in the chat sees them. The project's owner can also choose **Pin to header** on a file to keep it as a tab beside the chat.

## Sub-projects and the hub

Split big work into sub-projects. Hover a project in the sidebar and click **+** (**Create sub-project**). The new sub-project shows **Under** and the parent's name. Sub-projects go one level deep: a sub-project cannot hold its own sub-projects.

Once Viktor hands back the project's first piece of work, he may offer a Hub Space: a page beside the chat that shows where the project stands, what's next and what's waiting on you. Click **Create the Hub Space** or **No thanks**. You can also ask him for one at any time. When a project has a hub, it opens beside the chat and the Status board stays as the second tab. See [Spaces](/docs/spaces).

## Limits by plan and permission

- **Plan:** projects work the same on every plan.
- **Owner:** only the owner changes who can open a project, hands it over or deletes it. Members of a shared project see its header pins but cannot change them.
- **Pins:** up to 50 pins in Contents per chat, and up to 3 files pinned to a project's header.
- **EU data residency:** on workspaces on EU data residency, the board's task list and Pin to header are not available. Pin to top still works.

## Common problems

**I can't find a project a teammate made.** It may be shared with picked people only. Ask its owner to add you. Team projects are under **Browse projects**.

**I can't leave my project.** You own it. Hand it over first, and leave once the new owner accepts.

**Pin to top is refused.** The chat already holds 50 pins. Unpin one to pin another.

**The board has no task list.** Your workspace is on EU data residency, where the board's task list is not available.

## Related

- [Talk to Viktor](/docs/talk-to-viktor)
- [Use Viktor in the web app](/docs/viktor-web-app)
- [Scheduled tasks](/docs/scheduled-tasks)
- [Spaces](/docs/spaces)