Connecting WooCommerce to ConvertMate

Connecting your WooCommerce store to ConvertMate enables AI-powered agents to optimize product descriptions, meta tags, categories, and content while syncing your catalog data for comprehensive analysis and automated improvements.

Before you start

Make sure you have:

• An active WooCommerce store with products
• WordPress Administrator access to generate API keys
• WooCommerce REST API enabled (usually enabled by default)
• HTTPS/SSL certificate installed on your store (required for API security)
• An active ConvertMate account

Why connect WooCommerce

Connecting WooCommerce allows ConvertMate to:

• Sync your product catalog automatically
• Optimize product titles, descriptions, and meta tags
• Improve category and collection pages
• Generate SEO-friendly content
• Track product performance
• Automate content improvements
• Monitor and enhance search visibility

Connection steps

WooCommerce uses API key authentication instead of OAuth. You'll generate API credentials in WordPress and enter them in ConvertMate.

Step 1: Generate WooCommerce API keys

1. Log in to your WordPress admin dashboard
2. Go to WooCommerce → Settings
3. Click the Advanced tab
4. Click REST API
5. Click Add key

Step 2: Configure API key settings

On the key creation screen:

1. Description: Enter "ConvertMate Integration" (or any name you prefer)
2. User: Select your admin user account
3. Permissions: Select Read/Write
4. Click Generate API key

Important: WooCommerce will display your Consumer Key and Consumer Secret only once. Don't close this page yet.

Step 3: Copy your credentials

After generating the key:

1. Copy the Consumer Key (starts with "ck_")
2. Copy the Consumer Secret (starts with "cs_")
3. Keep this page open or save credentials securely

You'll need both values for the next step.

Step 4: Connect in ConvertMate

1. Log in to your ConvertMate account
2. Go to Settings → Connections
3. Find WooCommerce in the platform list
4. Click Connect

Step 5: Enter connection details

On the WooCommerce connection form:

1. Store URL: Enter your complete store URL (e.g., https://yourstore.com)

- Include "https://" at the beginning - Don't include trailing slashes - Use your primary domain

1. Consumer Key: Paste the Consumer Key from Step 3
2. Consumer Secret: Paste the Consumer Secret from Step 3
3. Click Test connection

Step 6: Verify and save

1. ConvertMate tests the connection to your store
2. If successful, you'll see a confirmation message
3. Click Save connection
4. ConvertMate begins syncing your catalog

Initial sync takes 5-15 minutes depending on catalog size.

What gets synced

ConvertMate syncs comprehensive WooCommerce data:

Product data

• Product names and SKUs
• Short and long descriptions
• Meta titles and meta descriptions (via SEO plugins like Yoast or RankMath)
• Product variations and attributes
• Pricing information
• Stock levels
• Product images and galleries
• Product categories and tags
• Custom fields

Category data

• Category names and hierarchy
• Category descriptions
• Meta titles and descriptions
• Category images
• Product assignments

Order data (for analytics)

• Order history
• Product performance metrics
• Revenue data
• Customer purchase patterns

Store configuration

• Store name and URL
• Currency settings
• Tax configuration
• Shipping zones

How sync works

After the initial connection:

Automatic sync - ConvertMate syncs with WooCommerce every 6 hours to capture new products, updates, and orders. Manual sync - You can trigger a manual sync anytime from Settings → Connections. Webhooks - ConvertMate can receive webhook notifications for real-time updates (requires webhook configuration in WordPress). Two-way sync - When you optimize content in ConvertMate and approve changes, they're pushed back to WooCommerce automatically.

Using agents after connection

Once WooCommerce is connected, you can run e-commerce optimization agents:

Available agents

Product Optimizer - Optimize product titles, descriptions, and meta tags for SEO and conversions Category Optimizer - Improve category pages and descriptions Content Generator - Create new product descriptions in bulk SEO Auditor - Identify SEO issues across your catalog Product IQ - Deep analysis of individual product performance with recommendations Browse all e-commerce agents

Managing optimized content

When agents suggest content improvements:

Review suggestions

1. Go to Content Hub → Content suggestions
2. View AI-generated improvements
3. See side-by-side comparison with current content
4. Review SEO scores and recommendations

Apply changes

1. Review the suggested content
2. Edit if needed to match your brand voice
3. Click Apply to push changes to WooCommerce
4. Changes sync to your store within minutes

Bulk operations

Optimize multiple products at once:

1. Select products in Content Hub
2. Choose optimization type
3. Review batch suggestions
4. Apply all or individually

Troubleshooting connection issues

SSL/HTTPS required error

If you see an SSL error:

• WooCommerce API requires HTTPS for security
• Install an SSL certificate on your WordPress site
• Many hosts provide free SSL certificates (Let's Encrypt)
• Update your WordPress and WooCommerce URLs to use https://
• Contact your hosting provider for SSL installation help

Consumer Key/Secret invalid

If credentials aren't accepted:

• Verify you copied the complete Consumer Key (no spaces)
• Ensure the Consumer Secret is complete
• Check that the key has Read/Write permissions
• Try generating a new API key in WooCommerce
• Ensure the API key is active (not deleted)

Connection test fails

If the connection test fails:

• Verify your Store URL is correct and includes https://
• Check that WooCommerce REST API is enabled
• Ensure the WordPress site is accessible (not in maintenance mode)
• Verify no firewall or security plugin is blocking API requests
• Try temporarily disabling security plugins to test
• Check WooCommerce is activated and up to date

Products not syncing

If products aren't appearing in ConvertMate:

• Verify products are published (not draft) in WooCommerce
• Check that products have required fields (name, price)
• Wait 30 minutes for initial sync to complete
• Try clicking Sync now in Settings → Connections
• Check WooCommerce system status for API issues

Changes not applying to WooCommerce

If optimized content isn't updating your store:

• Verify the API key still exists in WooCommerce
• Check the key has Read/Write permissions (not Read only)
• Ensure products haven't been deleted in WooCommerce
• Check for caching plugins that might delay updates
• Try regenerating the API key and reconnecting

Rate limiting or timeout errors

If you see rate limit errors:

• WooCommerce has API rate limits based on server configuration
• ConvertMate respects these limits automatically
• Large catalogs may take longer to sync
• Try syncing during off-peak hours
• Contact your hosting provider about increasing API limits

Security best practices

API key management:

• Store API keys securely
• Don't share Consumer Secret publicly
• Generate unique keys for each integration
• Revoke and regenerate keys if compromised
• Review active API keys periodically

WordPress security:

• Keep WordPress and WooCommerce updated
• Use strong admin passwords
• Enable two-factor authentication
• Use a security plugin (Wordfence, Sucuri)
• Regular backups

HTTPS enforcement:

• Always use HTTPS for API connections
• Redirect HTTP to HTTPS
• Use strong SSL certificates
• Keep certificates renewed

Privacy and permissions

What ConvertMate can access:

• Product and category data for optimization
• Order history for performance analytics (aggregate data)
• Store configuration for proper integration

What ConvertMate cannot access:

• Customer personal information (names, addresses, payment details)
• WordPress admin passwords
• Payment gateway credentials
• Other plugins' data
• Database credentials

What ConvertMate can modify:

• Product titles, descriptions, and meta tags (only when you approve changes)
• Category descriptions and meta data (with your approval)

Your data:

• Stored encrypted in secure databases
• Never shared with third parties
• Used only for optimization and analytics
• You can disconnect anytime

Read our privacy policy

Disconnecting WooCommerce

If you need to disconnect:

1. Go to Settings → Connections
2. Find WooCommerce in your connected platforms
3. Click Disconnect
4. Confirm the disconnection

What happens when you disconnect:

• Sync stops immediately
• Historical data stays in ConvertMate
• No new changes will be pushed to WooCommerce
• E-commerce agents won't run
• You can reconnect anytime

To revoke API access in WordPress:

1. Go to WooCommerce → Settings → Advanced → REST API
2. Find the ConvertMate key
3. Click Revoke

Working with WordPress plugins

SEO plugins - ConvertMate works with popular SEO plugins:

• Yoast SEO (reads and updates SEO titles and descriptions)
• RankMath SEO (reads and updates SEO fields)
• All in One SEO (compatible)

Page builders - Compatible with:

• Elementor
• Divi
• Beaver Builder
• WPBakery

Caching plugins - If using caching:

• Clear cache after applying ConvertMate changes
• Configure cache to refresh on content updates
• Popular caching plugins: WP Rocket, W3 Total Cache, WP Super Cache

WooCommerce-specific features

Variable products - ConvertMate optimizes parent products and can optimize variations individually. Product bundles - Bundle products are treated as regular products for optimization. Subscription products - Subscription product descriptions can be optimized. Multilingual stores (WPML, Polylang) - Connect each language version separately if they have separate WooCommerce installations.

Common questions

Do I need WooCommerce to use ConvertMate?

No, ConvertMate supports multiple platforms. Connect whichever e-commerce platform you use.

Will this slow down my WordPress site?

No, ConvertMate uses the WooCommerce API efficiently and doesn't add load to your site.

Can I optimize products without auto-applying changes?

Yes, all changes require your approval. ConvertMate never pushes changes without your review.

How many products can I sync?

There's no limit. ConvertMate syncs stores with 10 to 100,000+ products.

Does this work with WordPress multisite?

Yes, each WooCommerce installation can be connected separately.

Can I revoke access anytime?

Yes, delete the API key in WooCommerce settings to immediately revoke access.

What's next

Now that WooCommerce is connected:

• Optimize your first product
• Learn about product optimization
• Browse e-commerce agents
• Set up automated workflows

Need help with your WooCommerce connection? Use the chat widget in the bottom-right corner or email support@convertmate.io.