Brickspace Lab
Contact usContact ShopifyTry a theme
Paper
Paper
  • Paper documentation
  • Getting started
    • Theme basics
    • Theme settings
      • Colors
      • Typography
      • Borders
      • Quick Add
  • Guides
    • Products
      • Product badges
      • Product subtitles
      • Variant swatches
      • Fixed buy buttons
      • Replacing “Add to cart”
      • Dynamic variant images
      • Variant filtering
      • Disabling Quick add
      • Customizing Filters
      • Gift cards
      • Quantity picker
      • Subscription options
      • Sibling products
      • Bundled products
      • Custom fields
      • Content drawers
  • Collections
    • Adding Tag Filtering
    • Adding Nested Menu
    • Collection Blocks
  • Sitewide
    • Using device specific visibility
    • Dynamic discount popups
    • Creating a Mapbox API key
    • Designing your menu
    • Migrating custom changes
    • Blog template
    • Search results
  • Sections
  • Sitewide
    • Header
    • Cart drawer
    • Custom liquid
  • Navigation
    • Navigation slider
  • Content and Media
    • Slideshow
    • Collage
    • Video
    • Alternative banner
    • Banner
    • Collapsible content
    • Blog posts grid
    • Icon grid
    • Discount banner
    • Rich text
    • Logo list
    • Slider
    • Testimonials
    • Countdown
    • Image comparison
    • Image hotspot
  • Products and Collections
    • Featured product
    • Featured collection grid
    • Featured collection slider
    • Collection list grid
    • Alternative collection grid
    • Comparison table
    • Recently viewed
    • Collection list slider
  • Forms
    • Email sign-up
    • Contact form
    • Store locator
  • General
    • Changelog
      • v8.0.2
      • v8.0.1
      • v8.0.0
      • v7.6.2
      • v7.6.1
      • v7.6.0
      • v7.5.0
      • v7.4.0
      • v7.3.0
      • v7.2.1
      • v7.2.0
      • v7.1.2
      • v7.1.1
      • v7.1.0
      • v7.0.0
      • v6.2.0
      • v6.1.7
      • v6.1.6
      • v6.1.5
      • v6.1.4
      • v6.1.3
      • v6.1.2
      • v6.1.1
      • v6.1.0
      • v6.0.1
      • v6.0.0
      • v5.2.0
      • v5.1.0
      • v5.0.1
      • v5.0.0
      • v4.1.1
      • v4.1.0
      • v4.0.0
      • v3.0.2
      • v3.0.1
      • v3.0.0
      • v2.0.0
      • v1.2.2
      • v1.2.1
      • v1.2.0
      • v1.0.0
    • Known issues and troubleshooting
      • v8.0.1
    • Cloning a demo theme
      • Poster
      • Parts
      • Pastel
      • Page 3
      • Page 4
Powered by GitBook
LogoLogo

Try a theme

  • Paper
  • Space
  • Keystone

Resources

  • Get theme support
  • Services
  • Contact
On this page
  • Merging custom changes in Shopify themes - challenges and best practices
  • Challenges in merging custom changes
  • Best practices for managing custom changes

Was this helpful?

Edit on GitHub
  1. Sitewide

Migrating custom changes

Merging custom changes in Shopify themes - challenges and best practices

When working with Shopify themes, updating to a new version can introduce challenges when customizations have been made. Since Shopify does not provide a built-in way to merge custom changes automatically, you must manually merge these changes. This document outlines the key challenges and best practices for managing and transferring custom changes during theme updates.

Challenges in merging custom changes

1. Manual transfer required

  • Custom code changes (HTML, CSS, JavaScript, Liquid) must be manually identified and reapplied to the updated theme.

  • Shopify does not support automatic merging of theme modifications.

2. Difficulty tracking changes

  • Without proper documentation, locating custom changes can be time-consuming.

  • Developers may not always know where modifications were made, leading to potential loss of functionality.

3. Theme updates may overwrite customizations

  • If an update is applied without first backing up custom changes, they may be lost.

  • Some theme settings may reset, requiring reconfiguration.

4. No control over data transfer (Shopify limitation)

  • As theme developers, we cannot control how Shopify handles theme updates.

  • The platform does not provide tools for selective merging of custom code.


Best practices for managing custom changes

1. Document all customizations

  • Maintain a detailed log of all modifications, including:

    • Modified files (e.g., theme.liquid, product-template.liquid, custom.css).

    • Specific code snippets added or altered.

    • Any third-party apps or scripts integrated.

2. Use a version control system (Git)

  • Track changes using Git to easily compare old and new versions.

  • Create branches for custom work to avoid conflicts during updates.

3. Test updates in a development environment first

  • Duplicate the live theme and apply updates in a development/staging environment.

  • Verify that custom changes are preserved before pushing to production.

4. Consider not updating if unnecessary

  • If the current theme works as intended, updates may not be required.

  • Weigh the benefits of new features against the effort of reapplying customizations.

5. Work closely with developers

  • Ensure developers are aware of all custom changes before an update.

  • Provide them with documentation to streamline the transfer process.

Last updated 15 days ago

Was this helpful?