Configuration Guide

Note: This page has been split into separate documentation pages for better organization.

Please see:

Default settings

After installation, Wash uses the following default values. You can adjust these settings in WordPress under Settings → Wash Connector, or in Shopify from the connection's Settings link under Apps > Wash > Connections. Both edit the same settings.

Sync settings

Sync Settings tab in Shopify Connection Settings

OptionDefaultDescription
Auto-sync on PublishEnabledSync posts when they are published or updated
Rewrite Internal URLsEnabledTurn links to other synced posts and pages into Shopify URLs (/blog/post-slug → /blogs/{blog-handle}/post-slug, /page-slug → /pages/page-slug). Links to content that isn't synced stay as they are. Editable in WordPress and, since Wash Connector 1.32.0, in the Shopify app
Post Typespost, pageContent types to sync to Shopify
Block RobotsEnabledAdd noindex meta to WordPress (SEO on Shopify only)

Files & media

OptionDefaultDescription
Upload FilesEnabledSync images and files to Shopify CDN
Convert to WebPDisabledConvert images to WebP format
Allowed File TypesImagesWhich file types to sync (images, PDF, video, audio, documents)

Metafields

OptionDefaultDescription
Sync MetafieldsEnabledSync custom fields to Shopify metafields
WordPress CoreEnabledSync excerpt, featured image URL, author
Yoast SEODisabledSync Yoast meta title, description, focus keyword
Rank Math SEODisabledSync Rank Math SEO data
ACF FieldsDisabledSync Advanced Custom Fields

Gutenberg blocks

OptionDefaultDescription
Enable Custom BlocksEnabledEnable Wash blocks in Gutenberg editor
Sync Block StructureEnabledSave block metadata as Shopify metafields
Include Block CSSDisabledInclude WordPress block styles in content

Advanced features

OptionDefaultDescription
Hreflang TagsDisabledSync multilingual hreflang data (WPML, Polylang)
Author MappingDisabledMap WordPress users to custom author names