Best Practices

✅ Wait for product delivery before sending review invitations (use order status Complete)

✅ Enable Google Structured Data for SEO benefits

✅ Match your rating scale setting to your eKomi account configuration

✅ Use appropriate delays for your product type (longer for physical goods)

✅ Enable auto-approve if you trust eKomi's moderation

✅ Configure meta titles and descriptions for the review page

✅ Test your configuration with a real order before going live

❌ Don't send invitations too soon - customers need time to receive and use products

❌ Don't enable multiple invitation profiles for the same store/customer group combination (causes duplicate invitations)

❌ Don't ignore the self-test results - they highlight real configuration issues

❌ Don't forget to clear cache after configuration changes

❌ Don't set import frequency too high for low-volume stores (wastes API calls)

Use case: One store, one language, standard review collection

Configuration:

General:

• Enabled: Yes
• Build Queue: Every 6 Hours

Accounts:

• Select your single eKomi account
• Default Locale: Your store language
• Rating Scale: 1-5 Stars

Frontend:

• Enable: Yes
• Account Filter: No (single account)
• Locale Filter: No (single language)
• Rating Filter: Yes
• Year Filter: No
• Google Structured Data: Yes
• Reviews per Page: 15

Import:

• Auto Approve Reviews: Yes
• Update Frequency: Every Hour

Invitation Profile:

• Order Status: Complete
• Delay: 168 hours (7 days)
• Not Older Than: 30 days

Result: Reviews import automatically, display on a dedicated page with rating filters, and new customers receive invitations 7 days after order completion.

Use case: One store serving multiple countries with reviews in different languages

Configuration:

Accounts (per store view):

• German store view: German eKomi account (or shared account with DE locale)
• French store view: French eKomi account (or shared account with FR locale)
• Default Locale: Match to store view language

Frontend (per store view):

• Enable: Yes
• Locale Filter: Yes
• Locales: Select relevant languages for each store view
• Rating Filter: Yes

Import:

• Auto Approve Reviews: Yes
• Update Frequency: Every Hour

Invitation Profiles (create one per store view):

• Profile 1: German store view, German locale
• Profile 2: French store view, French locale
• Delay: 336 hours (14 days) for international shipping

Result: Each store view displays reviews in the appropriate language, customers receive invitations in their language, and the review page allows filtering by language if needed.

Use case: One Magento installation serving multiple brands, each with its own eKomi account

Configuration:

Accounts Setup:

• Add all brand eKomi accounts in Marketing → eKomi → Manage Accounts
• Assign appropriate account to each store view in configuration

Frontend:

• Enable: Yes
• Account Filter: Yes (allows customers to filter by brand)
• Accounts: Select all relevant accounts

Invitation Profiles:

• Create separate profile per brand/store view
• Each profile linked to correct eKomi account

Result: Each brand collects reviews to its own eKomi account, and customers can filter the review page by brand.

Use case: Large store requiring quality control on reviews before display

Configuration:

Import:

• Auto Approve Reviews: No
• Update Frequency: Every 6 Hours (reduce API calls)

General:

• Build Queue: Every 12 Hours (batch processing)

Debug:

• Debug Mode: No (reduce log file size)

Invitation Profile:

• Delay: 240 hours (10 days)
• Not Older Than: 14 days (limit backlog)

Result: Reviews are imported but held for manual approval. Staff reviews each submission in Marketing → eKomi → Reviews before it appears on the store.

Use case: Wholesale store that only wants reviews from certain customer groups

Configuration:

Invitation Profile:

• Customer Groups: Select only retail/B2C groups
• Exclude: Wholesale, Not Logged In
• Order Status: Complete
• Delay: 168 hours

Result: Only retail customers receive review invitations. Wholesale customers continue purchasing without review requests.

• High-volume stores (100+ orders/day): Every 6 Hours
• Medium-volume stores (10-100 orders/day): Every Hour
• Low-volume stores (<10 orders/day): Every 6 Hours or Daily

• Match to your order volume
• Higher frequency = more responsive invitations
• Lower frequency = less server load

• Always clear cache after configuration changes
• Widget output is cached by Magento's block cache

Enable Google Structured Data to get rich snippets in search results. This can significantly improve click-through rates.

• Write unique meta titles and descriptions
• Include your store name and "reviews" or "customer feedback"
• Keep meta descriptions under 160 characters

The default URL is /ekomi/. This is clean and SEO-friendly. No changes needed.

Why it's wrong: Customers can't review products they haven't received. This leads to low response rates and frustrated customers.

Correct approach: Set delay to at least 7 days (168 hours) for physical products. Use order status Complete as the trigger.

Why it's wrong: If multiple profiles match the same order, the customer may receive multiple invitations for one purchase.

Correct approach: Ensure invitation profiles don't overlap. Use distinct store views, customer groups, or order status triggers.

Why it's wrong: If your Magento setting doesn't match your eKomi account, ratings display incorrectly (e.g., "4 out of 10" when it should be "4 out of 5").

Correct approach: Check your eKomi dashboard for the correct rating scale and match it in configuration.

Why it's wrong: Configuration changes don't take effect until cache is cleared. This causes confusion when testing.

Correct approach: Always clear cache after making configuration changes: bin/magento cache:flush

Why it's wrong: Debug logging generates large log files that consume disk space and can impact performance.

Correct approach: Only enable debug mode when actively troubleshooting. Disable it afterward.

• Use "Sidebar" mode for narrow columns
• Limit to 3-5 reviews
• Enable slider for space efficiency

• Use on homepage or product pages
• Enable autoplay with 5-7 second intervals
• Configure responsive breakpoints for mobile

• Use the dedicated /ekomi/ page for comprehensive review display
• Enable all relevant filters
• Set appropriate reviews per page (10-20)