Notion Connector for WooCommerce

Summary

↑ Back to top

The Notion Connector for WooCommerce provides seamless integration between your WooCommerce store and Notion workspace. Automatically synchronize your store data including products, orders, customers, coupons, categories, tags, and attributes into organized Notion databases with real-time updates and bidirectional sync capabilities.

Key Features

↑ Back to top

• Complete Data Coverage: Sync products, orders, customers, coupons, categories, tags, and attributes
• Bidirectional Synchronization: Changes flow both ways between WooCommerce and Notion
• Real-time Updates: Background sync with webhook support for instant updates
• Automated Setup: 5-minute setup wizard with automatic Notion database creation
• Background Processing: Zero impact on store performance with queued sync operations
• Manual Sync Controls: Admin interface for on-demand synchronization
• Security First: Encrypted connections, input validation, and secure API token management
• HPOS Compatible: Full support for WooCommerce High-Performance Order Storage
• Developer-friendly: Extensive hooks and filters for customization

Data Synchronization Coverage

↑ Back to top

Products

↑ Back to top

• Basic information (name, description, SKU, prices)
• Stock management (quantity, status, backorders)
• Physical properties (weight, dimensions)
• Product images and galleries
• Categories, tags, and attributes
• Product variations (for variable products)
• Product status and visibility settings

Orders

↑ Back to top

• Complete order details (items, totals, status)
• Customer information (billing/shipping addresses)
• Payment and shipping methods
• Order notes and metadata
• Note: Only status changes sync from Notion to WooCommerce

Customers

↑ Back to top

• Customer profiles and account information
• Billing and shipping addresses
• Order history and purchase data
• Guest customer handling from orders
• Account creation dates and statistics

Coupons

↑ Back to top

• Coupon codes and discount amounts
• Usage limits and restrictions
• Expiration dates and conditions
• Email restrictions and product limitations
• Usage tracking and history

Categories & Taxonomies

↑ Back to top

• Product categories with descriptions
• Product tags and organization
• Product attributes (global attributes only)
• Brand information (if using product brands)
• Hierarchical category structures

Requirements

↑ Back to top

• WordPress 6.0 or higher
• WooCommerce 6.3 or higher
• PHP 7.4 or higher
• SSL certificate (required for secure API communication)
• Active Notion account
• Action Scheduler (included with WooCommerce)

Initial Configuration

↑ Back to top

• Get Notion API Token:

• Go to Notion’s Integration page
• Click “New integration”
• Name your integration and select the workspace
• Set capabilities (read/write content)
• Copy the “Internal Integration Token”

• Plugin Setup:

• Navigate to WooCommerce > Settings > Notion
• Enter your Notion API token
• Run the setup wizard to create databases
• Configure sync preferences for each data type
• Test the connection to verify settings

• Database Configuration:

• The wizard automatically creates optimized Notion databases
• Each data type gets its own database (products, orders, etc.)
• Database structures are pre-configured with appropriate field types
• Share databases with team members as needed

• Webhook Configuration:

• Go to Notion’s Webhook page
• Click “Webhooks” tab
• Name your webhook and select the workspace
• Set the webhook URL to https://your-site.com/wc-api/notion_connector (the URL is provided in the plugin settings)
• Set the webhook events to Page created, Page updated, Page deleted or select all events
• Click “Create webhook”
• Click “Verify webhook”
• Go back to the plugin settings and click “Refresh” in the webhook section
• You should get a webhook token, copy it and paste it on Notion webhook configuration page

Sync Configuration

↑ Back to top

• Real-time Sync: Enable/disable automatic sync for each data type
• Manual Sync: Use admin buttons for on-demand synchronization
• Background Processing: All sync operations run in background queues
• Conflict Resolution: Built-in safeguards prevent infinite sync loops
• Selective Sync: Choose which fields and data types to synchronize

Usage

↑ Back to top

Automatic Synchronization

↑ Back to top

Once configured, the plugin automatically syncs data when:

• Products are created, updated, or deleted
• Orders are placed or status changes
• Customers register or update profiles
• Coupons are created or modified
• Categories and tags are managed

Manual Synchronization

↑ Back to top

Access manual sync options from:

• WooCommerce > Settings > Notion
• Individual product/order edit pages
• Bulk sync tools for initial data import

Notion Database Management

↑ Back to top

• Databases are automatically created during setup
• Field mappings are pre-configured for optimal compatibility
• Edit data in either WooCommerce or Notion – changes sync both ways
• Use Notion’s powerful filtering and view features for reporting

FAQ

↑ Back to top

Q: Does this plugin slow down my store?
A: No. All synchronization happens in background queues with no impact on customer-facing pages or checkout performance.

Q: Can I sync existing store data?
A: Yes. The plugin includes bulk sync tools to import your existing products, orders, customers, and other data during initial setup.

Q: What if I edit data in Notion?
A: Changes made in Notion will sync back to WooCommerce automatically. However, order creation from Notion is not supported – only status updates.

Q: How secure is the data transfer?
A: Very secure. All connections use HTTPS encryption, API tokens are stored securely, and the plugin includes input validation and sanitization.

Q: Can I control what data gets synced?
A: Yes. You can enable/disable sync for each data type (products, orders, customers, etc.) and configure field-level synchronization preferences.

Q: What happens if Notion is unavailable?
A: The plugin includes intelligent retry mechanisms and queuing. Sync operations will resume automatically when connectivity is restored.

Q: Does this work with WooCommerce extensions?
A: The plugin syncs standard WooCommerce data. Compatibility with specific extensions depends on how they store data. Contact support for specific compatibility questions.

Troubleshooting

↑ Back to top

Common Issues

↑ Back to top

• Connection Failed: Verify your Notion API token and workspace permissions
• Sync Delays: Check Action Scheduler status in WooCommerce > Status > Scheduled Actions
• Missing Data: Ensure proper database sharing permissions in Notion

Debug Mode

↑ Back to top

Enable debug logging in plugin settings to troubleshoot sync issues. Logs are available in WooCommerce > Status > Logs.

Support

↑ Back to top

For support, feature requests, or bug reports:

• Check the FAQ section above
• Review WooCommerce > Status > Logs for error details
• Contact plugin support with specific details about your issue