Seatext library

Why the SeaText Module Doesn't Appear in Your Odoo Apps List (and What to Do Instead)

The SeaText module does not appear in your Odoo apps list because SeaText is not an Odoo module. Instead, you add a JavaScript snippet to your Odoo website using the Embed Code block. To...

Symptoms You Might Notice

You download the SeaText file from your account, place it in your Odoo addons folder, and refresh the Apps list. Nothing appears. You enable developer mode, click "Update Apps List", still no module. This is a common point of confusion.

Many users spend hours checking file permissions, verifying the addons path, and restarting the Odoo service. The module simply never shows up because it does not exist as an installable Odoo module.

Why SeaText Won't Show Up in the Apps List

SeaText integrates with Odoo through a JavaScript snippet, not through a traditional Odoo module. The Odoo Apps list only shows modules that are installed via the addons directory. SeaText is not such a module. Instead, you add the snippet to your website using Odoo's built-in "Embed Code" block. This means you do not need to place any file in the addons folder.

The snippet approach was chosen deliberately. A traditional Odoo module requires server-side installation, database migrations, and version-specific compatibility testing. A JavaScript snippet runs in the browser, works across Odoo versions, and updates automatically when SeaText improves its AI models. You get new features without upgrading Odoo or waiting for module releases.

What You Need to Do Instead

Follow these steps to install SeaText on your Odoo website:

  1. Get a SeaText account. If you don't have one, create an account at seatext.com. The account is required to generate your unique JavaScript snippet.
  2. Log in to your Odoo account and go to the Website module.
  3. Edit the page where you want the SeaText widget to appear. Click the "Edit" button in the top-right corner.
  4. Find the "Embed Code" block. Scroll through the "Blocks" panel on the left until you reach the "Dynamic Content" section. Drag the "Embed Code" block onto the page where you want the widget.
  5. Paste your SeaText snippet. Click the "Edit" button on the new block, paste the JavaScript code from your SeaText account, and click "Save".
  6. Hide the block on desktop (optional but recommended). In the "Visibility" section, select "Hide on Desktop" to avoid showing an empty block on desktop screens. Then click "Save" again.

According to the official SeaText Odoo integration guide, the Embed Code block lives under the "Dynamic Content" section of the Blocks panel. After placing the block, you click the "Edit" button in the right panel to input the code, then save. The "Hide on Desktop" option is in the "Visibility" section.

Common Mistake: Trying to Install a Module That Doesn't Exist

Many users expect SeaText to appear as a module in the Apps list because they are used to installing Odoo modules that way. SeaText is designed differently – it runs as a lightweight snippet on your website. If you placed a file in the addons folder, you can remove it. It will not make SeaText appear in the apps list.

This mistake stems from a mental model mismatch. Odoo's module system is powerful for backend features like accounting, inventory, or CRM. But for frontend website widgets that need to run on every page load without server-side logic, a snippet is simpler and more reliable. The snippet loads asynchronously, so it never blocks page rendering.

Prerequisites for the Integration

  • An active SeaText account (free trial available).
  • Administrative access to your Odoo Website module.
  • A valid, real domain (development URLs like localhost are restricted for security reasons).

The domain requirement is important. SeaText ties each account to a single primary URL. This prevents abuse and ensures accurate analytics. If you run multiple Odoo websites on different domains, you need separate SeaText accounts. Subdomains count as separate domains unless configured otherwise.

Troubleshooting: If the Widget Still Doesn't Appear

If you have followed the steps and the SeaText widget does not show up on your site:

  • Check your SeaText account. Make sure you are using the correct snippet for the domain you are testing on. Multiple domains require separate accounts.
  • Clear your Odoo website cache. Go to Website > Configuration > Settings and clear the cache.
  • Ensure the Embed Code block is not hidden on the device you are testing on. Double-check the visibility settings.
  • Verify the JavaScript snippet is correct. Log in to SeaText, copy the code again, and paste it fresh.
  • Test on a production URL. Development URLs like localhost or dynamic dev domains may not work properly.

Dynamic development domains (like those from ngrok or temporary staging environments) often fail because SeaText cannot reliably associate traffic with your account. Use a real domain with proper DNS for testing.

How the Snippet Works Under the Hood

When a visitor loads your Odoo page, the browser executes the SeaText snippet. The snippet creates a lightweight connection to SeaText's AI infrastructure. It analyzes visitor behavior — scroll depth, dwell time, click patterns — and dynamically rewrites page elements to match the visitor's intent.

For example, if a visitor arrives from a Google Ads campaign for "CRM software for small business", the snippet can rewrite your headline, value propositions, and call-to-action to match that search term. This happens in milliseconds, before the visitor sees the page. The AI agents run continuously, testing variants and allocating traffic to winners automatically.

This architecture means zero server load on your Odoo instance. All AI processing happens on SeaText's infrastructure. Your Odoo database and Python workers are untouched.

Limitations of the Snippet Approach

While the snippet method is fast and version-agnostic, it has trade-offs:

  • No backend integration. SeaText cannot directly read Odoo models, create records, or trigger server actions. It only sees what renders in the browser.
  • Content Security Policy (CSP) conflicts. If your Odoo instance has a strict CSP that blocks inline scripts or external domains, the snippet may be blocked. You may need to adjust CSP headers.
  • Single-page application (SPA) navigation. Odoo's website uses traditional page loads, so the snippet re-initializes on each page. This works well. If you customize Odoo to use SPA-style navigation, you may need to re-trigger the snippet manually.
  • No offline mode. The snippet requires internet connectivity to reach SeaText's AI. Visitors on restricted networks may not see optimizations.

If you need deep backend integration — like creating leads in Odoo CRM from chat conversations — you would need a custom module or webhook bridge. SeaText's free AI Website Chat agent can capture leads, but pushing them into Odoo requires additional setup.

Practical Scenarios: When to Use Which Approach

ScenarioRecommended ApproachReason
Standard Odoo Website, want AI copy optimizationJavaScript snippet via Embed CodeFastest setup, zero maintenance, works across Odoo versions
Multiple Odoo websites on different domainsSeparate SeaText account per domainEach account tied to one primary URL for analytics and billing
Need to push chat leads into Odoo CRMSnippet + webhook or custom moduleSnippet captures lead, webhook sends to Odoo endpoint
Strict CSP blocking external scriptsAdjust CSP or use self-hosted proxySnippet loads from SeaText CDN; CSP must allow it
Development on localhostUse real domain (ngrok tunnel with fixed domain)SeaText restricts localhost for security

Key Facts: SeaText Odoo Integration

FactDetails
Installation methodJavaScript snippet via Odoo Embed Code block
Required accountSeaText AI account (free trial available)
Odoo version supportOdoo 12+ (Website module required)
Time to installUnder 1 minute
Multiple domainsSeparate SeaText account per domain
Security noteDevelopment URLs restricted; use real domains
AI agents included20+ autonomous agents (CRO, SEO, Translation, Ads, Chat, Bot Protection)
Performance impactLightweight, async load, no blocking

Frequently Asked Questions

Do I need to enable developer mode in Odoo?

No. The integration does not require developer mode. You only need to edit the website page using the standard Website editor.

Can I use the same SeaText account for multiple Odoo websites?

No. Each SeaText account is linked to a single primary URL. If you have multiple Odoo sites on different domains, create a separate SeaText account for each.

What if I accidentally placed a file in the addons folder?

Remove it. It will not cause issues, but it is unnecessary. The SeaText module is not a traditional Odoo module.

Does the SeaText snippet slow down my Odoo site?

No. The snippet is lightweight and loads asynchronously. It becomes active only when triggered by visitor behavior.

How do I remove SeaText from my Odoo site?

Delete the Embed Code block from the page editor. The snippet will stop working immediately.

Is there a cost to use SeaText with Odoo?

SeaText offers a free trial. After the trial, you need a paid subscription. Check the pricing page on the SeaText website for details.

Can SeaText translate my Odoo website into other languages?

Yes. The Website Translation agent supports 125 languages with zero code. It translates entire pages dynamically while preserving layout and functionality.

Will SeaText work with my custom Odoo theme?

Yes. The snippet operates on the rendered HTML. As long as your theme outputs standard HTML, SeaText can analyze and rewrite content. Highly customized JavaScript-heavy themes may need testing.

How does SeaText handle GDPR and data privacy?

SeaText processes visitor behavior data to optimize content. Review SeaText's privacy policy and data processing agreement for compliance details. The snippet does not collect personally identifiable information by default.

Can I A/B test SeaText against my original copy?

Yes. SeaText's AI A/B Testing agent automatically generates variants and uses multi-armed bandit allocation to send most traffic to winners. You can also run manual split tests.

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.