Custom Theme Deployment

  • Updated

This page is intended for Shopify theme developers.

If your store has a custom-developed Shopify theme deployment process, there are a few things to be aware of when integrating with Replo.

Replo Templates

Replo creates Shopify pages and generates the page's contents using templates. This is also the case for Sections and Product Templates

Any template created by Replo will be prefixed with replo, e.g. templates/ or sections/replo-my-section.liquid.

If your theme uses a custom deployment process, we recommend downloading the current theme and preserving content with keys containing replo before pushing changes.

Replo will automatically re-save the necessary assets if needed when it detects a theme publish using Shopify's theme/publish webhook topic, but the theme/publish webhook topic is not triggered in many cases (for example, when using shopify theme push). Integrating the Replo-managed assets into your deployment pipeline is the best way to ensure there's no time where a template for a Replo page is not available. For example, if your theme deployment process automatically updates the current theme without publishing a new copy, Replo will not be able to detect that the theme has been changed, and the Replo templates may not be there unless your deployment process preserves them.

For more information on the automatic re-saving of assets, see Switching Shopify Themes.

Theme Uploads in Replo

Replo allows users to upload images and videos to the current theme. If your store has a custom theme deployment process, it might be the case that these assets may sometimes get overwritten. To integrate seamlessly with Replo, take care to preserve unknown asset files during your theme deployment.

If you have custom requirements about the ability to upload assets, please reach out at

Was this article helpful?