How to use
Cannelle.

Step-by-step guides to help you and your team get the most out of Cannelle — from initial setup to day-to-day project and revenue management.

New Company Setup

When you first sign up, Cannelle creates your company and admin account in one step and seeds the workspace with sample data so you can start exploring right away.

// try before you commit

Not ready to set up your own instance? The live demo at demo.cannelle.io lets you explore the full app with pre-loaded sample data — no sign-up, no email address required. Log in with demo@cannelle.io. Data resets daily.

// first steps

1.

Sign up

Enter your email on the sign-up page. A magic link is sent to your inbox — no password required.

2.

Verify your email

Click the link in the email. Your company and admin account are created automatically.

3.

Explore sample data

A sample client, quote, project, and invoice are pre-loaded so the workspace is ready to explore.

4.

Configure company details

Go to Settings → Company to add your logo, address, and billing information.

5.

Invite your team

Go to Settings → Users to invite colleagues. Assign permissions per module.

// settings overview

CompanyName, logo, address, currency, and locale
UsersInvite team members and manage permissions
Task DefinitionsEnable and configure task types for projects
TemplatesManage PDF and email templates
IntegrationsConfigure webhook endpoints

User Profile

Your profile controls how you appear to colleagues across the platform — in assignments, workspace messages, and activity feeds.

// what you can update

Display name

The name shown in comments, messages, and assignments

Avatar

Upload a profile photo (JPEG or PNG, max 2 MB)

Job title

Shown alongside your name in the workspace

Language

Interface language preference

Availability

Set your working hours and days off in the availability calendar

Adding New Users

Only administrators can invite new team members. Users are invited by email and automatically receive a magic link to log in for the first time.

// invitation flow

1.

Open Settings → Users

Navigate to the Users section in your company settings.

2.

Click Invite User

Enter the new user's email address and display name.

3.

Assign permissions

Set module-level access for each domain: None, Read, Write, or Admin.

4.

Send invitation

The user receives an email with a one-time login link (valid for 24 hours).

5.

User activates account

Clicking the link creates their session and lands them on the dashboard.

// permission levels

levelwhat the user can do
NoneNo access — the module is hidden entirely
ReadView records but cannot create or edit anything
WriteCreate, view, and edit records within the module
AdminFull access including deletion and module configuration

Login and Logout

// passwordless only

Cannelle uses magic link authentication exclusively — there are no passwords to remember or reset. Read more →

// logging in

1.

Go to the login page

Navigate to your Cannelle instance URL.

2.

Enter your email

Type the email address associated with your account.

3.

Check your inbox

A magic link email arrives within a few seconds. Check your spam folder if it doesn't appear.

4.

Click the link

The link is valid for 15 minutes. Clicking it logs you in and creates a 30-day session.

// sessions

Session duration

30 days — auto-extended when you're active

Auto-renewal

Sessions renew automatically past their halfway point

Multiple devices

You can be logged in on multiple devices simultaneously

Logout

Use the menu in the top-right corner to log out on any device

Dashboard

The dashboard is the first screen you see after logging in. It's a configurable two-column widget board — show the information that matters to you and hide the rest. Each person on your team can save their own layout.

// available widgets

Open Projects

Projects currently in active state with their codes, clients, and progress indicators

Revenue Chart

Monthly revenue bar chart for the current year, built from sent and paid invoices

Workspaces

Recently active workspaces with unread message counts and quick links

Following Feed

Latest activity across all entities you follow — with entity type badges and direct links

Whiteboard

The most recent company-wide announcement posted by an admin

Uninvoiced Projects

Completed projects that have no invoice yet — a quick billing checklist

Draft Invoices

Invoices in DRAFT state that are ready to review and send

// customising your dashboard

1. Click the configure button (top-right of the dashboard) to open the widget selector.
2. Toggle any widget on or off — your preference is saved automatically.
3. Drag and drop widgets to reorder them. The layout persists across sessions.

// suggested layouts by role

rolerecommended widgets
SalesRevenue Chart, Following Feed, Draft Invoices, Uninvoiced Projects
Project ManagerOpen Projects, Workspaces, Following Feed, Whiteboard
FinanceDraft Invoices, Uninvoiced Projects, Revenue Chart, Following Feed
Company overviewRevenue Chart, Open Projects, Uninvoiced Projects, Whiteboard

Read the full dashboard walkthrough →

Command Palette

The command palette lets you navigate anywhere in the app, search for records, and trigger common actions without lifting your hands from the keyboard.

// opening the palette

Mac ⌘ K
Windows / Linux Ctrl K

Following and Unfollowing

Following a record means you'll see updates whenever it changes — state transitions, new tasks, invoices issued, and more. Your personal activity feed aggregates all updates across everything you follow, both on the dashboard and on the Activity → Followings page.

// what you can follow

ClientsProjectsQuotesInvoicesResources

// how to follow

1. Open any record — client, project, invoice, etc.
2. Click the Follow button in the record header or action bar.
3. The button changes to Following — you're now subscribed to updates.
4. To unfollow, click Unfollow. Updates will stop appearing in your feed.

// viewing your activity feed

Dashboard widget

Shows the 5 most recent activity entries with entity type badges (Client, Sales, Project, Invoice, Resource) and direct links to the record

Activity → Followings page

Full paginated table — date, user, entity type, record name, action description, and an info tooltip with structured change details

Clients

The Clients module manages your entire sales pipeline from first contact to long-term client. Records progress through three states as the relationship develops. See the full client guide →

// pipeline stages

LEAD PROSPECT CLIENT

// key actions

Create a lead

Click New Client and fill in the contact details. New records start as Leads.

Convert to client

Leads and Prospects automatically become Clients when the first project is created.

Add contacts

Attach multiple contacts to a single client company.

Attach documents

Upload contracts, briefs, or any files directly to the client record.

Add notes

Log call notes, meeting summaries, or any internal comments on the activity timeline.

Create a quote

Start a quote directly from the client record to link it automatically.

Workspaces

Invite clients to Atelier to exchange messages and documents in a shared workspace.

Export

Export your client list to CSV for reporting or migration.

Resources

Resources are freelancers and external contractors you assign to project tasks. Cannelle tracks their services, availability, certifications, and work history.

// vetting stages

UNVERIFIED INTAKE ASSESSMENT CONTRACTING ACTIVE

// key features

Service matching

Search resources by service type to find the right person for a project

Availability calendar

See each resource's working days and mark them as unavailable for holidays or existing commitments

Assignment history

View all past tasks a resource has worked on, including ratings and feedback

Certifications

Track NDA, GDPR, ISO, and any other compliance documents with expiry dates

Rates

Store standard rates per service type for quick quote and assignment pricing

Banking details

Store IBAN and BIC per resource for SEPA payment batch exports

Workspaces

Invite active resources to the Atelier portal so they can view assignments, upload deliverables, and submit invoices

Quotes

Quotes are the starting point for client engagements. Build a detailed quote with tasks and pricing, generate a PDF, and convert it to a project once accepted.

// quote lifecycle

DRAFT QUOTE PROJECT

// creating a quote

1.

Create the quote

Open the client record and click New Quote.

2.

Add tasks

Add one or more tasks. Each task has a type, description, quantity, and unit price.

3.

Review totals

The quote summary shows subtotal, taxes, discounts, and the grand total.

4.

Generate PDF

Use the PDF button to produce a client-ready quote document.

5.

Send to client

Email the PDF directly from Cannelle or download and send manually.

6.

Convert to project

Once the client accepts, use Convert to Project to kick off delivery.

Projects

Projects are active client engagements. They contain tasks, resource assignments, files, and a full activity log. Projects can be created from a quote or from scratch.

// project lifecycle

DRAFT QUOTE PROJECT COMPLETED

A project can also be CANCELLED at any stage.

// working with projects

Tasks

Add tasks to a project. Each task has a type, deadline, word count or unit, and status.

Assignments

Assign tasks to resources. Each assignment is a purchase order with a rate and deadline.

Files

Attach source files, references, and deliverables directly to the project or individual tasks.

Timeline

See all activity and status changes on the project timeline.

Clone

Clone any project or template to reuse its structure for a new engagement.

Templates

Mark a project as a template to make it available when cloning future projects.

Invoices

Cannelle handles the full invoice lifecycle from draft to payment.

// invoice lifecycle

DRAFT SENT REMINDER 1 REMINDER 2 COLLECTION PAID

// creating an invoice

1.

Create the invoice

Open a client record and click New Invoice for a client invoice, or open a project and click New Invoice for a project invoice.

2.

Add line items

For client invoices, add services or deliverables manually. For project invoices, all tasks are added automatically as line items — you can then add, update, or remove them as needed.

3.

Generate PDF

Preview and download the invoice as a PDF using your company's template.

4.

Send to client

Use the Send action to email the invoice directly from Cannelle.

5.

Track payment

Mark the invoice as Paid once payment is received. Cannelle logs the payment date.

// recurring invoices

For retainer clients, you can create a recurring invoice schedule. Cannelle will automatically generate draft invoices on the configured cadence (weekly, monthly, quarterly) so you only need to review and send.

// e-invoicing and xml export

Every invoice can be exported as a UBL 2.1 XML file — the structured e-invoicing format required or recommended across the EU. The XML is generated from the same invoice data as the PDF and is automatically saved as a document attachment on the invoice record.

This is useful for clients who require structured invoices for their accounts payable systems, and for compliance with national e-invoicing mandates being rolled out across Europe. Read more about e-invoicing →

Resource Invoices

The Resource Invoices module handles the inbound side of your finances — invoices you receive from freelancers and contractors. Every completed assignment is tracked until an invoice is registered against it, so nothing gets missed between delivery and payment. See the full workflow guide →

// invoice lifecycle

UNINVOICED RECEIVED PAY LIST PAID

// tabs overview

UninvoicedAll completed assignments with no invoice yet. Register an invoice directly from this list.
ReceivedInvoices that have been registered or submitted by the resource. Review and approve here.
Pay listApproved invoices ready for payment. Export to Excel or generate a SEPA XML batch for your bank.
PaidPermanent record of all paid invoices with payment dates.

// registering an invoice

1.

Open Resource Invoices → Uninvoiced

Every completed assignment without an invoice appears here.

2.

Click Register Invoice

A modal opens pre-filled with the assignment value and the applicable tax rate.

3.

Verify and adjust

Change the tax rate if needed, enter the invoice number from the document the resource sent, and add an optional description.

4.

Create

The assignment moves to Received. You can combine multiple assignments from the same resource into one invoice — useful for monthly payment runs.

// approval and payment

Bulk approval

On the Received tab, select one or more invoices with the checkboxes and click Approve. Approved invoices move to the Pay list.

SEPA XML export

On the Pay list, click SEPA XML to generate a payment batch file accepted by European banks. Upload it to your online banking platform to pay all selected invoices at once.

Excel export

Export the Pay list as a spreadsheet for your own records or to share with your accountant.

Mark as paid

Once payments go out, mark invoices as paid. They move to the Paid tab as a permanent record.

// iban and bic required for sepa

For SEPA XML exports to include payment details, each resource must have their IBAN and BIC registered under Resources → Billing. Cannelle will flag any missing details before you export.

// resources can invoice themselves

Resources with access to Atelier can submit their own invoices against completed assignments. These land directly in the Received tab — no manual registration needed on your side. You just review and approve.

Workspaces and Atelier

Workspaces are shared messaging and file-sharing spaces between your internal team and external contacts — clients or resources. External users access workspaces through the Atelier portal. Learn more about Atelier →

Internal — Community App

  • → Create and manage workspaces from any project, quote or client
  • → Real-time messaging
  • → Upload and share files up to 20 MB
  • → Invite client or resource contacts to collaborate

External — Atelier Portal

  • → Clients and resources get a dedicated login link
  • → Access only their own workspaces
  • → Send messages and upload deliverables
  • → View project documents shared by your team
  • → Email notification when new messages arrive
  • → Resources can submit invoices against completed assignments

// create a new workspace

To create a new workspace, go to the Workspaces tab on a Client, Resource, Quote, or Project record and click the New Workspace button. Please note that external users can also create workspaces within their Client and Resource records.

// inviting an external user

1.

Open a client or resource record

Navigate to the Contacts tab and find the contact you want to invite.

2.

Click Invite

Send an invitation to the contact. They will receive an email with a link to access the Atelier portal.

3.

Add to a workspace

Once invited, the contact appears as an available participant when adding members to any workspace.

Reporting

The Reports module gives you financial and operational visibility across your business. All reports support custom date-range filtering. Read about the margin reports →

// available reports

Sales per monthMonthly sales volume from quotes and deals
LoadWorkload distribution across projects and assignments
Current assignmentsResources currently assigned to active projects
Assignments per resourceTotal assignment count broken down by resource
Invoiced per monthTotal invoiced amounts broken down by month
Invoiced per clientRevenue breakdown by client
Invoiced per groupRevenue breakdown by client group
Invoiced per lead typeRevenue breakdown by lead source type
Invoiced per countryRevenue breakdown by country
Invoiced per tagRevenue breakdown by tag
Invoiced project marginsCost vs. invoiced amount per project — shows margin value and percentage for every completed engagement
Invoiced margins per clientPortfolio-level margin rollup by client — compare profitability across your entire client base
Average payment timesHow long clients typically take to pay invoices
Availability calendarResource availability overview across your team
Activity logFull audit trail of actions taken across the platform

// premium & bi tools

Premium Edition: The Premium Edition supports fully custom reports tailored to your business.

BI tools: You can connect your own BI tool — such as Amazon QuickSight or Microsoft Power BI — directly to the Cannelle database for more fine-grained analytics and visualisations.

// permissions

Access to Reports requires at least Read-level permission on the Reports module. Administrators can restrict access in Settings → Users.

Templates

Templates control how your PDF documents and emails look and what they contain.

// pdf templates

Invoice template

Applied when generating invoice PDFs for clients

Quote template

Applied when generating quote/proposal PDFs

Assignment template

Used for resource purchase order PDFs

// email templates

Create reusable email templates for common communications — quote follow-ups, onboarding messages, or payment reminders.

// project templates

Mark any project as a template to make it reusable. When starting a new project, clone a template to copy its task structure, service types, and default pricing. Templates are managed in Projects → Templates.

Integrations

Cannelle supports outbound webhooks that fire when key events happen in your workspace. Use these to connect Cannelle to external tools like Zapier, Make, Slack, or your own internal systems.

// setting up a webhook

1.

Go to Settings → Integrations

Open the Integrations section in your company settings.

2.

Add a webhook endpoint

Enter the URL that should receive the event payload.

3.

Choose events

Select which events should trigger the webhook — e.g., invoice sent, project completed.

4.

Save and test

Cannelle sends a test payload so you can verify the connection.

// supported events

eventtriggered when
quote.createdA new quote is created
quote.updatedA quote is updated
quote.sentA quote is sent to a client
quote.convertedA quote is converted to a project
quote.cancelledA quote is cancelled
project.createdA new project is created
project.updatedA project is updated
project.completedA project is marked as completed
project.cancelledA project is cancelled
invoice.createdA new invoice is created
invoice.updatedAn invoice is updated
invoice.sentAn invoice is sent to a client
invoice.reminder1A first payment reminder is sent
invoice.reminder2A second payment reminder is sent
invoice.collectionAn invoice moves to collections
invoice.paidAn invoice is marked as paid
// need more help?

Check the technical documentation for API references, deployment guides, and developer resources.

view documentation →