Comparing Your Edits to the Original

Comparing Your Edits to the Original

When you have forked a theme file (it has a Custom badge), you can compare your version against the original platform version at any time — without affecting your live storefront.

Opening the diff view

1. Open the code editor and click any Custom file.
2. In the file toolbar, click Compare with original.
3. A split-screen view opens. The left pane shows the platform (original) version. The right pane shows your version.
4. Changed lines are highlighted. Unchanged sections are collapsed to save space.
5. Both panes are read-only in diff mode — use it for reference only.
6. Click Close diff to return to the normal editor.

The Upstream updated banner

If Cartly ships an improved version of a section you have forked, an amber banner appears at the top of the editor: This file has been updated upstream.

This means the platform version is newer than the snapshot we recorded when you forked the file. Your custom version is unchanged — the banner is a notification only.

Your options:

• View diff — opens the diff view comparing the new platform version (left) against your current version (right). Use this to decide whether to merge changes manually.
• Sync upstream — replaces your version with the new platform version. Your custom copy is deleted. The file returns to Synced state.

Sync All upstream

If multiple files have upstream updates, a Sync All upstream button appears in the top toolbar. Clicking it syncs all affected files at once — replacing each custom version with the latest platform version. Use with caution: this action cannot be undone.

Should I sync or keep my version?

It depends on what changed:

• If the platform added a bug fix or accessibility improvement and you have not changed those lines, syncing is safe.
• If the platform changed an area you have customized (e.g., the heading markup you restyled), review the diff first and manually merge the relevant lines before syncing.
• When in doubt, use View diff to understand the changes before committing to a sync.