Normal Shares
Standard shares with full viewing and downloading capabilities for shared files and directories.
What Normal Shares Include
Normal shares provide:
- File and directory browsing - Navigate through folders
- File viewing in browser - Preview files without downloading
- File downloading - Download individual files or entire folders
- Thumbnail previews - Image thumbnails for quick identification
- Quick download buttons - One-click download actions (optional)
- OnlyOffice integration - View and edit office documents (optional)
How to Create a Normal Share
- Navigate to the file or directory you want to share
- Click the Share button in the actions menu
- Ensure Share Type is set to
Normal
(default) - Configure your desired options
- Click Share to generate the link
- Copy and share the generated URL
Normal Share-Specific Options
These options only apply to normal shares and appear in the share creation dialog:
File Viewer Control
Prevent viewing files in the browser - users can only download files.
Use case: Force downloads for security or when you don’t want files viewed in-browser.
Quick Download
Display quick download buttons for files in the share.
Use case: Make it easier for users to download files with a prominent button.
Download Limits
The maximum number of times any file/folder from the share can be downloaded. Leave empty for unlimited.
When enabled, the downloads limit will be applied to each user. Anonymous users will not be able to download any files from this share.
Global limit: All users share the same download counter.
Per-user limit: Each authenticated user gets their own counter. Anonymous users are blocked.
Bandwidth Control
The maximum download bandwidth in kbps. Leave empty for unlimited.
Example: Enter 1024
for 1 MB/s (1024 kbps) bandwidth limit.
View Mode
Set the default view mode for anonymous users viewing this share. Logged-in users can still change their view preference.
View modes:
- Normal - Standard grid with icons and names
- List - Detailed list with file information
- Compact - Dense grid for many files
- Gallery - Large thumbnails, perfect for images
Interface Customization
Preview thumbnails will not be shown in the share.
Disable the sidebar on the shared page.
Use case: Create a cleaner, more focused interface for file access.
Media Features
Extract embedded subtitles from media files on load -- this can be slow for large files.
Extracting subtitles is IO-intensive and can take 10-30 seconds for large video files.
OnlyOffice Integration
If OnlyOffice is configured on your FileBrowser instance:
Allow viewing office files using OnlyOffice in this share.
Allow editing of office files using OnlyOffice in this share.
Supported formats: DOCX, XLSX, PPTX, and more office document types.
Configuration Examples
Download-Only Share
Force users to download files instead of viewing them in the browser:
Download-only configuration
- ☑ Disable File Viewer
- ☑ Show Quick Download
Limited Downloads (Global Counter)
Limit total downloads across all users:
Global download limit
Limited Downloads (Per User)
Each authenticated user gets their own download counter:
Per-user download limit
Bandwidth Limited Share
Limit download bandwidth to prevent server overload:
Bandwidth control
OnlyOffice Enabled Share
Allow viewing and editing of office documents:
Office document collaboration
- ☑ Enable OnlyOffice viewer
- ☑ Enable OnlyOffice editing
Image Gallery
Perfect for sharing photo collections:
Image gallery configuration
- ☐ Disable Thumbnails (keep enabled)
Secure Client Delivery
Password-protected with per-user download tracking:
Secure client file delivery
- ☑ Disable File Viewer
- ☑ Show Quick Download
Public Access URLs
Share Link
Shared links are accessible via:
https://your-domain.com/public/share/{hash}
Where {hash}
is the unique identifier generated for the share.
Direct Download Links
Download specific files using the /public/dl
endpoint:
Single file:
/public/dl/{hash}?files=document.pdf
Multiple files (use ||
separator):
/public/dl/{hash}?files=file1.txt||folder/file2.pdf||images/photo.jpg
Password-Protected Downloads
For password-protected shares, include the token parameter:
/public/dl/{hash}?token={authentication-token}&files=file.pdf
The token is obtained after entering the correct password on the share page.
Common Use Cases
Standard File Sharing
Configuration: Default settings with optional password protection
Best for: General purpose file sharing
Client Deliverables
Configuration: Password protection + download limits + expiration
Best for: Professional client file delivery with accountability
Public Resources
Configuration: No password, permanent share, gallery/list view
Best for: Public-facing file repositories
Time-Limited Access
Configuration: Set expiration time (hours/days/weeks)
Best for: Temporary file access, event materials
Branded Corporate Shares
Configuration: Custom theme color, logo banner, favicon
Best for: Client-facing shares requiring brand consistency
Next Steps
- Upload shares - Create upload-only shares
- Common options - Options available to all share types
- Customization - Brand your shares with colors and logos