Skip to main content

Syncing Behavior

This plugin performs one-way sync from Logseq to Anki.

One-Way Sync Explained

The sync process is unidirectional - it only transfers data from Logseq to Anki, never the other way around.

Logseq → Anki (✓ Supported)
Anki → Logseq (✗ Not Supported)

This means:

  • Changes made in Logseq will be reflected in Anki after syncing
  • Changes made directly in Anki (with some exceptions) will be overwritten on the next sync
  • Review history, and scheduling data in Anki is preserved

What Gets Overwritten

Always Overwritten (Cannot be Disabled)

These fields are always updated from Logseq during sync:

FieldDescription
TemplateThe card template (HTML/CSS/JS structure)
ContentThe main card content (Text field)
DeckWhich deck the card belongs to
TagsAll card tags

Conditionally Overwritten (Configurable)

These can be controlled via the "Overwrite following on every sync" setting in the plugin settings:

FieldDefaultDescription
SuspendedEnabledWhether the card is suspended/unsuspended. Controlled by the suspend-anki-card property in Logseq.

To change this behavior:

  1. Open Logseq Settings
  2. Go to the plugin settings for "Logseq Anki Sync"
  3. Find "Overwrite following on every sync"
  4. Check/uncheck "Suspended" as needed

Never Overwritten

These fields are never touched by the plugin during sync:

FieldDescription
User Controlled Field (Front)Custom content only on the front side
User Controlled Field (Back)Custom content only on the back side
User Controlled Field (Both)Custom content on both sides
CSS Section of TemplateSee Custom CSS for details
Leech TagAnki's leech tag (e.g., "leech" on a card) is never overwritten
Review HistoryYour review history and scheduling data

User Controlled Fields

User Controlled Fields allow you to add custom content directly to your Anki cards that will not be overwritten during sync. This is useful for adding personal notes, mnemonics, or additional context that you want to maintain separately in anki.

Available Fields

Field NameDisplay Location
User Controlled Field (Front)Only on the front side of cards
User Controlled Field (Back)Only on the back side of cards
User Controlled Field (Both)On both front and back sides of cards