zvena Help
The essentials of zvena in one place. Can’t find an answer? Write to us and a person will reply.
Start here
- Getting startedSign in, find your private workspace, bring your team
- Apps for your devicesInstall zvena on Android, Windows, macOS, Linux, iPhone and iPad
- Workspaces and rolesDecide who can edit, comment or only read; single sign-on and admin
- Import and exportBring your work from Notion, Linear or Figma; take yours with you
Using zvena
- DocsWrite notes and wikis, build databases, publish a page
- ProjectsTrack tasks on a list or a board, plan cycles and projects
- DesignMake designs and prototypes, open them on a phone
- TablesTurn a spreadsheet or a database into a base with a report
- Calendar and bookingPlan meetings, sync calendars, share a booking link
- MailConnect Gmail, iCloud or any IMAP mailbox
- zvena AIAsk the assistant, know what it can change; Make and Agents
- Goals and automationsSee what zvena keeps in step for you, and undo it
Your account
Guides
- Install on AndroidFrom our site or from our F-Droid repository
- Install on Windows, macOS and LinuxThe desktop app: which file to pick and how updates work
- Install on iPhone and iPadzvena as a web app, with notifications
- NotificationsIn zvena, push, email and messengers
- Working offlineWhat works without a connection and what waits for it
Getting started
Sign in, find your private workspace, bring your team
Continue with Google, GitHub, or enter your email and we'll send you a one-time sign-in link. The same email address always leads to the same account.
Every account comes with a private workspace that only you can see.
On the Team page, create a shared workspace and send teammates an invite link.
Try it now (the trial): a real workspace with a small design studio's work in it — projects and their tasks, docs, a design and a calendar, linked — and nothing to sign up for. It is saved on our servers for this browser. Sign up from it and everything you made stays yours. Until then it can't invite people, buy a plan, send email or publish to the web, and it is deleted if nobody opens it for 30 days.
Or write in Docs without an account: your pages stay in this browser, and they move into your personal workspace the first time you open Docs after signing in. Without an account you can upload pictures only, and they are deleted 30 days after upload unless you sign in. Docs without an account is Docs alone: Design, Projects and Calendar are in Try it now; Mail, sharing and publishing need an account.
Apps for your devices
Install zvena on Android, Windows, macOS, Linux, iPhone and iPad
zvena works in any modern browser, and as an app on your phone and computer: the same workspace, with notifications, the unread count on the icon and work without a connection. Get the apps on the download page.
- Install on Android — from our site or from our F-Droid repository.
- Install on Windows, macOS and Linux — the desktop app: which file to pick and how updates work.
- Install on iPhone and iPad — zvena as a web app, with notifications.
- Notifications — in zvena, push, email and messengers.
- Working offline — what works without a connection and what waits for it.
- On Android, install the zvena app (or install zvena from Chrome with Add to Home screen or Install app), then use the Share menu of any app → zvena. Pick a page, a database or your Private section and press Save; the article's text and pictures are copied into a new page.
- The Web Clipper browser extension and other apps you connect are listed in Settings → Connected apps, where you can disconnect each one.
Workspaces and roles
Decide who can edit, comment or only read; single sign-on and admin
A workspace holds your docs, tasks and designs. Each member has one role in it, and it applies everywhere in the workspace:
- Owner — everything, including members, invite links and deleting the workspace.
- Editor — creates and edits docs, tasks and designs.
- Commenter — reads, comments and suggests edits: what they type in a doc shows as a suggestion that an editor accepts or rejects.
- Viewer — reads only.
Invite links are valid for 14 days by default and can be revoked any time on the Team page. Owners can change roles, remove members and transfer ownership. Switch between workspaces from the menu at the top of the sidebar.
For owners of team workspaces. These are on every plan, Free included.
- Verified domains (Settings → Identity): add your company's domain and put the TXT record zvena shows you in its DNS. You can then let people with a verified address at that domain join from the sign-in page.
- Single sign-on (SSO): connect your identity provider with SAML 2.0 or OpenID Connect (Okta, Microsoft Entra ID, Google Workspace and others). You can let new people join on first sign-in, and require SSO for your domain; owners always keep another way in.
- SCIM provisioning: create a token and give your directory the SCIM base URL, so people are added to and removed from the workspace and its groups automatically.
- Security and Audit log: decide whether the workspace may publish to the web, share with guests, export and move pages out, and see sign-ins, member changes, sharing and settings changes.
Import and export
Bring your work from Notion, Linear or Figma; take yours with you
Import (owners and editors). Pick the source, connect it with a personal token, an export file or its sign-in where this server offers one, then choose one project or everything zvena supports: Notion pages and databases go to Docs, Linear issues to Projects, Figma files to Design. Each import ends with what came over as it was, what came over in a slightly different form, and a button to open it; Settings → Import keeps every report. Importing copies your work once; connecting a service in the Ecosystem is a different thing, a live link. Step by step: migrating from Notion.
Import in a page's ⋯ menu takes a Notion export (HTML or Markdown & CSV), Markdown and text, HTML, CSV (as a database), Evernote (.enex), Word (.docx), and exports from Trello, Asana, Jira and Confluence.
Import .penpot files and SVG, or bring a Figma file over: File → Import from Figma… with the file's link and a Figma personal access token (used for that import only, never stored), or Import .fig file. Instances arrive as plain layers.
- Out of Docs: export any page as PDF, HTML or Markdown & CSV (databases as CSV) from its ⋯ menu.
- Out of Design: export boards and layers to PNG, JPG, WEBP, SVG or PDF, or download the whole file as .penpot.
- Everything at once: Download your data, under Your data and account.
Docs
Write notes and wikis, build databases, publish a page
- Type / on an empty line to insert any block: headings, lists, to-dos, toggles, callouts, tables, databases, code, math and design frames.
- Databases can be shown as a table, board, list, gallery, calendar, timeline, chart, form, map, feed or dashboard — with filters, sorts and grouping.
- Publish a page to the web from Share → Publish. Anyone with the link can read the page and its sub-pages; nobody can edit them. Search engines skip it unless you allow indexing.
- Need input from people outside your team? Turn a database view into a form and share its link. Responses arrive as new rows.
- Several people can edit a page at the same time: you see each other's cursors and names as you type. Page history in the ⋯ menu shows earlier versions and who made them, and restores any of them.
- Pages open from your browser's cache, so they load instantly and keep working on a shaky connection.
Select lines, open the block menu (⋮⋮) and choose Create task. Step by step in notes and tasks in one workspace, and for decisions in a decision log linked to its tasks.
- In a page, type /design and pick a file and a board.
- The preview updates on its own when the design changes. Click it to open the design.
- In Design, the main menu's Documents with this design shows every page where the design is used.
On published pages the frame shows a caption instead of the preview, so your designs are never exposed through a public link.
Projects
Track tasks on a list or a board, plan cycles and projects
- Open Projects from the sidebar. Your workspace gets a team with a few example tasks to try things on. Press C anywhere in Projects for a new task, and ? for every keyboard shortcut.
- Each task has an ID like ABC-12, a status from its team's workflow, a priority, assignee, labels, project, cycle, due date and estimate — plus subtasks, relations (blocks, related, duplicate), comments and attachments.
Switch between list, board and calendar, group, sort and filter, and save the result as a view for yourself or the whole workspace. Click a task to open it on the side. Most changes can be undone with Ctrl/Cmd+Z.
Projects have a lead, dates, milestones and status updates, and the Roadmap shows them on a timeline you can drag. Cycles are a team's sprints, with a burn-up chart; unfinished tasks move on when a cycle ends.
Smart suggestions propose a new task's priority, label, project and assignee and flag likely duplicates. When the answer is confident, empty fields are filled in automatically — marked in the task's history and undoable. The workspace owner can turn either off in Settings → zvena AI (Background suggestions, Allowed auto-fill). What is sent and to whom is in the Privacy Policy.
Design
Make designs and prototypes, open them on a phone
- Open Design from the sidebar. You're signed in automatically with your zvena account, and you see the designs of the workspace you're in.
- Boards, components, auto layout, prototypes and inspect mode work the way you know from other interface design tools.
- On a phone you can open designs to view them, comment and play prototypes; editing needs a larger screen.
In the editor, open the main menu → Plugins → Plugins manager, paste the address the plugin's developer gives you (it ends in manifest.json) and choose Install. A plugin is a small app by another developer that works in your file. Before it's installed you see what it asks to do, so install only plugins you trust. Remove one in the same manager.
- zvena Design is based on Penpot, so the Penpot user guide explains every tool in depth.
- Start from a template — a landing page, a mobile app or a UI kit — on the Templates page.
Tables
Turn a spreadsheet or a database into a base with a report
Open Tables from the sidebar. A base is a table of records: start with an empty one or a ready structure (projects, clients, invoices) and type your records in, or upload data — a CSV or Excel file, or a PDF, Word, Markdown, HTML, JSON or text document with a table in it. Your columns become the base's fields.
Connect a database or another source instead of a file, and the base reads from it; the connection's password or token is kept encrypted and never shown again. With a row ID column, the next file or refresh updates the rows instead of adding them twice.
- The report counts as you go: totals, how they changed from one period to the next, and charts. Views show the same records as a grid, a board or other layouts, with filters and sorting.
- Share a base or a report with a link that opens without an account, or collect new records with a form. Not sure where to start? Try the example on Tables' first screen: a small studio's invoices, ready to change.
Calendar and booking
Plan meetings, sync calendars, share a booking link
Open Calendar from the sidebar. Events can repeat, have guests, reminders and a video-call link; guests outside zvena get an email invitation they can answer. Docs databases and Projects with dates can be shown as layers.
- Other calendars: Subscribe by URL adds a read-only calendar by its iCal address (Google, Outlook, Apple, holidays). Connect a CalDAV account syncs both ways with iCloud, Fastmail, Nextcloud and other CalDAV servers — use an app-specific password. Google and Microsoft calendar sign-in isn't available yet.
- See zvena in another app: a calendar's Secret address in iCal format lets other calendar apps show it. Anyone with that address sees every event, so keep it private, and use Reset address if it leaks.
Create a New scheduling link, set your weekly hours, meeting length, buffers and notice, and share the link. People pick a free time without an account; the meeting lands in your calendar, both of you get an email with the details, and your guest gets a link to reschedule or cancel. Visitors only ever see free times, never what you are busy with.
Connect Gmail, iCloud or any IMAP mailbox
- Open Mail from the sidebar and choose Connect a mailbox. Pick Gmail, Outlook, iCloud, Yahoo or Fastmail, or Other (IMAP / SMTP) for any other server. You can connect up to 10 mailboxes.
- Most services need an app password rather than your normal one: turn on 2-step verification with your provider, then make an app password (the connect form links to the right page). Some Microsoft accounts allow only Microsoft's own sign-in for mail apps; those can't be connected with a password yet.
zvena syncs the last 90 days of mail and keeps it in step with your server both ways: what you read, move or delete here changes there too. Messages you send go out through your own mail server, so they look exactly as if you sent them from your usual app.
Your mail is visible only to you. You can save a conversation to a page or turn it into a Projects task; only what you copy that way is shared with your workspace. Disconnecting a mailbox removes its copy and password from zvena and changes nothing on your server. Details are in the Privacy Policy.
zvena AI
Ask the assistant, know what it can change; Make and Agents
- zvena AI is the assistant in Docs, Design and its own panel. It works only when you ask it something, and with your rights: what you can't open or change, it can't either.
- It changes the page or task that is open or that you name; anything else it would change becomes a proposal for you to accept. What it did is shown with Undo.
Its answers are written by AI models and can be wrong: check them before you rely on them. zvena doesn't use your work to train AI models; what is sent, and to whom, is in the Privacy Policy.
The workspace owner turns zvena AI on or off for the whole workspace in Settings → zvena AI. Some models are free; others use AI credits: the free plan includes an AI trial: 125 AI credits a month per account, renewed on the 1st, and paid plans include credits every month.
- Open Make (in the sidebar, under More), describe the app you want — who uses it, what they do, what it keeps — or start from a kit: a dashboard, a form, a landing page, an internal tool or a booking app. zvena AI builds it: screens, a database and sign-in.
- Change it by asking again, or edit its code. Keys for its server functions are kept encrypted under Secrets, never in the app's code.
- Publish gives the app a link of its own. Owners and editors build apps; everyone in the workspace can open them. Publishing needs an account.
- Agents (in the sidebar, under More) shows the AI coding sessions running on your computers and servers, live: what each one does, what it changed and what it costs. Free on every plan.
- To connect a machine, open Agents → Connect a machine and run the command it shows in a terminal there; zvena asks you to confirm in this workspace. Sessions you start on that machine appear at once.
- From Agents you can allow or deny a session's requests while you are away, send it a message, stop it, or share its summary with your team's project. The workspace owner can turn connected sessions off, or let them only watch.
Goals and automations
See what zvena keeps in step for you, and undo it
A goal is a task that closes by itself when a number reaches its target. Open a task and choose Close automatically when…, or choose Set a goal under a chart in Docs. The number can be typed in, sent from your analytics or a script (on Home, the gear of Automations, What runs by itself → Numbers from your tools makes a key), or counted by zvena: rows of a database or chart, a project's progress, meetings in a calendar. When it gets there, the task closes and, if Also mark linked documents done is on, the Docs rows linked to it are marked done.
Exact rules run the moment their condition becomes true, the same way every time, decided by the rule itself rather than a model: a goal's number reaching its target, a parent task closing when all its subtasks are done (and reopening with one), a task closing when its Design comment is resolved, a task's due date following its meeting. The workspace owner can switch the automatic ones off under What runs by itself.
Smart suggestions are proposals a person confirms: fields of a new task, likely duplicates, a goal for a task whose title names a target, and a Docs automation's Run only if… condition when the answer is not clear. They wait under Waiting for you on Home and on the task, with Accept or dismiss. They need smart suggestions to be on in the workspace (the owner decides), and each workspace has an hourly and a daily limit; past it, the model is not asked until the limit resets — exact rules keep running, and some suggestions fall back to simple rules.
Automatic actions are applied at once and listed under Done automatically on Home: a rule's result, a Docs automation's run, and suggestions the model is sure of (they fill only empty fields). Undo there puts back an automatic step — a parent task it closed, a value an automation set, a field it filled — unless someone has changed it since. A goal closed by its rule is reopened like any task; messages and webhooks an automation sent cannot be taken back.
Plans, billing and credits
What is free, what a plan adds, and how to pay or cancel
The free plan has every module for your whole team, with 2 GB of storage per account and an AI trial: 125 AI credits a month per account, renewed on the 1st. It has no time limit and no price per member.
Paid plans — Plus ($5.99 a month), Pro ($19.99 a month) and Max ($99.99 a month) — add storage, AI credits and more AI models to one workspace; its owner buys them on the Plans page, and Stripe takes the payment. Under Settings → Billing → Manage billing you change the plan or period, update your card, download invoices or cancel; a plan you cancel keeps working until the end of the period you paid for. Refunds: payments are not refunded for the unused part of a period, except where the law requires it.
AI credits pay for zvena AI's models that aren't free. A plan's credits arrive each month; credit packs can be used for 12 months, on any plan. How many credits a request uses depends on the model and on how much work it takes.
Your data and account
Download, restore or delete your data and account
How we handle your information is described in the Privacy Policy.
Settings → Download all my data gives you a ZIP with what you can open in workspaces you own or edit: docs (JSON and Markdown, live tasks with their status at export time), tasks with sub-tasks, custom fields, history and saved views (JSON and CSV), calendars with their repeating events, time zones and guests with their answers (JSON and .ics), goals and rules, uploaded files with their checksums, designs as .penpot files, your security log and account data. Its EXPORT-REPORT.md says what is left out and why: mail messages (they stay on your mail server), version history of docs, passwords and connection secrets.
Settings → Restore from an archive brings each workspace of that ZIP back as a new workspace — docs, tasks (with custom fields and history), saved views, goals, rules, calendars (guests come back as a list: nobody is invited) and files. Nothing you have now is changed; rules that act in other apps and database automations arrive switched off; designs are imported in Design from their .penpot files.
Settings → Account → Sign-in methods. A 6-digit code goes to the new address; once you enter it, the new address signs you in, the old one no longer does, and the old address gets a notice of the change. While you try zvena without an account there is no e-mail to change.
Settings → Delete account. It removes your account, personal workspace, docs, files and designs. Shared workspaces pass to the next member, or are deleted if nobody else is in them.
- Storage: each account has 2 GB for docs, files and designs together, and what members add to a shared workspace counts toward its owner's storage. Settings shows how much you use.
- Photos: large images are scaled down to 2560px on the long side when uploaded, and their metadata — including location — is removed.
- Language: Settings → My account → Interface language changes the language of zvena for you; each person picks their own.
- Security: Settings → Account → Devices lists where you are signed in, browsers and apps; sign out any one of them, or every device but this one. Settings → Sign out on all devices ends every session at once.
Ecosystem and Use anywhere
Connect the services you work in; use zvena from your assistant or editor
Settings → Apps & automations → Ecosystem. Type its name or its address (GitHub, Slack, Stripe, Jira, Notion or your own server's address) and press Find; zvena says how it connects and asks only for what that service needs. What it brings in becomes searchable and linked with your docs, tasks and events, in the workspace and in zvena AI. Free on every plan. What the Ecosystem is
Settings → Apps & automations → Use anywhere gives the address of zvena's MCP server. Add it to the assistant, code editor or chat you already use, sign in with your zvena account there, and it can search and work with your workspace with your rights. There is also a terminal tool and a Slack command.
Settings → Apps & automations → Developers makes an integration and its secret (an account is needed for that). The references: Docs API and Ecosystem API.
Still stuck?
- Contact usQuestions, bugs or ideas: a person from the team answers by email, or write to support@zvena.jevflow.net.
- System statusEach part of zvena, checked as the page loads.
- Report contentSomething illegal or abusive on a published page, form or design? A moderator reviews every report and takes down what breaks our Terms.
- DevelopersThe Docs API and the Ecosystem API.