Learn how Maestra’s on-site JavaScript interacts with search engine crawlers, what Google sees on pages with Maestra installed, and how to keep your Core Web Vitals healthy. Maestra does not modify or replace the content that search engines index on your pages.Documentation Index
Fetch the complete documentation index at: https://help.maestra.io/llms.txt
Use this file to discover all available pages before exploring further.
Before you begin
This article assumes Maestra’s SDK is already installed on your site. If you’re also looking for information on page speed impact, see Maestra’s On-site JavaScript and Page Speed. For details on integration modes (injector, manual div, API), see Site Integration Modes.How Maestra interacts with search crawlers
Maestra’s SDK loads asynchronously and does not alter your page’s HTML, headings, product descriptions, structured data, or internal links. Crawlers see your original page content exactly as your platform (Shopify, your CMS, etc.) serves it. Pop-ups and overlays. These are rendered client-side and triggered by visitor behavior (scroll depth, time on page, exit intent). Crawlers don’t replicate these behaviors, so pop-ups don’t appear during crawling. Your underlying content remains fully visible. Inline widgets and recommendations. These render client-side into designated containers. Google renders JavaScript and can see this content, but it is purely additive — Maestra adds content to your page, it does not replace or hide existing content.Key distinction: Client-side rendering of individual widgets (a recommendation carousel, a promo banner, an embedded form) is not an SEO concern. What would be an SEO problem is rendering your entire product catalog or core page content client-side — because that makes your content dependent on JavaScript for crawlers to see it. Maestra does not do this. It adds localized personalization widgets to pages whose core content is served as HTML by your platform.
Core Web Vitals and Maestra
Maestra’s impact on page speed can indirectly affect your Core Web Vitals scores, which Google uses as a ranking signal. Here’s how each metric is affected:| Metric | What it measures | How Maestra affects it |
|---|---|---|
| LCP (Largest Contentful Paint) | When the main visual element loads | Generally not affected. Maestra loads asynchronously; LCP is typically driven by your own hero image or content. |
| INP (Interaction to Next Paint) | Page responsiveness to interaction | Can be affected by JavaScript execution time. Base SDK is under 100 KB; campaigns load conditionally. Heavy custom markup increases blocking time. |
| CLS (Cumulative Layout Shift) | Unexpected layout shifts | Affected if a Maestra widget appears above the fold without a reserved space. Fix: add a placeholder or fixed-height container in your layout. |
Monitor your SEO-relevant metrics
Google Search Console → Core Web Vitals report. Shows which pages pass or fail based on real user experience data (CrUX). This is the same data Google uses for ranking decisions. PageSpeed Insights (pagespeed.web.dev). Enter your domain and check the “Discover what your real users are experiencing” section for 28-day field data. Google Search Console → URL Inspection Tool. Enter any URL to see how Google rendered it. Confirm your content is visible and Maestra’s widgets haven’t interfered with crawlable elements. Track trends over time. If Core Web Vitals scores change after modifying your Maestra configuration, investigate.Quick reference
| Question | Answer |
|---|---|
| Does Maestra modify my crawlable HTML? | No. HTML, headings, structured data, and links are untouched. |
| Can Google see Maestra’s widgets? | Yes — Google renders JavaScript. Widgets are additive; they don’t replace your content. |
| Is widget-level client-side rendering an SEO risk? | No. Full-page client-side rendering of core content is risky. Maestra only renders widgets client-side. |
| Is there a server-side rendering option? | Yes — Maestra’s API approach renders personalization data in the initial HTML. |
| Does Maestra affect Core Web Vitals? | It can affect CLS (if space isn’t reserved) and INP (via JS execution). See the page speed article for best practices. |