Pushing fixes to WordPress / Shopify

For many issues, the audit report has a Fix button. Clicking it deploys the change directly to your site without you copying anything by hand. This page documents how that works for WordPress and Shopify (the two most common platforms; others use the generic SFTP/FTP/cPanel path).

Supported fixable issues

Roughly 40 of the 200+ checks have one-click fixes. The most-used:

• Missing meta description (generated from page content via heuristics or LLM).
• Missing image alt text (generated from filename + nearby text + LLM vision).
• Missing or incorrect canonical URL.
• Image without width/height attribute.
• Missing Open Graph metadata.
• Missing FAQ schema on pages with detected FAQ-shape content.
• Compressing oversized images (auto-resized + WebP).
• Adding skipped heading levels (e.g. inserting H2s between H1 and H3s).

WordPress (via the plugin)

The SEMOptimiser WordPress plugin (installed from the WP plugin directory) is the recommended path:

1. Install + activate the plugin (WP Admin → Plugins → Add New → search SEMOptimiser).
2. Click Connect; OAuth bounces you to SEMOptimiser to authorize.
3. In the next audit, the Fix button appears on every fixable issue.
4. Clicking Fix sends a signed request to the plugin endpoint, which updates the post or postmeta directly via WP's native APIs.

Fallback: Application Passwords

For WP installs that can't reach the OAuth redirect (firewalled, multisite networks with restrictive policies), use WP Application Passwords:

1. WP Admin → Users → Profile → Application Passwords → New application password.
2. Name it "SEMOptimiser", click Add.
3. Copy the generated password.
4. In SEMOptimiser: Settings → Server Connections → WordPress REST API → paste site URL, username, and the application password.

Shopify (via the app)

Install the SEMOptimiser Shopify app from the Shopify App Store. OAuth + scopes (read_products, write_products, read_themes, write_themes) flow happens during install. After install, fixes deploy via the Shopify Admin GraphQL API.

Theme-level fixes

Fixes that touch your theme files (canonical tags in the layout, viewport meta in head) edit the theme via the Asset API. We always create a duplicate theme first and apply the fix there; you preview and Publish manually.

Generic platforms (SFTP/FTP/cPanel/Plesk)

For platforms without a dedicated plugin, set up a server connection (Settings → Server Connections) with credentials. Fixes are applied as file edits via the configured protocol. We always show a diff and require confirmation before deploying – there's no "auto-apply all fixes" toggle.

Rollback

Every fix creates a Change History entry with the before/after content. On Management+, you can roll back any single fix with one click. See "Change History" in the dashboard.

Bulk apply

For agencies: bulk apply the same fix across multiple connected sites in one operation. Audits → Issues → tick multiple sites → Apply fix.