Installation
Manual installation guide for Shopify themes.
This guide will walk you through the process of manually installing a Shopify theme. Follow these steps to set up your theme development environment and deploy your theme to a Shopify store.
Prerequisites
Before installing a Shopify theme manually, ensure you have the following:
- Shopify Store: Access to a Shopify store (development store or live store)
- Theme Files: The theme files you want to install (either downloaded or cloned from a repository)
- Code Editor: A code editor like VS Code, Sublime Text, or similar
- Shopify Admin Access: Admin permissions to upload and manage themes
Important:
Always backup your current theme before installing a new one. This ensures you can restore your store if something goes wrong during installation.
Installation Steps
Step 1: Prepare Theme Files
- Ensure your theme files are in a ZIP format
- The ZIP file should contain the theme directory structure:
theme-name.zip ├── assets/ ├── config/ ├── layout/ ├── locales/ ├── sections/ ├── snippets/ └── templates/
Step 2: Upload to Shopify
- Log into your Shopify admin panel
- Navigate to Online Store > Themes
- Click Upload theme
- Select your theme ZIP file
- Click Upload and wait for the process to complete
Step 3: Preview and Publish
- Once uploaded, click Actions > Preview to test your theme
- If everything looks good, click Actions > Publish to make it live
Post-Installation Steps
1. Configure Theme Settings
- Go to Online Store > Themes
- Click Customize on your newly installed theme
- Configure colors, fonts, layout options, and other settings
- Add your logo, favicon, and other branding elements
2. Set Up Menus
- Navigate to Online Store > Navigation
- Configure your main menu and footer menu
- Link menu items to appropriate pages and collections
3. Configure Pages
- Set up essential pages (About, Contact, Privacy Policy, etc.)
- Configure your homepage layout
- Set up collection and product page templates
4. Test Functionality
- Test the shopping cart and checkout process
- Verify mobile responsiveness
- Check page loading speeds
- Test contact forms and other interactive elements
Troubleshooting
Common Issues
Theme not displaying correctly:
- Clear browser cache and check again
- Verify all required files are uploaded
- Check for JavaScript errors in browser console
Missing images or assets:
- Ensure all asset files are in the correct
assets/folder - Check file paths in template files
- Verify image file formats are supported
Broken layout:
- Check CSS files are properly linked
- Verify template structure matches theme requirements
- Review liquid syntax for errors
Getting Help
If you encounter issues during installation:
- Check the theme documentation
- Review Shopify's theme development documentation
- Contact theme developer support
- Consult Shopify Community forums
Development Store:
Always test new themes on a development store before deploying to a live store with active customers.