Documentation
Learn how to use DocVault.
This documentation covers the free plugin. Where Pro adds extra capability, you’ll see a short note linking to the relevant Pro documentation.
Getting Started
Installation
- Download from WordPress.org or search “DocVault” in Plugins → Add New
- Activate the plugin
- Go to Documents in the admin sidebar
- Start uploading documents
Requirements
- WordPress 5.8 or higher
- PHP 7.4 or higher
Supported File Types
PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODS, ODP, RTF, CSV, TXT
Uploading Documents
Adding a New Document
- Go to Documents → Add New
- Drag and drop a file onto the upload area, or click to browse
- The document title is auto-generated from the filename (you can edit it)
- Optionally add version notes to describe this upload
- Assign categories if desired
- Click Publish
Uploading a New Version
To add a new version of an existing document:
- Go to Documents and click on the document
- In the Upload New Version area, drag and drop the updated file
- Add version notes (optional but recommended)
- Click Update
The free version keeps up to 5 versions per document. When you upload a 6th version, the oldest is automatically removed.
Version History
Every document maintains a version history. From the Edit Document screen, you can:
- Download any previous version
- Restore a previous version (makes it the current version)
- Delete a version from history

The Version History metabox shows:
- Version number
- Filename
- File size
- Upload date
- Who uploaded it
- Version notes
Pro: Unlimited version history with no automatic deletion. See Pro version history.
Frontend Display
Document Block (Gutenberg)
Add a single document with download button using the block editor:
- In the block editor, click + to add a block
- Search for “DocVault”
- Select a document from the dropdown
- Configure display options in the sidebar
Block options:
- Show/hide file type icon
- Show/hide file info (type, size)
- Layout: Full or Minimal
Pro: Adds Card and Button block layouts. See Pro block layout options.
Document Table Shortcode
Display a searchable, sortable table of documents:
[trdv_list]
Parameters
| Parameter | Description | Default |
|---|---|---|
category | Filter by category slug | (all) |
type | Filter by file type (pdf, docx, etc.) | (all) |
orderby | Sort by: date, title, size | date |
order | ASC or DESC | DESC |
show_search | Show search box | true |
show_download | Show download button | true |
columns | Columns to show: title,type,size,date | title,type,size,date |
per_page | Documents per page | 20 |
Examples
[trdv_list type="pdf" orderby="title" order="ASC"]
[trdv_list category="reports" show_search="false" columns="title,date"]
[trdv_list per_page="10" show_download="true"]
Inline Document Link
Insert a download link within text:
[trdv_link id="123"]Download the report[/trdv_link]
Parameters:
id(required) – The document IDnew_tab– Open in new tab: true/false (default: false)class– Add custom CSS class
If no link text is provided, the document title is used:
[trdv_link id="123"]
Access Control
Go to Documents → Settings to configure access control.
Global Settings (Free)
- Public – Anyone can view and download documents
- Logged-in users only – Only registered users can access documents
Per-Document Override
On each document’s edit screen, you can override the global setting:
- Use global default
- Public (anyone)
- Logged-in users only
Pro: Role-based access control allows you to restrict documents to specific user roles (e.g., only Editors, only Subscribers). See Pro access control.
Download Tracking
Download counts are automatically tracked for all documents. View the count in:
- The Documents list (Downloads column)
- The Download Statistics metabox on each document

Pro: Detailed download analytics including who downloaded, when, and download history over time. See Pro download analytics.
FAQ
Where are files stored?
Files are stored in /wp-content/uploads/trdv-documents/ organized by year and month folders.
Can I change the upload directory?
Files are always stored in /wp-content/uploads/trdv-documents/, but you can choose the folder structure in Documents → Settings:
- Flat – All files in one folder
- By ID – Organised by document ID
- By Date – Organised by year/month
Note: Folder structure must be chosen before uploading files. It cannot be changed after files have been uploaded.
How do I find a document’s ID?
Edit the document and look at the URL. The ID is the number after post=. For example: post.php?post=123&action=edit
Can I use my own categories?
Yes. In Documents → Settings, you can choose to use WordPress’s built-in categories instead of the separate Document Categories taxonomy.
Is the plugin GDPR compliant?
Yes. The plugin integrates with WordPress privacy tools for data export and erasure. Download logs can be deleted via the WordPress personal data tools.
Can I restrict individual documents to specific users?
Free: You can restrict documents to logged-in users only, either globally or per document. But you cannot restrict to specific individual users.
Pro: Role-based access control lets you restrict documents to specific user roles (e.g., only Editors, only Subscribers). For individual user restrictions, you would need to create a custom role or use a membership plugin alongside.
Does the plugin work with multisite?
Yes, the plugin works on individual sites within a WordPress multisite network. Each site has its own documents and settings. However, there is no network-wide activation or shared document library across sites.
What is the maximum file size?
The plugin uses your WordPress/server upload limit. Check your limit in Media → Add New (shown at the bottom). To increase it, adjust upload_max_filesize and post_max_size in your PHP settings or contact your host.
Can I upload multiple documents at once?
The free version uploads one document at a time. Pro includes bulk upload with duplicate detection.
Can I preview or embed PDFs?
The plugin provides download links, not inline previews. For PDF embedding, you would need an additional plugin or use the browser’s built-in PDF viewer by linking directly to the file.
Can I customise the frontend table styling?
Yes. The document table uses CSS classes prefixed with trdv-. Add custom CSS in Appearance → Customise → Additional CSS to override the default styles.
Is the plugin translation ready?
Yes. A translation template (.pot file) is included. Place your translation files in /wp-content/languages/plugins/ using the text domain trilobita-docvault.
What happens when I uninstall the plugin?
Uninstalling removes plugin settings, post meta, and the download log table. Your documents (posts) and uploaded files are not deleted — you can remove these manually if needed. This protects your data from accidental loss.
Need More Advanced Features?
DocVault Pro adds advanced frontend filters, bulk upload, smart similarity detection, role-based access control, audit logs, download analytics, storage tools, and approval workflow.