TattvaDocs
Getting started

Create a project

What a project is, how to create one from the workspace switcher, and what happens when you click Launch.

A project holds one slice of your business: its sources, its ontology (Tattva's model of what your data means), its questions and answers, and its trackers, boards and reports. Most teams have one project per function or per major initiative.

A workspace is your company. It holds many projects and a shared Workspace Library of definitions every project uses. See Workspace library.

Who can create a project

Workspace owners and admins. If you don't see New project, ask an admin to create the project and add you.

Open the wizard

Click the workspace switcher at the top of the sidebar. Under Projects in your workspace, click New project.

Workspace switcher with New project

Step 1: Function

"What function does this project focus on?" Pick the card closest to the questions you will ask:

FunctionFocus
SalesPipeline, deal flow, and revenue tracking
MarketingCampaign performance and funnel optimization
People and OrgHiring pipeline and talent quality monitoring
CustomerCustomer service analytics and call center insights
ProductFeature adoption, engagement, and PLG funnel
GrowthRevenue growth, retention, and expansion metrics
Decision IntelligenceExtract decisions, track ownership, detect conflicts

Choosing a function

Click Continue →.

Choose the function carefully

You cannot change a project's function later. Project settings only let you edit the name and description.

Step 2: Name and files

"Name your project". If you leave the name blank, Tattva uses the function name, for example "Marketing Project".

Add files now if you have them. Drop them on the box that reads "Drop CSV / XLSX / MD / TXT files here", or click Choose files. They upload after you click Launch. You can also skip this and add sources later.

The Data you'll need panel lists the kinds of data this function usually uses, the tools that export them, and example file names. Some functions also list sample file names you can look for. Nothing is loaded for you.

Files listed and the Launch button

Click Launch →, or Launch + upload N files → if you added files. ← Back returns to step 1.

What Launch does

  1. Creates the project and switches you into it.
  2. Uploads any files you added. The wizard shows progress: "X/N uploaded".
  3. Opens Sources, where each file is processed until it is Ready.

There is no separate build screen. Continue on Connect data sources.

Change a project later

Click your name at the bottom of the sidebar, then Settings → Project. There you can edit the Name and Description. The page also shows activity counts and, under Danger zone, Delete project.

Tips

  • Start narrow. One function and a few sources you trust. You can create more projects later.
  • Use descriptive file names. 2026_q1_orders.csv tells Tattva more than data1.csv.
  • Let your data analyst connect warehouse tables. BigQuery tables and metric documents are set up on Sources. See For data analysts.

Next: Connect data sources.

Create a project — Tattva Docs