Skip to content
polar-commerce
← GEO

Voice AI a Shopify — speakable schema krok po kroku

Voice AI (Alexa, Siri, Google Assistant, ChatGPT Voice) używa speakable schema do wyboru passażu czytanego głosowo. Pełny przewodnik wdrożenia na Shopify.

Mateusz Śnieżek, Shopify Expert

Speakable schema to property w schema.org Article/WebPage, który mówi voice AI assistants: "te elementy strony są optimal do czytania głosowo". Voice AI (Google Assistant, Siri, Alexa, ChatGPT Voice w 2026) używa speakable do wyboru passażu w odpowiedziach voice. Bez speakable, voice AI sam wybiera passaż — często sub-optimal. Implementation na Shopify zajmuje 30 minut.

Czym jest speakable

Schema.org \`SpeakableSpecification\` definiuje:

  • cssSelector — które elementy DOM (h1, h2, .answer, .lead) są speakable
  • xpath — alternative selector (rzadko używane)
  • Voice AI fetchuje stronę, parsuje schema, znajduje speakable selectors, czyta TYLKO te elementy. Reszta strony jest ignorowana voice-side.

    Po co to robić

    W 2026 roku voice AI to ~15% wszystkich AI search interactions (rosnące, accelerating z embedded AI w smartfonach, AirPods Pro voice ChatGPT, Apple Intelligence on-device). Dla brand recognition w voice mode, speakable to direct way to control jaki passaż reprezentuje stronę.

    Bez speakable: voice AI wybiera pierwsze 50 słów lub random heading.

    Ze speakable: voice AI czyta wybrany lead lub direct-answer.

    Pełny snippet speakable dla Shopify

    W product.liquid lub article.liquid:

    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Article",
      "headline": {{ article.title | json }},
      "speakable": {
        "@type": "SpeakableSpecification",
        "cssSelector": ["h1", ".lead-paragraph", ".faq-answer"]
      }
    }
    </script>

    Lub jako standalone WebPage schema:

    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebPage",
      "speakable": {
        "@type": "SpeakableSpecification",
        "cssSelector": [".product-title", ".product-description-lead"]
      }
    }
    </script>

    Best practices speakable selectors

    SelectorCo czyta voice AI
    h1Tytuł produktu / artykułu
    h2Sekcje pillarowych artykułów
    .lead-paragraphPierwsze 60 słów (direct-answer lead)
    .product-descriptionGłówny opis na PDP
    .faq-answer (każdy)Odpowiedzi w FAQ section
    .summarySummary box w how-to articles

    Avoid:

  • Selectors z dynamicznym ID (np. #review-12345)
  • Selectors w iframe
  • Selectors z visibility: hidden lub display: none
  • Podstawowy CSS class setup

    W theme musisz dodać className do elementów. W product.liquid:

    <h1 class="product-title">{{ product.title }}</h1>
    <div class="product-description-lead">
      {{ product.description | strip_html | truncate: 200 }}
    </div>

    W article.liquid:

    <p class="lead-paragraph">{{ article.content | strip_html | split: '</p>' | first | append: '</p>' }}</p>

    Walidacja

  • Schema.org Validator (validator.schema.org) — sprawdza syntax
  • Google Rich Results Test — Speakable jest part of Article schema validation
  • Manual voice test — "Hey Google, search for [your brand product]" — sprawdź co czyta
  • Voice AI sources w 2026

    Voice AIWykorzystanie speakable
    Google AssistantNative (rolled out 2018+)
    Siri (iOS 18+)Z ChatGPT integration
    AlexaCzęściowe (depending on skill)
    ChatGPT VoicePartial — używa direct-answer leady
    BixbyLimited
    Apple IntelligenceNowe w 2025–2026, używa speakable

    Najczęstsze błędy

    BłądSkutek
    Speakable selector dla niewidocznego elementuVoice AI nie czyta (lub nieprzewidywalne)
    Selector wskazuje całą stronę (body)Voice AI czyta zbyt długo
    Brak speakable na pillarachVoice AI sam wybiera, suboptimal
    Selector z high CSS specificityMoże być nadpisany
    Speakable na pages bez głównego contentVoice AI confused

    Najczęściej zadawane pytania

    Czy speakable wpływa na AI Mention Share?

    Nie bezpośrednio. Speakable to voice-specific. Wpływa na voice mention share, który jest 10–20% total AI mention share dla większości brandów (rośnie).

    Czy każda strona powinna mieć speakable?

    Nie. Top 20 pillarów + top 20 PDP = wystarczy dla 90% voice traffic. Pages bez heavy text content (login, checkout) — nie potrzeba.

    Co z multilingual sklepami?

    Speakable jest language-agnostic w schema, ale CSS selectors muszą wskazywać poprawne elementy w każdym locale. Same selectors działają cross-locale.

    Czy Apple Siri rzeczywiście używa speakable?

    Z iOS 18+ tak, przez ChatGPT integration. Pre-iOS 18 Siri używa Apple Knowledge sources, gdzie speakable nie ma rolę.

    Jak monitorować voice AI traffic?

    GA4 referrer trochę pomaga (chat.openai.com może być voice lub text), ale nie ma clean voice signal. Najczęściej: trend AI Mention Share + manual voice testing 1×/mies.

    Czy speakable pomaga w klasycznym SEO?

    Nie bezpośrednio. To voice-specific. Ale Article schema (zawierający speakable) ma rich snippets w SERPs, więc indirect benefit.

    Co jeśli theme nie pozwala na custom CSS classes?

    Albo (1) edit theme bezpośrednio, (2) przejdź na theme z Online Store 2.0 (gdzie sections wspierają custom block classes), (3) użyj aplikacji Schema App / JSON-LD for SEO które inject speakable.