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

  1. Ensure your theme files are in a ZIP format
  2. The ZIP file should contain the theme directory structure:
    theme-name.zip
    ├── assets/
    ├── config/
    ├── layout/
    ├── locales/
    ├── sections/
    ├── snippets/
    └── templates/
    

Step 2: Upload to Shopify

  1. Log into your Shopify admin panel
  2. Navigate to Online Store > Themes
  3. Click Upload theme
  4. Select your theme ZIP file
  5. Click Upload and wait for the process to complete

Step 3: Preview and Publish

  1. Once uploaded, click Actions > Preview to test your theme
  2. If everything looks good, click Actions > Publish to make it live

Post-Installation Steps

1. Configure Theme Settings

  1. Go to Online Store > Themes
  2. Click Customize on your newly installed theme
  3. Configure colors, fonts, layout options, and other settings
  4. Add your logo, favicon, and other branding elements

2. Set Up Menus

  1. Navigate to Online Store > Navigation
  2. Configure your main menu and footer menu
  3. Link menu items to appropriate pages and collections

3. Configure Pages

  1. Set up essential pages (About, Contact, Privacy Policy, etc.)
  2. Configure your homepage layout
  3. 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:

  1. Check the theme documentation
  2. Review Shopify's theme development documentation
  3. Contact theme developer support
  4. Consult Shopify Community forums

Development Store:

Always test new themes on a development store before deploying to a live store with active customers.