Getting Started with MetaVox¶
MetaVox adds structured metadata to documents in Nextcloud Team folders. This guide helps you get started quickly.
What is MetaVox?¶
MetaVox enriches your documents with contextual information like: - Document status (draft, approved, archived) - Classification (public, confidential) - Ownership and responsibility - Compliance information (retention, GDPR grounds)
This metadata is stored separately from the document content, making it searchable and actionable.
Quick Start by Role¶
Users¶
- Navigate to any document in a Team folder
- Open the sidebar (click the info icon or press
i) - View and edit metadata in the MetaVox section
See User Overview for detailed instructions.
Administrators¶
- Go to Settings > MetaVox
- Select a Team folder to configure
- Define metadata fields (text, dropdown, date, etc.)
- Optionally import a compliance template
- Optionally configure licensing
See Installation Guide for setup details.
Architects¶
Review the Architecture Overview to understand: - How metadata is stored (local database, no external dependencies) - Integration points (Nextcloud Flow, OCS API) - Privacy guarantees (all data stays on-premise)
Key Concepts¶
| Concept | Description |
|---|---|
| Team Folder Metadata | Fields defined per Team folder, visible on all documents (read-only at document level) |
| Document Metadata | Fields specific to individual documents, editable by users with write access |
| Field Types | Text, number, date, dropdown, multi-select, checkbox, URL, user picker, file link |
| Views | Predefined combinations of columns, filters, and sort order; configured per Team folder by admins |
| Column Config | Controls which metadata fields appear as columns in the file list and in what order |
Next Steps¶
- User Guide - Working with metadata daily
- Admin Guide - Configuring MetaVox
- API Reference - Programmatic access
- Roadmap
See Also¶
- User Overview - Getting started as a user
- Installation Guide - Setup and configuration
- Architecture Overview - System design and internals