How do I apply Azure AI Immersive Reader

sharon j 0 Reputation points

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!

0 comments No comments
Sign in to comment

1 answer

  1. Gowtham CP 7,960 Reputation points • Volunteer Moderator

    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 No comments
    Sign in to comment
Sign in to answer

Your answer