Syncing Content from Craft
Learn how to keep your Cravo site in sync with your Craft.do documents.
How Syncing Works
Cravo reads content from your Craft.do document through the API. When you make changes in Craft, those changes need to be synced to update your live website.
Sync Process:
1Craft.do Document → API Fetch → Cravo Processing → Live Website Update
📸 PLACEHOLDER: Diagram
Flowchart showing: Craft Document → (API) → Cravo Server → (Processing) → Live Site. Use arrows and icons for each step.
Manual Sync
The most common way to sync content is manually from your dashboard.
How to Sync
- Open your site in the Cravo dashboard
- Click the Sync button in the header bar (🔄 icon)
- Wait for the sync to complete
- Your live site is now updated
📸 PLACEHOLDER: Screenshot
Dashboard header showing the Sync button location with a tooltip or highlight
🎬 PLACEHOLDER: Video (10 seconds)
Click Sync button → Status changes to "Syncing..." → Toast appears "Sync complete" → Preview updates
Understanding Sync Status
Your site displays different status indicators:
| Status | Icon | Meaning |
|---|---|---|
| Ready | ✅ | Site is up-to-date and live |
| Syncing | 🔄 | Content is being fetched from Craft |
| Pending | 🟡 | Changes detected, sync needed |
| Error | ❌ | Sync failed, action required |
📸 PLACEHOLDER: Screenshot
Site card showing each status type (can be a composite image showing all 4 states)
What Gets Synced
When you trigger a sync, Cravo fetches:
✅ Synced Content
- Page titles and content
- Text formatting (bold, italic, headings)
- Images and media
- Code blocks
- Lists (bullet, numbered, todo, toggle)
- Tables
- Callouts and quotes
- Links (internal and external)
- Page hierarchy and structure
⚠️ Partial Support
- Collections (basic rendering)
- Drawings (exported as images)
- Embeds (limited support)
❌ Not Synced
- Comments and mentions
- Real-time collaboration cursors
- Document history/versions
Sync Timing
When to Sync
- After making content changes in Craft
- After reorganizing your page structure
- After adding or removing pages
- Before important presentations or launches
How Long Does It Take?
| Document Size | Typical Sync Time |
|---|---|
| Small (< 20 pages) | 5-15 seconds |
| Medium (20-50 pages) | 15-45 seconds |
| Large (50+ pages) | 45-90 seconds |
💡 Tip: Sync time depends on the number of pages, images, and your internet connection.
Automatic Sync (Coming Soon)
We're working on automatic sync features:
- Webhook-based sync – Instant updates when you publish in Craft
- Scheduled sync – Daily automatic refresh
- Smart sync – Only fetch changed pages
📸 PLACEHOLDER: UI Mockup
Future Settings panel showing "Auto-sync" toggle and schedule options (can be a greyed-out preview)
Sync Best Practices
Sync Before Major Updates
Always sync before sharing your site link or presenting to clients.
Check Sync Status
Wait for the green "Ready" status before checking your live site.
Use Preview First
The preview panel shows synced content – verify there before going live.
Sync After Bulk Changes
If you've made many changes in Craft, do a single sync after completing all edits.
Troubleshooting Sync Issues
Sync Stuck at "Syncing..."
- Wait up to 2 minutes for large documents
- Try refreshing the page
- Check your internet connection
"API Error" During Sync
- Your Craft API key may have expired
- Go to Craft → Share → Re-enable API Access
- Copy the new credentials to Cravo Settings
Content Not Updating
- Clear your browser cache
- Hard refresh (Cmd/Ctrl + Shift + R)
- Try syncing again
Specific Page Not Appearing
- Ensure the page is not in Trash in Craft
- Check if the page is properly nested in your document
- Verify the page has content (empty pages may be skipped)
📸 PLACEHOLDER: Screenshot
Settings panel showing where to update API credentials if they expire
Viewing Sync History
In your site settings, you can view recent sync activities:
- Last sync time – When the most recent sync completed
- Sync duration – How long the sync took
- Pages synced – Number of pages updated
📸 PLACEHOLDER: Screenshot
Settings page showing sync history/log section
Related Guides
- Troubleshooting Sync Issues – In-depth problem solving
- Working with Craft Blocks – Supported block types
- Understanding the Dashboard – Dashboard overview
