iCloud Sync
iCloud Sync is optional. It lets STIQRA share supported reading data between your Apple devices when they use the same iCloud account. It is off until you enable it.
Open Settings → Security & Privacy → iCloud Sync to turn it on or off, see its status, or choose Sync Now. Your device needs access to iCloud. Feed updates from publishers and iCloud Sync are separate: syncing does not fetch new articles from websites.
Last successful sync means the app has confirmed a transfer of changes, not just a connection to iCloud. If Sync is On but no transfer has been confirmed yet, it may still be setting up or waiting for changes.
What synchronises
Open What syncs with iCloud in the iCloud Sync settings for the categories supported by your build. STIQRA can sync:
- Websites you follow: a feed is a website's list of new articles. Source addresses, requested-enabled status, and supported source preferences can sync. An over-cap source can remain requested-on but is locked from network refresh until Premium; the commercial lock is not synced as an intentional Off choice.
- Reading activity: whether articles are read, seen, saved, archived, or in History. Limited article details can also sync so saved reading activity remains useful on another device.
- Filters and Track keywords: saved topics you hide and topics you choose to follow. Extra rules received on Free devices remain saved but are locked from filtering/tracking until Premium; iCloud Sync itself remains Free.
- Selected reading preferences: article cutoff and retention choices, language choices, For You topics, keyword-matching scope, and Track matching behaviour.
- Saved reports and transcripts: supported report and transcript text and their related details.
- Publisher audio progress: listening position and played status for supported publisher-provided audio. Audio downloads and playback queues stay on each device.
Some synced article details can contain publisher titles or summaries. They are not limited to read/unread flags. The complete downloaded article body, images, and audio files are not synced as part of those article details.
Open What stays on this device for the other categories, including:
- Passwords, credentials, and other secrets, including older saved credentials that can now only be deleted.
- Downloaded publisher media, generated audio files, and the local playback queue.
- Cached content and temporary download or sync information.
- Appearance, window layout, image-loading choices, device-specific voices, and background-refresh settings.
- Preferences for ChatGPT handoffs and other external integrations.
Login-protected RSS/Atom article lists and article-page text extraction are not supported. Syncing an older setting cannot enable either feature. Newsletter messages are also not a supported sync category. Data left by older app versions or other devices is not necessarily erased just because the current app no longer uses it.
Protection model
STIQRA stores synced data in your private iCloud database, using Apple's CloudKit service and its data protections. Standard iCloud protection encrypts data in transit and at rest; Apple can recover the service keys. With Advanced Data Protection enabled for your iCloud account, eligible protected fields and files receive Apple's end-to-end encryption.
STIQRA does not manage a separate cloud-encryption key, and it cannot confirm from inside the app whether your account has Advanced Data Protection enabled. You can review that account setting in Apple's own settings. See Privacy, security, and data for what can leave the device.
Turning sync on or off
When you first turn on sync, STIQRA checks the iCloud account and any existing STIQRA data there before sending this device's changes. This protects against accidentally replacing an existing cloud copy. Setup and later changes can take time, especially when the network or iCloud service is busy.
- Waiting for iCloud means the app is waiting for the account or service to become available.
- Temporary iCloud delay means iCloud has asked STIQRA to retry later. Leave sync on; you do not need to switch it off and on.
- Restart STIQRA means the app needs to be closed and reopened before sync can be enabled again. It does not mean your cloud copy was deleted.
Changes to saved articles, reading status, filters, and Track keywords should appear when a device receives and processes them, without having to restart the app or manually refresh its publishers. An article may take longer to appear if the receiving device does not yet have enough information to display it.
Turning sync off stops future syncing on this device. Your local data stays here, and STIQRA does not delete the iCloud copy. To remove only that cloud copy while keeping local data, use Delete Cloud Sync Copy and read its confirmation carefully. If iCloud is unavailable after you request deletion, the deletion may remain pending. If local sync records are unreadable when you turn sync off, Settings shows Recovery required rather than claiming that a possibly pending cloud deletion is absent. Your local reading data is kept; the app does not automatically delete or recreate the cloud copy.
Network conditions and VPNs
Some VPNs, network filters, or restricted connections can interfere with iCloud even when the sync switch is on. Check the iCloud status, connection, and account first. STIQRA's VPNs and iCloud sync note links to Apple's guidance. STIQRA cannot tell whether your VPN is active and does not change its network protections to work around a blocked connection.
Account changes
If you switch iCloud accounts, STIQRA shows Account review required rather than automatically mixing the two accounts' data. You can keep sync off and preserve local data, or explicitly choose Use Current iCloud Account With Local Data to begin setup for the current account. Review the choice before continuing: it does not automatically merge two cloud accounts.
In development builds, extra account and CloudKit environment details may be visible for testing. These are diagnostic labels, not passwords or evidence that two different app environments can sync together.
Recovery-required states
If STIQRA cannot safely continue syncing, it may show Recovery required. Keep Local Data & Turn Sync Off is the non-destructive choice for the data stored on this device.
Depending on the problem, Settings may also offer Retry Local Sync Metadata, which checks the local sync records and retries without deleting the iCloud copy, or Reset Cloud From This Device, which deletes the existing STIQRA cloud sync copy and rebuilds it from this device's local data. Reset Cloud From This Device can remove changes that exist only in iCloud or on another device. Use it only when you understand which copy you want to keep. STIQRA does not automatically erase the cloud copy for an ordinary network delay.
Delete From This Device vs Delete Everywhere
Delete From This Device removes STIQRA's local data and disconnects this device from the synced copy. It does not ask iCloud to delete that copy; another device may still have it.
Delete Everywhere removes local data and requests deletion of STIQRA's private iCloud sync copy. If the account or service is unavailable, Cloud Deletion Pending means the cloud deletion has not finished. STIQRA prevents the pending copy from being brought back into the wiped device while that request is unresolved.
Neither action deletes files you exported or shared, copies in other apps, or platform-managed backups. Review the deletion confirmation and make a backup of anything you need to keep.
Sync Activity
Sync Activity shows a short history of uploads, downloads, delays, and resumptions on this device. It shows categories and counts, not article titles, website addresses, passwords, or the contents of your data. This history stays on this device.
Choose Clear to remove only Sync Activity entries. It does not erase reading data, turn sync off, or restart syncing.
