Prerequisites for Installing SeaText AI on Odoo
You need an active SeaText account, admin access to your Odoo backend, and a compatible Odoo version (Community or Enterprise) to support the integration module. This checklist helps you verify each requirement before you...
You need an active SeaText account, administrative access to your Odoo backend, and a compatible version of Odoo (Community or Enterprise) to support the integration module. This checklist helps you verify each requirement before you begin the installation.
Readiness Checklist at a Glance
| Prerequisite | Why It Matters | How to Verify |
|---|---|---|
| Active SeaText Account | Provides the embed code and links traffic to your account | Log in to SeaText dashboard; confirm account is not expired |
| Odoo Admin Access | Required to add the Embed Code module and edit page structure | Check user role includes Administrator or Website Manager |
| Compatible Odoo Version | Ensures the embed module renders correctly | Check Odoo version in Settings; test on staging first |
| Real Domain (Not localhost) | Security restriction; localhost cannot associate traffic | Use a production or staging domain that matches your live URL |
| JavaScript Code Snippet | Contains the integration logic for the AI block | Copy from SeaText dashboard after account creation |
| Visibility Settings | Controls where the block appears on desktop vs mobile | Use the Hide on Desktop option in the Visibility section |
Practical takeaway: Complete all six items before starting the installation. Skipping any one can cause the embed to fail silently or the AI to remain inactive.
Why These Prerequisites Matter
Each prerequisite exists for a specific technical reason. Understanding the why helps you avoid common mistakes.
Active SeaText account. The account is the source of your unique JavaScript code. That code tells the SeaText servers which domain to associate with your traffic. Without an active account, you have no code to paste. An expired account means the code may still exist but the AI will not activate.
Admin access. Odoo restricts page editing to users with the right permissions. The Embed Code module lives inside the Dynamic Content section of the Website builder. Only an administrator or website manager can drag that module onto a page. If you lack admin rights, you cannot place the module or save the code.
Compatible Odoo version. The integration module relies on Odoo's website builder features. Older versions may not support the Dynamic Content section. Newer versions may change the module location. Always verify your version before you begin.
Real domain. SeaText restricts development URLs like localhost for security. The system needs a stable domain to reliably associate traffic with your account. Dynamic development domains can cause activation issues because the AI cannot confirm which site is sending requests.
JavaScript code. The code snippet is the actual integration. It contains the logic that loads the AI content block. Without the correct code, the module will appear but nothing will render.
Visibility settings. These settings determine whether the block shows on desktop, mobile, or both. They are optional but important for user experience. If you skip them, the block may appear on all devices by default.
Active SeaText Account
Before you can install the script, you need a SEATEXT AI account. If you don't have an account yet, you can create one HERE. An active account is the foundation for all SeaText integrations.
Use a real email address linked to your business. The account gives you access to the embed code and any future updates. Check that the account is not expired before you start the Odoo installation.
Why an active account is non-negotiable: The embed code is generated per account. Each account is tied to a single primary URL. If you try to use a code from one account on a different domain, the AI will not associate traffic correctly. This can lead to inaccurate analytics and failed activation.
What to check:
- Log in to the SeaText dashboard.
- Confirm your account status shows active.
- Verify the domain listed matches the Odoo site you plan to edit.
- Copy the JavaScript code from the integration section.
If you need SeaText on multiple domains, create a separate account for each domain. Do not share one account across sites.
Odoo Administrative Access
You must log in to your Odoo account and access the "Website" module from the dashboard. Within the Website module, navigate to the page you wish to edit and click on the "Edit" button to open the editing panel. In the editing panel, scroll through the "Blocks" panel until you reach the "Dynamic Content" section.
Locate the "Embed Code" module within the "Dynamic Content" section and drag it into the desired location on your website editor. Once the module is placed, click on the "Edit" button located in the right panel to input the code. In the pop-up window that appears, paste the code snippet provided by SEATEXT AI into the designated area, then click "Save" to apply the changes.
Why admin access is required: Odoo's website builder is permission-based. Regular users can view pages but cannot modify them. The Embed Code module is a structural element. Adding it changes the page's HTML. Only users with Administrator or Website Manager roles can perform this action.
How to verify your role:
- Go to Odoo Settings.
- Open the Users section.
- Find your user profile.
- Check that the Administrator or Website Manager toggle is enabled.
If you do not have admin rights, ask your Odoo administrator to grant them or to perform the installation for you.
Compatible Odoo Version
SeaText AI works with both Odoo Community and Odoo Enterprise editions. Ensure your Odoo instance is a supported version before you attempt the embed. The integration module is designed for Odoo 14 and later, but always check the release notes for your specific version.
Why version compatibility matters: Odoo updates its website builder interface regularly. The Dynamic Content section may move, rename, or change behavior between versions. If you use an unsupported version, the Embed Code module may not appear in the Blocks panel. Or it may appear but fail to render the AI content correctly.
How to check your version:
- Log in to Odoo.
- Go to Settings.
- Scroll to the General Settings section.
- Look for the version number displayed.
If you run a custom module stack, test the embed on a staging site first. A mismatched version can cause the embed code to fail silently. The block will appear in the editor but nothing will show on the live page.
Best practice: Always test on a staging environment before deploying to production. This is especially important after a major Odoo upgrade.
Secure Embed Process
Install Seatext on your website by following the instructions below. The installation process is secure, and the AI remains inert until activated, ensuring the integrity of your website's content. After you paste the code, click "Save" twice: once to apply the block and once to finalize any visibility settings.
Why the AI stays inert until activation: This is a deliberate security feature. The embed code loads the module structure but does not execute any AI logic until you activate it from the SeaText dashboard. This prevents the AI from altering your site content before you are ready.
Step-by-step installation:
- Log in to your Odoo account.
- Open the Website module.
- Navigate to the page you want to edit.
- Click the Edit button.
- Scroll to the Dynamic Content section in the Blocks panel.
- Drag the Embed Code module onto the page.
- Click Edit in the right panel.
- Paste the JavaScript code from SeaText.
- Click Save.
- Optionally, set visibility preferences.
- Click Save again to finalize.
Use the "Hide on Desktop" option in the "Visibility" section if you want the block to appear only on mobile devices. This step is optional but can improve user experience on larger screens.
Multiple Domains and Restrictions
If you need to use SeaText AI on multiple domains (e.g., a development domain and a production domain), you must create separate accounts for each domain. Each SEATEXT AI account is linked to a single primary URL.
Why one account per domain: SeaText uses the domain to associate traffic with your account. If you use the same account on two domains, the system cannot reliably determine which site is generating the traffic. This leads to mixed analytics and potential activation failures.
Restrictions and Security: Development URLs, such as localhost, are restricted for security reasons. Ensure you use a valid, real domain for these cases. Dynamic development domains may not function properly, as SeaText AI might be unable to reliably associate traffic with your account.
What to do:
- Use a staging domain that matches the production domain pattern.
- Create a separate SeaText account for each domain.
- Check the SeaText dashboard for any domain verification warnings before you deploy the embed to production.
If you see a warning about domain mismatch, do not proceed. Fix the domain association first.
Common Installation Errors and How to Avoid Them
Most installation issues trace back to one of the prerequisites. Here are the most frequent problems and their solutions.
Error 1: The Embed Code module does not appear in the Blocks panel.
Cause: You are using an unsupported Odoo version or you lack admin rights.
Solution: Verify your Odoo version. Confirm your user role includes Administrator or Website Manager. If both are correct, refresh the page and try again.
Error 2: The block appears but shows nothing on the live page.
Cause: The AI is not activated in the SeaText dashboard, or the domain does not match.
Solution: Log in to SeaText and activate the AI for the correct domain. Check that the domain in your SeaText account matches the Odoo site URL.
Error 3: The block shows on desktop when you wanted it hidden.
Cause: You did not set the Hide on Desktop option.
Solution: Re-enter edit mode, select the block, open the Visibility section, and enable Hide on Desktop. Click Save again.
Error 4: The AI content loads but analytics look wrong.
Cause: You are using the same SeaText account on multiple domains.
Solution: Create a separate account for each domain. Replace the embed code on each site with the correct account's code.
Error 5: The embed code fails to save.
Cause: You may have pasted the code into the wrong field or the code is incomplete.
Solution: Copy the code again from the SeaText dashboard. Ensure you paste it into the Embed Code pop-up window, not a regular text block.
Troubleshooting the Embed
If the embed still does not work after checking the prerequisites, follow this troubleshooting sequence.
Step 1: Verify the code.
Open the page in edit mode. Click on the Embed Code module. Check that the JavaScript code is complete and matches the code in your SeaText dashboard. A missing character can break the entire integration.
Step 2: Check the domain.
Go to the SeaText dashboard. Confirm the domain listed matches the Odoo site exactly. Include the www prefix if your site uses it. A mismatch between www and non-www can cause activation issues.
Step 3: Confirm activation.
Log in to SeaText. Find the domain in your account. Ensure the AI is activated for that domain. If it shows inactive, click Activate.
Step 4: Clear browser cache.
Sometimes the browser caches the old page version. Clear your cache and reload the page. This is especially important after you save changes.
Step 5: Test on a different browser.
If the block works in one browser but not another, the issue may be browser-specific. Test in Chrome, Firefox, and Safari to isolate the problem.
Step 6: Check for JavaScript errors.
Open the browser developer console. Look for any errors related to the SeaText script. If you see a 404 error, the code may be pointing to an incorrect URL.
Post-Installation Verification
After you save the embed, verify that everything works correctly before you go live.
What to check:
- Visit the page on the live domain.
- Confirm the AI content block appears in the correct location.
- Verify the block is visible on the intended devices (desktop, mobile, or both).
- Check that the AI content loads within a few seconds.
- Confirm that the block does not interfere with other page elements.
Why post-installation verification matters: A silent failure means the block appears in the editor but not on the live page. This wastes time and can confuse visitors. Verification catches these issues before your audience sees them.
Test on a staging site first. If you have a staging environment, deploy the embed there. Verify the AI content appears as expected. Test the Hide on Desktop setting. Only after a successful staging test should you deploy to production.
Monitor analytics. After going live, check the SeaText dashboard for traffic data. If you see no traffic, the domain association may be incorrect. Re-check the domain and activation status.
Limitations and Best Practices
SeaText AI does not support installation on Odoo instances that have strict content security policies blocking external scripts. If the embed fails to load, review your Odoo security settings and ensure the script source is whitelisted.
Why this limitation exists: The embed code loads a JavaScript file from SeaText's servers. If your Odoo instance blocks external scripts, the browser will refuse to load the file. The block will appear empty.
What to do: Check your Odoo security settings. Look for any content security policy (CSP) rules. Add the SeaText script source to the whitelist. If you cannot modify the CSP, contact your Odoo administrator.
Do not paste the embed code into a static HTML block that is hidden via CSS. The AI relies on the module being present in the DOM for activation. Use the built-in visibility controls instead of custom CSS hides.
Why this matters: The AI checks for the module in the page's DOM structure. If you hide the block with CSS, the module may still be present but the AI may not detect it correctly. This can cause activation failures.
Keep your SeaText account credentials secure. Sharing the embed code across multiple sites without separate accounts can cause traffic mixing and inaccurate analytics.
Test the integration on a non-production site first. Verify that the AI content appears as expected and that any hidden settings work correctly before you go live.
FAQ
Do I need a paid SeaText plan to install the Odoo module?
No. The embed module is available with any active SeaText account, including free tiers. However, advanced AI features may require a paid plan.
Can I install SeaText AI on a localhost development site?
No. Development URLs such as localhost are restricted for security reasons. Use a real domain that matches your production environment.
What if I lose admin access after installing the module?
The embed code remains in the page source. You can re-enter edit mode if you regain admin rights, or ask another administrator to make changes.
Is the AI content visible immediately after installation?
No. The AI stays inert until you activate it through the SeaText dashboard. The embed is secure and does not run scripts until activation.
Do I need to update the embed code for each Odoo upgrade?
Generally, the same embed code works across Odoo version upgrades. Verify compatibility after a major upgrade and test the block on a staging site.
Can I use one SeaText account for multiple Odoo websites?
No. Each domain needs its own SeaText account. Using one account across multiple sites causes traffic mixing and inaccurate analytics.
What should I do if the embed code fails to save?
Copy the code again from the SeaText dashboard. Ensure you paste it into the Embed Code pop-up window. Check that the code is complete and not truncated.
Further reading and comparison sources
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
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.