Why is offline mode read-only?
Understand why Yuhimo lets you read cached content offline but does not allow full editing while offline.
Troubleshooting · Updated 2026-08-27
Yuhimo’s offline mode is designed for reading cached content, not full offline editing.
Offline mode is read-only. Cached content may be available for viewing, but creating pages, editing notes, recording review grades, or changing learning state requires an internet connection.
Reconnect to make changes. Read-only offline mode helps protect data consistency.
What read-only offline mode means
You may be able to open and read content that was cached before you went offline.
Which pages are available depends on what Yuhimo has stored locally in your browser. Do not expect every page to be available offline.
For the full offline overview, see Offline mode.
Why editing is disabled offline
Offline mode shows a local read-only snapshot. Live workspace data and learning state live on Yuhimo’s servers while you are online.
Offline edits could conflict with changes made on another device, another browser, or after a page was deleted or moved. Merging rich notes, page trees, questions, and learning state is complex. Failed sync could cause data loss or duplicated work.
Read-only offline mode is safer than queuing offline edits that cannot be reliably reconciled with server data.
Stale cache and reconnecting
Cached content may be outdated until Yuhimo reconnects and refreshes the local snapshot.
If you edited a page elsewhere, trashed a note, or graded on another device, the offline copy may not match until refresh completes. A page permanently deleted online may still appear in an old cached copy until you refresh the cache or clear local data.
See Offline mode for cache limits, snapshots, and reconnect behavior.
Why learning sessions are not available offline
Learning and review sessions change live scheduling state. They need current due dates, session rules, and server-side learning data.
Offline mode only shows a cached read-only snapshot. Starting a session or submitting grades offline could disagree with changes made elsewhere or with pages already reviewed today.
You may read cached pages and questions offline, but you cannot run a session that records grades until you reconnect. See How reviews work.
Why review grading is not available offline
Review grades affect scheduling. A grade updates learning state, due date, and FSRS-light values such as stability, difficulty, and retrievability.
Offline grading could disagree with server learning state if the same page was graded elsewhere, or if due dates and intervals changed while you were offline. Review-phase calendar-day limits and learning-phase step timing need a live connection to stay consistent.
Yuhimo records review grades when it can safely update learning state online.
See How reviews work, One grade per day, and FSRS-light explained.
Cached content is not a backup
Offline cached content exists for temporary access, not recovery.
Cache may be incomplete, outdated, or cleared by browser or app storage behavior. Backups are for recovery. Exports are for portability.
See Backups and restore behavior, Import / Export, and Where your data is stored.
Offline mode is not export
Offline access lets you read available cached content inside Yuhimo.
Export creates a separate readable copy you can use outside the app. Offline cache is not meant to be a portable file or archive.
See Import / Export and Vendor lock-in.
What you can do while offline
- read cached pages when available
- review existing notes mentally without recording a grade
- check saved explanations and questions if cached
- prepare ideas elsewhere and add them after reconnecting
What you cannot do while offline
- create new pages
- edit page content
- change page hierarchy
- add or edit questions
- turn learning on or off
- record review grades
- update due dates through grading
- import, export, or restore backups
- generate AI questions
- create study material with AI
- sync changes across devices
Why AI features may not work offline
Study material generation and AI question generation depend on online services. When you are offline, do not expect Yuhimo to create an outline, generate pages, save generated material, or generate new questions.
Existing saved questions may be readable if their page is cached. AI does not grade review answers in Yuhimo.
See Create study material with AI, AI question generation and What AI does not do.
What to do when you reconnect
Reopen Yuhimo with a stable internet connection.
Let the app load the latest workspace state. Then edit pages, add questions, turn on learning, or review due pages.
Yuhimo refreshes and reconciles the local snapshot with server data when you are online again. Until that finishes, cached pages may look outdated.
Use Refresh cache in Settings if needed. Do not treat offline cache as the source of truth — the cache is meant for access, not recovery.
Other common issues — offline troubleshooting.
If you need reliable offline study
- export important notes before going offline if you need a separate copy
- keep key takeaways inside pages, not only in external links
- open important pages while online if caching depends on prior access
- do not rely on offline cache as your only copy
- use backups for recovery, not browser cache
Troubleshooting checklist
- Were you online when you last opened the page?
- Was the page cached before going offline?
- Are you trying to edit instead of read?
- Are you trying to record a review grade?
- Are you trying to use AI generation offline?
- Are you expecting cached content to behave like a backup?
- Does the page depend on external links that require internet?
- Did you reconnect before trying to make changes?
FAQ
- Can I edit pages offline?
- No. Offline mode is read-only for cached content.
- Why can’t I grade reviews offline?
- Review grades update scheduling state. Yuhimo needs a reliable connection to apply grades safely.
- Is cached offline content a backup?
- No. Cached content is for access, not recovery. Use backups for recovery.
- Will every page be available offline?
- Not necessarily. Only content available in cache should be expected offline.
- Can I generate AI questions offline?
- No. Study material generation and AI question generation should be treated as online features.
- What should I do if I need to work offline?
- Open important pages while online if caching depends on prior access, export important content if needed, and reconnect before making changes in Yuhimo.
