Skip to content

Projects ​

Purpose: a project is the working container in DDL. Connections, the ETL pipeline, SQL queries, schedules, monitoring, charts and dashboards all live inside one project, and access is granted per project. This page covers finding projects, creating them, naming them, sharing them and reading their version history.


Find a project ​

Projects live at /projects, reachable from the Projects → View All link on the home dashboard or by clicking the DDL logo and navigating there.

The projects listThe projects list in table layout, with search, the owner filter and the Create New button.

ControlWhat it does
Create NewCreates a project immediately (see the warning below)
Table / grid switchToggle between the row table and card grid
Search ProjectFilter by name
Owned by anyoneOwner filter — narrow the list to projects owned by a specific person
Reset FilterClear search and owner filter at once
Table columnsPROJECT NAME · OWNER · LAST MODIFIED
Pagination footerPage number and page controls

An empty account shows a magnifier icon and the message "There is no project to show".


Create a project ​

Create New has no dialog

DDL creates the project the moment you click Create New — with an auto-generated name (Project 1, Project 2, …) — and navigates straight into its Pipeline canvas. There is no name field to fill in first. Rename it immediately (next section) or you will be maintaining a pipeline called Project 7.

  1. Go to /projects.
  2. Click Create New.
  3. You land on the new project's Pipeline canvas, which briefly shows "Loading…".

Straight into the new projectThe redirect after one click — you are already inside the new project.

  1. Return to /projects and you will see the new row.

The list with the new projectThe auto-created project appears with owner me and a "less than a minute ago" timestamp.

TIP

The dashed Create New Project / Click here tile on the home dashboard does exactly the same thing in one click. Both paths create instantly, so use the tile only when you mean it.


Rename a project (Project Settings) ​

  1. Open the project and click Project Settings in the left rail (it is pinned to the bottom).
  2. The page header reads Project Settings — "Review or change various configuration for your project".
  3. Click the Change Project Name row.
  4. In the modal, replace the pre-filled name and click Save. The header, breadcrumb and projects list all update.

Project SettingsThe Project Settings page. Rows: Change Project Name, Email Notification, Data Retention Duration, Lock Project, Sensitive data (AI), Delete Project.

RenamingThe Change Project Name modal with the new name typed in.

RenamedConfirmed — the project header now shows the new name.

What the other rows do ​

RowBehaviour
Email NotificationCounter of configured e-mail notifications for this project
Data Retention DurationRetention window, shown in days (e.g. 0 days)
Lock ProjectPrevents edits to the project
Sensitive data (AI)Switch. On-screen wording: "Data of this project only goes to the company's own AI model (Settings > AI > AI Agent > Sensitive data). Without it, the AI does not read this data." Leave it off unless an internal model is configured — see AI & MCP integration
Delete ProjectDestructive and irreversible. There is no undo; check who you shared the project with first

The project sidebar ​

Inside a project, the left icon rail is the navigation. Click the hamburger to expand it and see labels.

Expanded project sidebarThe full tab list: Connections, Custom Connector, Pipeline, SQL Query, Schedule, Monitoring, Charts, Dashboards and (pinned at the bottom) Project Settings.

TabWhat it opensGuide page
ConnectionsImport/export connections for this projectConnections
Custom ConnectorConnectors your organisation definedConnections
PipelineThe ETL canvas — this is the bare project URLPipelines (ETL)
SQL QueryThe SQL workbenchSQL Query
ScheduleRecurring syncsSchedules
MonitoringProcesses for this projectMonitoring
ChartsSaved chartsCharts & Dashboards
DashboardsDashboard collectionCharts & Dashboards
Project SettingsEverything in the section abovethis page

Two tabs appear only in context

Custom Connector is rendered while you are in the Connections area, and SQL Query / Schedule appear on pipeline-related views. If a tab seems missing, expand the rail and click the nearest sibling — the rail is contextual, not broken.


Share a project ​

  1. On the Pipeline toolbar click Share.

Share Project modalShare Project: your current team and role are shown at the top, Members and Roles tabs sit below it, and Add New Access grants access.

  1. Read the line under the heading — it tells you which Team and Role you are sharing as.
  2. Use Members or Roles tabs, the search box, and Add New Access to grant access.

WARNING

Sharing is how other people see your nodes, SQL history and connections. Grant access deliberately, and revoke it when a collaboration ends. An empty list simply means nobody else has been added yet — the modal then shows "There is no Member shared with this share project."


Versions (project history) ​

Versions on the Pipeline toolbar opens the project's version history at /projects/<id>/history. It answers "what did this node look like yesterday?".

Versions pageThe Versions page in a project with no history yet.

Versions page, populatedThe controls: a Node name dropdown, a date and a time, then Preview and Dump Data — with the empty state "Nothing to Preview".

  1. Open the Node name dropdown and pick a node.

Node dropdownThe dropdown lists the project's nodes.

  1. Choose a date and time, then click Preview to inspect that version.

Version previewNode and timestamp selected, ready to preview.

Dump Data is an export

Dump Data starts a real export/backup job for that version. Use it when you deliberately want the data out of DDL, not as a "view" button.


Housekeeping tips ​

  • Name projects like datasets, not like tickets. The name appears in the breadcrumb, in Monitoring's PROJECT NAME column and in aggregate usage reports.
  • One project per workstream. Storage Usage and AI Ops break usage down per project, so a project that mixes three unrelated jobs produces numbers nobody can read.
  • Check the list before creating. Aggregate pages (Storage Usage, Process Usage, AI Ops) may show projects owned by other people even when /projects for your account lists only your own. See the FAQ.

The projects list, checked at the endA tidy account: one project, clearly named.


Next: Data Repository · Related: Pipelines (ETL), Monitoring

Delman Data Lab — user guide for the DDL web application at ddl.delman.io.