Best Practices

This guide covers recommended practices for using Wash: Blog Manager effectively, maintaining SEO, and ensuring a smooth workflow between WordPress and Shopify.

WordPress Configuration

Hide Your WordPress Blog from the Public

When using WordPress solely for content creation (not as your public blog), hide it from the internet:

Option 1: Password Protection

Add to your WordPress .htaccess:

AuthType Basic
AuthName "Restricted Access"
AuthUserFile /path/to/.htpasswd
Require valid-user <Files "wp-json"> Satisfy any Allow from all
</Files>

Option 2: IP Restriction

<RequireAll> Require ip 192.168.1.0/24 Require ip 10.0.0.0/8
</RequireAll> Require ip [Wash: Blog Manager-IP-Range]

Option 3: Subdomain Setup

Use a hidden subdomain:

Public store: www.yourstore.com (Shopify)
Hidden blog: cms.yourstore.com (WordPress)

Block Search Engine Indexing

Update your WordPress robots.txt:

User-agent: *
Disallow: / User-agent: Wash: Blog ManagerBot
Allow: /

Or use WordPress settings:

  1. Go to Settings > Reading
  2. Check Discourage search engines from indexing this site

Recommended WordPress Plugins

PurposeRecommended Plugin
SEOYoast SEO or RankMath
Image optimizationShortPixel or Imagify
Revision controlWP Revisions Control
PerformanceWP Super Cache
SecurityWordfence

Plan Your Blog Structure

Before syncing, plan how WordPress categories map to Shopify blogs:

Strategy A: Mirror Structure
WordPress Categories → Shopify Blogs
├── News → News
├── Tutorials → Tutorials
└── Reviews → Reviews Strategy B: Consolidation
WordPress Categories → Shopify Blogs
├── Company News ─┐
├── Press Releases ├─→ News
└── Events ─┘
├── Beginner Guides ─┐
└── Advanced Guides ├─→ Guides ─┘

Consistent Formatting

Establish content standards:

  • Headings: Use H2 for main sections, H3 for subsections
  • Images: Include alt text, consistent sizing
  • Links: Use descriptive anchor text
  • Featured images: Consistent aspect ratio (16:9 recommended)

SEO Optimization in WordPress

Optimize before syncing:

  1. Write meta descriptions - Use SEO plugin
  2. Optimize titles - Include keywords
  3. Add alt text - All images
  4. Use internal links - Link to related content
  5. Check readability - Use SEO plugin analysis

Sync Best Practices

Start with Test Content

  1. Create 2-3 test posts in WordPress
  2. Configure mappings
  3. Sync test posts
  4. Verify on Shopify
  5. Check formatting, images, metadata
  6. Adjust settings if needed
  7. Proceed with full sync

Use Sync Delay

Enable a short delay before syncing:

Sync delay: 10 seconds

Benefits:

  • Catch accidental publishes
  • Complete your edits
  • Review before sync

Schedule Syncs Wisely

For bulk operations:

  • Off-peak hours: Run large syncs during low traffic
  • Weekday mornings: Avoid weekend traffic spikes
  • Monitor progress: Watch sync logs

Review Before Publishing

Workflow recommendation:

1. Draft in WordPress
2. Internal review (draft status)
3. Publish in WordPress
4. Automatic sync to Shopify
5. Verify on Shopify storefront
6. Share/promote

What Needs Manual Attention

While Wash: Blog Manager automates most of the sync process, some items require manual attention after migration.

Internal Links

Important: Internal links within your content (links to other WordPress posts/pages) are NOT automatically rewritten to Shopify URLs.

What to do:

  1. After migration, audit your content for internal links
  2. Update links manually or use search-replace tools
  3. Consider using relative URLs where possible

Example:

<!-- Before (points to WordPress) -->
<a href="https://yourblog.com/how-to-guide/">How to Guide</a> <!-- After (should point to Shopify) -->
<a href="/blogs/news/how-to-guide">How to Guide</a>

Navigation Menus

Shopify navigation menus are separate from WordPress menus. WordPress menus are not synced.

What to do:

  1. Go to Shopify Admin → Online Store → Navigation
  2. Manually create menu items pointing to your synced articles
  3. Consider organizing by blog or category

Canonical URLs

If keeping WordPress active alongside Shopify:

Risk: Search engines may see duplicate content.

Solution:

  1. Set canonical URLs in WordPress to point to Shopify versions
  2. Or block WordPress from search engines entirely (recommended)
  3. Use redirects to ensure only one URL is accessible

Cross-Site Links

Links to external sites remain unchanged. However, verify:

  • Links still work after migration
  • No broken external links exist
  • Social sharing URLs are updated

Smart Redirections Setup

Enable Before Migration

Set up redirections BEFORE you start syncing:

  1. Enable Smart Redirections
  2. Configure redirect type (301)
  3. Test with one post
  4. Verify redirect works
  5. Proceed with migration

Maintain Redirects Long-Term

Keep redirects active for at least 1-2 years:

  • Search engines need time to update
  • Backlinks from other sites
  • Bookmarks from users
  • Printed materials with old URLs

Monitor for 404s

Regularly check for broken URLs:

  1. Wash: Blog Manager: Check 404 log in dashboard
  2. Google Search Console: Monitor Coverage report
  3. Analytics: Track 404 page visits

Author Management

Standardize Author Profiles

Before enabling author mapping:

  1. Complete all author bios
  2. Add profile pictures
  3. Include social links
  4. Use consistent formatting

Author Display

Design your Shopify theme to display authors:

{% if article.metafields.wash.author_name %} <div class="article-author"> {% comment %} Author info {% endcomment %} </div>
{% endif %}

Image Optimization

Before Upload to WordPress

  1. Resize: Max 2048px width
  2. Compress: Use tools like TinyPNG
  3. Format: JPEG for photos, PNG for graphics
  4. Name: Use descriptive filenames

During Sync

Configure optimal settings:

Max width: 2048px
Quality: 85
Convert to WebP: On

On Shopify

Use responsive images:

<img src="{{ image | image_url: width: 800 }}" srcset=" {{ image | image_url: width: 400 }} 400w, {{ image | image_url: width: 800 }} 800w, {{ image | image_url: width: 1200 }} 1200w " sizes="(max-width: 600px) 400px, (max-width: 1200px) 800px, 1200px" loading="lazy"
/>

Shopify Theme Customization

Create Article Template Sections

Build flexible article templates:

{% comment %} sections/article-template.liquid {% endcomment %} <article class="article"> {% section 'article-hero' %} {% section 'article-meta' %} {% section 'article-content' %} {% section 'article-author' %} {% section 'article-related' %} {% section 'article-comments' %}
</article>

Display Custom Fields

Show synced metadata:

{% comment %} Reading time {% endcomment %}
{% if article.metafields.wash.reading_time %} <span class="reading-time"> {{ article.metafields.wash.reading_time }} min read </span>
{% endif %} {% comment %} Featured product {% endcomment %}
{% if article.metafields.wash.featured_product %} {% render 'featured-product', product: article.metafields.wash.featured_product.value %}
{% endif %}

Style for Consistency

Match WordPress block styles in Shopify CSS:

/* Match WordPress block styles */
.article-content figure { margin: 2rem 0;
} .article-content figcaption { font-size: 0.875rem; color: #666; text-align: center; margin-top: 0.5rem;
} .article-content blockquote { border-left: 4px solid #0066cc; padding-left: 1rem; margin: 1.5rem 0; font-style: italic;
}

Security Recommendations

WordPress Security

  1. Strong passwords: Use password manager
  2. Two-factor auth: Enable 2FA for all users
  3. Limit logins: Use login limiting plugin
  4. Keep updated: WordPress, plugins, themes
  5. SSL: Use HTTPS everywhere

API Security

  1. Regenerate keys: Periodically rotate API keys
  2. Monitor access: Review API logs
  3. IP restrictions: If possible, restrict API access
  4. Minimal permissions: Only enable needed features

Shopify Security

  1. Staff accounts: Use individual accounts
  2. App permissions: Review app access regularly
  3. Two-factor auth: Enable for all staff
  4. Activity log: Monitor admin actions

Monitoring and Maintenance

Regular Checks

TaskFrequency
Review sync logsDaily
Check for 404sWeekly
Verify redirect functionWeekly
Update WordPressMonthly
Rotate API keysQuarterly
Full sync auditQuarterly

Sync Health Dashboard

Monitor these metrics:

Sync Health
├── Success rate: 99.2%
├── Average sync time: 3.2s
├── Failed syncs (24h): 2
├── Images synced (24h): 45
└── Redirects active: 156

Error Handling

When syncs fail:

  1. Check error logs
  2. Identify pattern (specific posts? images?)
  3. Test manually
  4. Adjust settings
  5. Retry failed syncs

Backup Strategy

WordPress Backups

Daily: Database backup
Weekly: Full site backup
Monthly: Off-site backup verification

Shopify Data

While Shopify handles hosting:

  • Export articles periodically
  • Keep WordPress as source of truth
  • Document custom theme changes

Migration Checklist

Pre-Migration

  • [ ] Audit existing WordPress content
  • [ ] Clean up unused posts/images
  • [ ] Export list of all WordPress URLs (for redirect mapping)
  • [ ] Verify all images have alt text
  • [ ] Complete author profiles
  • [ ] Plan category-to-blog mapping
  • [ ] Test with sample content

During Migration

  • [ ] Enable Smart Redirections
  • [ ] Sync in batches
  • [ ] Verify each batch
  • [ ] Monitor for errors
  • [ ] Check image uploads
  • [ ] Test redirects
  • [ ] Create 301 redirects for old URLs

Post-Migration (SEO Checklist)

  • [ ] Submit new sitemap to Google Search Console
  • [ ] Use URL Inspection tool to verify pages
  • [ ] Monitor Coverage report for crawl errors
  • [ ] Check meta titles and descriptions synced correctly
  • [ ] Verify images load from Shopify CDN (not WordPress)
  • [ ] Test internal links and update broken ones
  • [ ] Monitor 404 errors in analytics
  • [ ] Set up robots.txt to block WordPress from indexing (if keeping it)
  • [ ] Keep WordPress secure/hidden

Summary: Key Recommendations

  1. Hide WordPress from public access
  2. Block indexing with robots.txt
  3. Enable redirections before syncing
  4. Test thoroughly with sample content
  5. Optimize images before and during sync
  6. Monitor regularly for errors and 404s
  7. Keep WordPress as your source of truth
  8. Maintain security on both platforms
  9. Document everything for your team
  10. Plan for long-term redirect maintenance

Related Documentation