Share via

How do I apply Azure AI Immersive Reader

sharon j 0 Reputation points
2025-08-29T02:41:28.2233333+00:00

Hi everyone,

I’m trying to integrate Azure AI Immersive Reader into three of my websites:

globaltaxidermymounts.org

imafungi.org

soursop.farm

My goal is to make the sites more accessible by adding Immersive Reader tools like read-aloud, translation, focus mode, and text highlighting.

I’ve already reviewed the Azure documentation, but I still have a few questions:

Setup Across Multiple Sites – Should I use one Immersive Reader resource across all three domains, or is it better to create a separate resource for each site?

Global Integration – What’s the best way to make the Immersive Reader button appear on every page of a site (e.g., via shared layout templates, footer scripts, or plugins)?

Dynamic Content – How can I ensure that Immersive Reader picks up dynamically loaded content (like galleries or blog posts) instead of just static HTML?

Token Management – Is it best practice to reuse tokens or generate them on-demand for performance and cost efficiency?

Search & Customization – Can the Immersive Reader be configured to only read/search certain fields (like name or ID), or does it always capture the whole page content?

If anyone has done this before, I’d love to see code examples, setup tips, or best practices.

Thanks in advance for the help!

Azure AI Immersive Reader
Azure AI Immersive Reader
An Azure Applied AI Service that embeds text reading and comprehension capabilities into your applications.
0 comments

1 answer

Sort by: Most helpful
Most helpful Newest Oldest
  1. Gowtham CP 6,030 Reputation points Volunteer Moderator
    2025-08-29T07:22:14.7+00:00

    Hi sharon j ,

    Thanks for reaching out on the Microsoft Q and A.

    1. Setup Across Sites One Azure Immersive Reader resource is enough. Use separate resources only if you need different billing, permissions, or analytics.

    2. Global Integration Add the Immersive Reader button in a shared layout (header, footer, or base template) so it appears on every page.

    3. Dynamic Content Pass the content you want read into immersiveReader.launchAsync(). For blogs, galleries, or other dynamic sections, grab the text from the DOM or data source each time.

    4. Token Management Generate tokens on-demand from your backend. Tokens are short-lived (~10 minutes) and shouldn’t be reused.

    5. Search & Customization Immersive Reader only reads what you send. You can choose specific fields (like title, body, ID) rather than the whole page.

    References

    Quickstart: Use Immersive Reader

    launchAsync API

    Token creation

    Hope this helps! If it does, please upvote and mark as accepted to close the thread. Thanks!

    0 comments

Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.