Cloud Storage
Save, manage, and share your diagrams in the cloud
Cloud Storage allows you to save your diagrams to ToDiagram's secure cloud, access them from any device, and collaborate with your team.
Quick Start
Sign In
Click the Cloud button in the top toolbar or use the save icon in the bottom bar.
If not already signed in, you'll be prompted to sign in with:
- GitHub
Save Your First Document
- Create or edit a diagram
- Click Cloud or the save icon
- Your document is automatically saved
- A checkmark appears when saved successfully
Access Saved Documents
- Click Cloud to open your documents library
- View all saved diagrams
- Click any document to open it
- Use search to find specific files
Features
Document Management
Create Documents:
- New documents start as "Untitled"
- Auto-save creates document in cloud
- Rename anytime from the cloud modal
Update Documents:
- Changes are tracked automatically
- "Save Changes" button appears when edited
- Click save to update cloud version
- Last updated time shown in document list
Delete Documents:
- Open cloud modal
- Click ⋮ (three dots) next to document
- Select "Delete"
- Confirm deletion
Document Visibility
Control who can access your diagrams:
| Visibility | Description | Available To |
|---|---|---|
| Private | Only you can view | All users |
| Team | Team members can view | Team plans only |
| Public | Anyone with link can view | All users |
Private documents are default. Change visibility from the document menu (⋮).
Sharing Documents
Share via Link:
Set Visibility
- Open cloud modal
- Click ⋮ next to your document
- Select "Change Visibility"
- Choose Public or Team
Copy Link
- Click the link icon 🔗 next to the document
- Link is copied to clipboard
- Share link with collaborators
Recipients Access
- Public links: Anyone can view
- Team links: Only team members can view
- Viewers can explore, download, or create their own copy
Storage Limits
| Plan | Document Limit | File Size Limit |
|---|---|---|
| Free | 0 documents | 5 MB per file |
| Pro | 200 documents | 5 MB per file |
| Team | 200 documents per person | 5 MB per file |
Files exceeding 5 MB cannot be saved to cloud. Consider splitting large datasets or compressing your data.
Cloud Modal
All Documents Tab
View and manage all your personal documents:
Document List Shows:
- Document name
- Format badge (JSON, YAML, CSV, XML, Mermaid, Custom)
- Visibility icon (🔒 Private, 👥 Team, 🌐 Public)
- Last updated time
- Actions menu (⋮)
Filter Documents:
- Search by name (search bar at top)
- Filter by format (chip buttons)
- Shows count: "X documents" and quota usage
Actions per Document:
- Open: Click document name
- Rename: ⋮ → Edit Name
- Download: ⋮ → Download
- Copy Link: 🔗 icon (public/team only)
- Change Visibility: ⋮ → Change Visibility
- Delete: ⋮ → Delete
Team Documents Tab
Team tab requires Team plan subscription. Upgrade to share documents with your team.
View documents shared by team members:
- Shows all documents with "Team" visibility
- Filter and search same as All Documents
- Cannot delete others' documents
- Can open and create your own copy
Auto-Save Behavior
When Documents Save
Documents save to cloud when you click:
- Cloud button in top toolbar
- Save icon in bottom bar
- "Save Changes" button (when document has changes)
Save Indicators
| Indicator | Meaning |
|---|---|
| ✓ Checkmark | Saved successfully |
| "Save Changes" | Unsaved changes exist |
| Time stamp | Last saved time (e.g., "2 minutes ago") |
| "Create Document" | New document, not yet saved |
Unsaved Changes
The editor tracks changes:
- Edit content → "Save Changes" appears
- Close tab → Prompt to save (if unsaved)
- Refresh page → Unsaved changes preserved in browser
Unsaved documents exist only in your browser. Save to cloud to access from other devices or prevent data loss.
Document Permissions
Owner Permissions
Document owners can:
- ✅ View and edit
- ✅ Rename
- ✅ Change visibility
- ✅ Delete
- ✅ Download
- ✅ Share link
Viewer Permissions
Public/team link viewers can:
- ✅ View diagram
- ✅ Explore and navigate
- ✅ Download diagram
- ✅ Create their own copy
- ❌ Cannot edit original
- ❌ Cannot delete original
URL Parameters
Document ID in URL
When you open a cloud document, the URL updates:
https://todiagram.com/editor?doc=<document-id>Benefits:
- Bookmark specific documents
- Share direct links
- Browser back/forward navigation works
- Refresh page reopens same document
Opening Documents
Via Cloud Modal:
- Click Cloud → Select document
- URL updates automatically
Via Direct Link:
- Paste URL with
?doc=<id> - Document loads automatically
Troubleshooting
Related Features
- Getting Started - Initial setup guide
- Interface - Editor overview
- API - Programmatic document access
- Teams - Team collaboration features
Pro Tip: Use descriptive names for documents to easily find them later. Format is automatically detected, so focus on meaningful names like "User API Schema" or "Production Config".