Installation Guide

Get Wash up and running in minutes. This guide walks you through installing both the Shopify app and WordPress plugin, then connecting them together.

Prerequisites

Before you begin, make sure you have:

  • A Shopify store (any plan)
  • A WordPress site (self-hosted WordPress.org, version 5.0 or higher)
  • Admin access to both platforms

Step 1: Install the Shopify App

  1. Go to the Wash: Blog Manager listing on the Shopify App Store
  2. Click Add app
  3. Review the permissions and click Install app
  4. You'll be redirected to the Wash dashboard in your Shopify admin

Step 2: Install the WordPress Plugin

  1. In your WordPress admin, go to Plugins → Add New
  2. Search for "Wash: Blog Manager"
  3. Click Install Now, then Activate
  4. You'll see a new Wash menu item in your WordPress sidebar

Alternative: Manual Installation

If you prefer to install manually:

  1. Download the plugin ZIP from the WordPress Plugin Directory
  2. In WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Choose the ZIP file and click Install Now
  4. Activate the plugin

Step 3: Connect WordPress to Shopify

  1. In your Shopify admin, open the Wash app
  2. Go to Settings → Connection
  3. Click Generate API Key
  4. Copy the API key and your Shopify store URL
  5. In WordPress, go to Wash → Settings
  6. Paste the API key and store URL
  7. Click Connect

You should see a green "Connected" status in both WordPress and Shopify.

Step 4: Configure Blog Mappings

Now you need to tell Wash which WordPress categories should sync to which Shopify blogs:

  1. In Shopify, go to Wash → Blog Mappings
  2. Click Add Mapping
  3. Select a WordPress category
  4. Select the target Shopify blog
  5. Click Save

Repeat for each category you want to sync.

Step 5: Initial Sync

Once connected and mapped, you can perform your first sync:

  1. In WordPress, go to Wash → Sync
  2. Click Sync All to sync all published posts
  3. Or select specific posts and click Sync Selected

The sync progress will be displayed in real-time.

Troubleshooting

Connection Failed

  • Verify your API key is correct (no extra spaces)
  • Check that your WordPress site is accessible from the internet
  • Ensure your WordPress site uses HTTPS

Plugin Not Found in Search

  • Make sure you're searching in WordPress.org (not WordPress.com)
  • Try the manual installation method

Sync Errors

  • Check the Wash → Logs page for detailed error messages
  • Verify your blog mappings are configured correctly
  • Ensure posts have the correct categories assigned

Next Steps