Hello Shopify Developers!
Welcome to the Online Store and Theme Development board! This space is dedicated to troubleshooting issues and providing support for developers working with Liquid and Shopify themes… Whether you’re a developer just getting started building on Shopify, or need help troubleshooting a specific issue, this board is here to support you.
Board Overview
This board covers the following topics:
- Theme Troubleshooting: Solutions and support for issues and errors you might encounter while building and customizing Shopify themes.
- Liquid: General guidance on how to work with the Liquid objects, tags, and filters.
- Theme Editor: Issues when integrating your app or theme with the Shopify admin theme editor.
- Theme tooling: Guidance when working with theme commands on the Shopify CLI or other first-party theme development tools.
Tags
To keep our discussions organized, we use the following tags on this board:
- theme_troubleshooting: Use this tag for any issues or bugs/troubleshooting.
- liquid: Use this tag for questions and discussions about developing with liquid.
- theme-editor: Use this tag to flag issues you’re having integrating with the Shopify theme editor
- performance: Use this tag for topics related to storefront performance
Helpful resources:
You can find more resources to help you learn about GraphQL and Shopify in the links below:
- Liquid API reference documentation
- Shopify themes overview
- Shopify Theme architecture
- Troubleshooting theme errors
- Tools for building Shopify themes
- Integrating apps into themes
- Overview of the Shopify Theme Store
- Metafields and Metaobjects
- Dawn Reference Theme GitHub Repo
Frequently Asked Questions
-
What is Liquid?
Liquid is a template language created by Shopify and is used to dynamically output objects and their properties. For example, you can create a product template that hosts all of your standard product attributes, such as the product image, title, and price. That template can then dynamically render those attributes with the appropriate content, depending on the current product being viewed. -
What are some common issues when working with Shopify themes and Liquid, and how do I troubleshoot them?
- Syntax Errors: Ensure your objects, tags and JSON settings are correctly structured with Theme Check.
- Environmental Inconsistencies: Verify that you’ve configured your local development environment to be connected with your connected Shopify store or GitHub repository. This ensures that changes sync correctly and you’re working with the latest version of your theme.
- Performance Degradation: In our documentation we describe best practices for performance, including optimizing images using appropriate formats and compression, minifying CSS and JavaScript files, and limiting the use of heavy Liquid operations within loops.
-
I have a question about Theme App Extensions, where should I ask about this?
For queries related to Theme App Extensions, please ask in the Extensions board, and use thetheme-app-extensions
tag. -
Changes made to the theme aren’t reflecting on the storefront immediately due to caching. What should I do?
Clear your browser cache or use an incognito window to test changes. Append a version query string to asset URLs during development (eg:{{ 'style.css' | asset_url }}?v=123
). -
An app is adding code to a theme which conflicts with my Liquid files or causes layout issues. What should I do?
Review the app’s documentation for integration guidelines, or contact the app developer. To prevent issues where apps are conflicting with themes, use apps that leverage theme app extensions when possible to minimize direct code injections. -
I have feedback related to a developer/API doc. Where/how do I submit feedback or request changes/updates?
At the bottom of each developer doc, you will find a feedback prompt and selecting “No” will expand a feedback prompt, where you can provide any feedback or update requests related to the page you are viewing. We encourage you to use these prompts, as we are constantly working to improve the quality and depth of our developer documentation.
Community Guidelines
To maintain a helpful and respectful community, please follow the Shopify Developer Forums Code of Conduct.
Ensure posts are opened in the correct category and ensure you apply the most accurate tag that relates to your question. When posting API questions, always include:
- The full API query or mutation with personally identifiable information (PII) removed
- Detailed replication steps and time when issue appeared
- The API version and any error messages that are appearing
- Relevant screenshots or videos to illustrate the issue
This detailed approach helps peers and internal staff provide effective solutions quickly.
Thank you for being a part of our community! We look forward to your contributions and discussions.
Happy Coding!