Configuration
Personalize your Bookmark UniSync settings to optimize your sync experience
🚀 Configuration Feature Overview
Configuration features allow you to adjust extension behavior according to personal needs:
- 🔄 Sync Mode - Choose real-time push or manual sync
- ⚡ Real-Time Push - Changes are pushed to your other devices as they happen
- 🛠️ Developer Mode - View detailed upload history records
📍 Feature Location
- Click the Bookmark UniSync extension icon in the upper right corner of the browser
- Find the "Configuration" option in the main interface
- Click to enter the configuration page
📋 Detailed Configuration Options
🔄 Sync Mode Settings
There are exactly two sync modes: manual sync and real-time push. There is no timed or scheduled sync mode — the old "sync every N minutes" setting was removed when real-time push replaced polling, so nothing syncs on a timer in the background.
Manual sync is free. Real-time push is a paid feature with a free trial, so you can try the "changes sync as they happen" experience before deciding. See the price page for current plans.
Manual Sync Mode
| Feature | Description | Applicable Scenarios |
|---|---|---|
| 🎯 Precise Control | Manually trigger sync only when needed | Unstable network or limited data traffic |
| 💾 Resource Saving | Reduce unnecessary network requests | Mobile devices or low-performance computers |
| 🔒 Data Security | Avoid accidental sync | When handling sensitive bookmark data |
Real-Time Push Mode
| Feature | Description | Applicable Scenarios |
|---|---|---|
| ⚡ Instant Delivery | A bookmark change on one device is pushed to the others immediately | Frequent switching between multiple devices |
| 🔄 No Manual Intervention | Nothing to click while both devices are online and signed in | Daily bookmark management |
| 📊 Data Integrity | Every change is recorded as a history version | Important bookmark data protection |
| 📡 Persistent Connection | A WebSocket connection stays open with automatic reconnect | Multi-device data consistency |
⚡ How Real-Time Push Works
🔄 Push Mechanism
Once real-time push is active, the extension keeps a persistent connection to the service:
- 📡 Persistent Connection - The extension stays connected while the browser is running
- ⚡ Server Push - When one device uploads a change, the service pushes it to the other online devices
- 🔄 Auto Reconnect - The connection is re-established automatically after a network drop
- 📊 Status Visibility - Sync status and progress are shown in the interface
⚠️ When a Device Is Offline
Real-time push only reaches devices that are connected. If a device is closed, offline, or the extension is not running, it is not on the push channel:
| Status | Behavior | User Action |
|---|---|---|
| 🟢 Online | Changes arrive as they happen | Nothing needed |
| 🔴 Offline / browser closed | Nothing is pulled in the background — there is no timed sync | Manual sync once the device is back |
| 🔄 Reconnecting | The connection is re-established automatically | Wait; sync manually if it seems stuck |
| ❌ Push Failed | An error is shown | Check the network or trigger a manual sync |
- Online both sides - you never touch the sync button
- Device was off for a while - click sync once when you come back; nothing compensates for the gap automatically
- Poor network - switch to manual sync to avoid failed push attempts
🛠️ Developer Mode
Function Description
Developer mode is mainly used for debugging and monitoring sync behavior:
| Function | Role | Target Users |
|---|---|---|
| 📊 History Record Display - Display detailed upload history | Developers and advanced users | |
| 🔍 Upload Status Monitoring - Check whether uploads work normally | Troubleshooting | |
| 📱 Local Data Viewing - View local upload records (not sent to server) | Performance analysis |
Operations Recorded in Developer Mode
The following operations are recorded (visible in developer mode):
| Operation Type | Trigger Condition |
|---|---|
| 📝 Modify Bookmark | Edit title, URL or description |
| 🔄 Rename Bookmark | Change bookmark name |
| 📁 Move Bookmark | Adjust bookmark position or belonging folder |
| ➕ Add Bookmark | Add new bookmark or folder |
| 🗑️ Delete Bookmark | Delete bookmark or folder |
Enable Developer Mode
-
📍 Enter Configuration Page
- Select "Configuration" option
-
🛠️ Enable Developer Mode
- Find "Developer Mode" option
- Check enable switch
-
📊 View History Records
- Return to main interface to view detailed upload history
- Records include timestamps and operation types
-
🔍 Analyze Sync Behavior
- Check if uploads trigger normally
- Verify that real-time push delivers changes to other devices
History records in developer mode are only stored locally and will not be uploaded to server, mainly for debugging purposes.
🔄 Configuration Switching Guide
Switching from Real-Time Push to Manual Sync
- ⚙️ Enter Configuration Page
- 🔄 Select Manual Sync Mode
- ✅ Confirm Settings
- 📤 Manual Sync Test - Click sync button to verify functionality
Switching from Manual Sync to Real-Time Push
- ⚙️ Enter Configuration Page
- 🔄 Select Real-Time Push Mode
- ✅ Save Settings
- 📊 Verify Real-Time Push - Change a bookmark on one device and confirm it appears on another
❓ Frequently Asked Questions
| Question | Solution |
|---|---|
| 🔄 Changes Not Appearing on Other Devices | Confirm both devices are online, signed in to the same account, and running the extension |
| 📴 Device Was Offline for a While | There is no timed sync, so click sync once on the device that was offline |
| 🛠️ Developer Mode No Data | Execute bookmark operations (modify, move, etc.) to trigger a record |
| 📱 Multi-device Sync Inconsistency | Check login status and sync mode on each device |
| 💾 Manual Sync Button Unresponsive | Refresh page or restart browser extension |
| 🔄 Data Loss After Mode Switch | Mode switching does not affect existing data, only changes sync method |
| 📡 Push Connection Keeps Reconnecting | Check network stability; switch to manual sync if the network is unreliable |
🎉 Configuration Best Practices
📊 Daily Usage Recommendations
- 🏠 Home/Office Network: Leave real-time push on, so changes sync as they happen
- 📱 Mobile Devices: Use manual sync to save data traffic
- 🔄 Multi-device Collaboration: Keep both devices online and signed in
- 🛠️ Troubleshooting: Temporarily enable developer mode to view detailed records
🔒 Data Security Recommendations
- 📋 Before Important Changes: Manually sync once to ensure data security
- 🔄 When Network is Unstable: Switch to manual sync mode
- 💾 Regular Checks: Enable developer mode to verify sync works normally
- 📱 When Changing Devices: Confirm configuration settings match original device
🔗 Related Links
- 📖 Installation Guide - How to install extension
- 📝 Registration Guide - Create account
- 📤 Upload Function - Manual bookmark upload
- 📚 Sync History - Manage historical versions
- 📧 Contact Us - Get technical support
Reasonable configuration of sync settings can significantly improve user experience. Recommend choosing the most suitable configuration scheme according to your network environment and usage habits.