Skip to main content

Create and Manage a Project

Use this page to create a project, connect data, manage project access, and handle project reset or deletion.

Before you begin​

Plan support
  • Free plan: Up to 2 projects
  • Essential plan and above: Unlimited projects
note

You must be an organization admin to create or delete a project. Project owners can manage most project settings after the project is created.

Create a project​

As an organization admin, you can create a project from the navigation bar.

  1. Open the project switcher or navigation menu.
  2. Click Create project.
  3. Enter the project details and confirm creation.

create_project_1

create_project_2

Next steps after project creation​

After the project is created, continue with these setup steps:

  1. Set up a data source connection.
  2. Start asking questions in your project after the initial metadata sync is complete.

connect

note

Wait for the initial metadata sync to finish.

tip

Initial synchronization can take time. During this step, Wren AI syncs metadata and schema information from your data source. It does not copy or ingest your raw data into Wren AI. Wait until the metadata sync is complete before asking questions so Wren AI can understand your data structure correctly.

Project settings overview​

After a project is created, open Project Settings to update configuration, access, and data source details.

General​

Project owners can update the project name and project language in General.

Update project name​

Change the display name of the project in General.

project_setting_general

Update project language​

Change the project language in General. This setting affects the language Wren AI uses when responding in the project.

project_setting_language

Access control​

Use Access Control to manage who can access the project and what each user can do.

note

Only users with the Project Owner role can manage project access.

Wren AI supports three project roles:

  • Project Owner
  • Project Contributor
  • Project Viewer

To review the meaning of each role, see Manage Members and Roles.

Add a member​

Before you add someone to a project, invite them to the organization.

  1. Click Add member.
  2. Select the organization member you want to add.
  3. Choose the project role to assign.

add_project_member

After the user is added to the project, they can start asking questions against connected datasets based on their permissions.

Update a member's permission​

  1. Find the user in the member list.
  2. Open the Permission dropdown.
  3. Select the new project role.

update_project_member_1

Keep these restrictions in mind:

  • You cannot modify your own role.
  • The organization admin is an owner of all projects by default.
  • You cannot change the role of the organization admin.

update_project_member_2

Remove a member​

Project owners can remove other users from a project.

  1. Find the user in the member list.
  2. Click Remove on that user's row.

remove_project_member_1

After removal, the user can no longer access the project or its ask records.

note

You cannot remove the organization admin from the project.

Data source​

Project owners can create or update the project's data source connection in Data Source.

If no data source is connected yet, continue the setup flow from this section.

data_source_setup

If a data source is already connected, you can view and edit the connection details here.

data_source_setting

Danger zone​

Use Danger Zone for destructive project actions.

danger

Actions in this section cannot be undone.

Reset project​

Resetting a project removes its current settings and records, including data connection information, Modeling page information, and Home page threads.

Reset your projects in Wren AI

Delete project​

Only organization admins can delete a project.

Deleting a project permanently removes access to its ask records for all owners and members.

delete_project

note

You cannot delete the project if it is your last accessible project within the organization.