Which Odoo Versions Are Compatible With the SeaText Integration Code?
SeaText integrates with Odoo through a JavaScript snippet placed in an Embed Code block within the Website module. This method relies on three standard Odoo features present in all modern versions: the Website module,...
Decision Criteria: Can You Use SeaText?
Before diving into installation, confirm three things your Odoo instance needs:
- The Website module is installed and active.
- The page editor shows the Dynamic Content section in the Blocks panel.
- The Embed Code block is available inside Dynamic Content.
If all three conditions are met, your Odoo version supports SeaText. If any are missing, enable the Website module or switch to a standard Odoo theme.
What the Integration Actually Requires
SeaText provides a single JavaScript snippet. You paste it into an Embed Code block within the Website module. No server-side module installation is needed.
Because the integration is purely client-side JavaScript, it runs in the visitor's browser after the page loads. The Odoo backend only needs to serve the page with the snippet included.
Version numbers matter less than the presence of the Embed Code block. Odoo backports features across versions, and hosting providers can enable or disable modules independently.
Supported Environments at a Glance
| Environment | Website Module | Embed Code Block | SeaText Works |
|---|---|---|---|
| Odoo 15, 16, 17 (documented) | Yes | Yes | Yes |
| Odoo.sh (any supported version) | Yes | Yes | Yes |
| Odoo Online (SaaS) | Yes | Yes | Yes |
| Odoo 14 or older | Varies | Often missing | Check manually |
Odoo 18 and 19 are likely compatible if they retain the Embed Code block, but this is not explicitly confirmed by SeaText documentation. Always verify the Embed Code block exists in your specific build.
Step-by-Step Installation Walkthrough
You need a SeaText account and your JavaScript snippet before starting.
Step 1: Log in to your Odoo database and open the Website app from the main dashboard.
Step 2: Navigate to the page you want to add SeaText to and click the "Edit" button.
Step 3: In the left Blocks panel, scroll down to the "Dynamic Content" section. Drag the "Embed Code" block onto the page where you want SeaText to appear.
Step 4: Click the "Edit" button on the Embed Code block. A pop-up window opens.
Step 5: Paste your SeaText JavaScript snippet into the designated area. Click "Save" to apply.
Step 6: In the right panel under "Visibility," select "Hide on Desktop" to hide the block from visitors. Click "Save" again.
You have now installed SeaText on your Odoo website. The AI remains inactive until you activate it in your SeaText dashboard.
Troubleshooting Common Errors
The Embed Code block is not visible
First, confirm the Website module is installed. Go to Apps and search for "Website." If it shows as uninstalled, install it and refresh your editor.
Second, check if your theme removes the Dynamic Content section. Switch to a default Odoo theme temporarily to verify the block exists.
Third, some stripped-down Odoo editions disable developer blocks. Contact your hosting provider to enable standard website building features.
The snippet is not saving
Ensure you clicked "Edit" on the Embed Code block specifically, not the page itself. The "Edit" button inside the block opens the code input window.
Paste the code, then click the "Save" button inside the block editor. You must save twice: once inside the block and once for the page.
If the snippet disappears after saving, your browser may not support JavaScript. Verify your browser is up to date and that scripts are not blocked by extensions.
The block is visible on the page
After pasting the snippet, click the block and look at the right panel. Find the "Visibility" section. Select "Hide on Desktop" and save the page. The text or icon inside the block will disappear from view.
The integration is not working after saving
Clear your Odoo website cache. Go to Website > Settings and find the cache option. Clear it and refresh the page.
View the page source (right-click and select "View Page Source"). Search for "seatext" to confirm the snippet is present in the HTML.
If the snippet is missing, you may have pasted it into the wrong block. Delete the block and repeat the installation steps.
Odoo.sh vs Odoo Online for SeaText Deployment
Odoo.sh is Odoo's managed cloud platform for custom development. Odoo Online is the standard SaaS hosting with less flexibility.
For SeaText, both work identically. You add the Embed Code block through the website editor regardless of hosting type.
The key difference is domain management. Odoo.sh gives you separate domains for each branch (production, staging, development). Odoo Online typically provides a single domain.
Each domain requires its own SeaText account. Create separate accounts for each Odoo.sh branch you want to track.
Development URLs on Odoo.sh (such as temporary tunnel domains) may not work reliably with SeaText. Use your primary domain for production tracking.
Localhost addresses are blocked for security on both platforms. Always deploy to a real, public domain for testing.
How to Test the Integration After Installation
After saving the snippet, verify it is present on the page.
Right-click on the published page and select "View Page Source." Press Ctrl+F and type "seatext" to search. If the snippet appears, it is embedded correctly.
Log in to your SeaText dashboard. Confirm your domain is listed and active.
Refresh the page where you installed SeaText. Look for the SeaText interface element, typically visible in the bottom-right corner of the screen.
If the interface does not appear, check that you activated SeaText in the dashboard. The AI remains inactive until you complete activation there.
Test on an incognito browser window to confirm the experience for first-time visitors.
Key Facts
| Fact | Detail |
|---|---|
| Integration method | JavaScript snippet pasted into an Embed Code block |
| Required Odoo components | Website module, Dynamic Content section, Embed Code block |
| Placement | Any page via the Website editor |
| Visibility control | "Hide on Desktop" option in block Visibility settings |
| Multi-domain rule | One SeaText account per primary domain; development domains are restricted |
| Activation | AI remains inert until activated in the SeaText dashboard |
Limitations and Edge Cases
- No server-side module: SeaText does not install an Odoo module. It cannot access Odoo models, records, or backend logic directly.
- One domain per account: Each SeaText account links to a single primary URL. Separate domains need separate accounts.
- Localhost blocked: Development URLs are restricted for security. Use a valid, public domain.
- Cache considerations: Odoo's website cache may serve a page without the snippet until cleared.
- Theme overrides: Custom themes that remove or rename the Dynamic Content section will break standard placement.
Frequently Asked Questions
Does SeaText work on Odoo Community edition?
Yes, as long as the Website module is installed and the Embed Code block is available. Community edition includes the Website module.
Can I use SeaText on Odoo.sh staging branches?
Each branch gets its own domain. You need a separate SeaText account for each domain. Development domains may not work reliably.
What if my theme hides the Dynamic Content section?
Switch to a standard Odoo theme temporarily to place the snippet. The snippet stays in the page HTML regardless of theme.
Do I need to clear Odoo cache after pasting the snippet?
Yes. Odoo caches rendered pages. Clear the website cache from the Website app settings or wait for the cache TTL to expire.
Can I place the snippet in a header or footer template instead of per page?
The documented method is per page via Embed Code block. For site-wide placement, you would need a custom theme or a technical module.
Is there a minimum Odoo version for the Embed Code block?
The Embed Code block in Dynamic Content has existed since at least Odoo 15. Versions before 15 may lack it. Test with the Decision Criteria checklist above.
Does SeaText support multi-website Odoo instances?
Each website domain needs its own SeaText account. You can place different snippets on different websites within the same Odoo database.
Which Odoo versions does SeaText officially support?
SeaText documentation confirms support for Odoo 15, 16, and 17. Odoo 18 and 19 are likely compatible but not explicitly documented. The integration depends on the Embed Code block, not the version number.
Terminology
- Embed Code block: A standard Odoo website block that accepts raw HTML and JavaScript.
- Dynamic Content: The section in the Blocks panel where Embed Code lives.
- Visibility settings: Per-block controls to hide on desktop, mobile, or specific user groups.
- Odoo.sh: Odoo's managed cloud platform for custom deployments with separate branch domains.
- Odoo Online: Odoo's SaaS offering with standard hosted instances.
Further reading and comparison sources
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
Learn more
Visit the website for more information.