AMP
PT
English Español Français

Make your Web Stories discoverable

Ensure your Web Stories are reaching your intended audience by including necessary metadata and markup.

AMP-specific metadata

Web Stories with missing or incorrect AMP-specific metadata may not surface in search engines or third party platforms.

Required <amp-story> attributes

Web Stories must include the following <amp-story> attributes.

<body>
    <amp-story standalone
    title="Web Story Title"
    publisher="Web Story Publisher"
    publisher-logo-src="https://example.com/logo/1x1.png"
    poster-portrait-src="https://example.com/my-story/poster/3x4.jpg">
    ...
    </amp-story-standalone>
</body>

title

The title of the Web Story.

publisher

The name of the Web Story publisher.

publisher-logo-src

A URL to the Web Story publisher's logo image. The logo image should be larger than or equal to 96x96px and maintain a 1:1 aspect ratio. This logo appears in the right corner on the top of the poster image on platforms currently (October 2020) supporting Web Stories.

poster-portrait-src

A URL to an image used as the Web Story poster. Used as the cover for the Web Story and should be representative of the story. Do not embed or burn-in the Web Story title on it. Should be at least 640x853px and maintain a 3:4 aspect ratio.

Recommended <amp-story> attributes

poster-landscape-src

A URL to an image used as the Web Story poster in landscape format. Used as the cover for the Web Story and should be representative of the story. Do not embed or burn-in the Web Story title on it. Should be at least 853x640px and maintain a 4:3 aspect ratio.

poster-square-src

A URL to an image used as the Web Story poster. Used as the cover for the Web Story and should be representative of the story. Do not embed or burn-in the Web Story title on it. Should be at least 640x640px and maintain a 1:1 aspect ratio.

Metadata

Platforms that surface Web Stories rely on metadata to correctly index and display them. Include the following recommended information to give users a delightful Web Story experience.

Include the following recommended HTML markup in your Web Stories for the best user experience.

All Web Stories must include a canonical URL that points to the Web Story itself.

<link rel="canonical" href="https://www.example.com/url/to/Web/Story.html">

favicon

Include a favicon to display as the icon in the browser tab.

Document title

Give your Web Story document a title by including a </a></code> tag.</p> <h2 id="image-alt-text">Image alt-text</h2> <p>Maximize accessibility and indexability by including <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#Accessibility_concerns">meaningful alt-text for images</a>.</p> <h2 id="video-subtitles-and-captions">Video subtitles and captions</h2> <p>Maximize accessibility and indexability by including <a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video">video subtitles and/or captions</a>.</p> <h2 id="page-attachments">Page attachments</h2> <p>Use <a href="https://amp.dev/documentation/components/amp-story-page-attachment/">page attachments</a> to present additional information in “classic article form” alongside your Web Story. This can be useful to provide extra detail, deep dives, or onward journeys for the content presented in your Story.</p> <h2 id="schema.org-metadata">Schema.org metadata</h2> <p>Including <a href="https://schema.org/">schema.org</a> structured data vocabulary defines important information about your Web Story that allows third-party platforms, such as search engines, to display and index them.</p> <p> <div class="ap-m-tip"> <div class="ap-a-ico ap-m-tip-icon"> <svg><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#speech-bubble"></use></svg> </div> <div class="ap-m-tip-content"> Validate your schema.org data using Google's <a href="https://search.google.com/test/amp">AMP Test</a>. </div> </div></p> <h2 id="ogp-facebook-metadata">OGP Facebook metadata</h2> <p>Including <a href="https://ogp.me/">Open Graph protocol</a> enables Web Stories sharing on Facebook.</p> <h2 id="twitter-card-data">Twitter card data</h2> <p>Including <a href="https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards">Twitter card data</a> allows you to attach photos, videos and media experiences to a Tweet sharing your Web Story.</p> <p> <div class="ap-m-tip"> <div class="ap-a-ico ap-m-tip-icon"> <svg><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#bookmark"></use></svg> </div> <div class="ap-m-tip-content"> Read more about <a href="https://blog.amp.dev/2020/02/12/seo-for-amp-stories/">SEO for Web Stories in the AMP Blog</a>. </div> </div></p> </section> <section class="ap--content"> <hr> <ul class="ap-o-mini-card-list"> <li class="ap-o-mini-card-list-item"> <div class="ap-m-mini-card"> <amp-img alt="Author avatar" src="https://github.com/CrystalOnScript.png?size=38" width="38" height="38" class="large" style="max-width: 38px" layout="responsive"> </amp-img> <span> <strong>Written by <a href="https://github.com/CrystalOnScript" rel="nofollow" target="_blank"> @CrystalOnScript </a> </strong> </span> </a> </li> </ul> </section> </div> </main> <amp-sidebar id="sidebar-left" class="ap--ampsidebar" layout="nodisplay" side="left"> <nav class="ap--ampsidebar-toolbar" toolbar="(min-width: 768px)" toolbar-target="ap--sidebar-content"> <ul> <div class="ap-m-format-toggle"> <button class="ap-m-format-toggle-selected ap-m-format-toggle-link-stories"> <span class="ap-a-ico"> <svg><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#amp-stories"></use></svg> </span> <span>stories</span> <span class="ap-a-ico ap-m-format-toggle-angle"> <svg><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-solid"></use></svg> </span> </button> <div class="ap-m-format-toggle-formats"> <a class="ap-m-format-toggle-link ap-m-format-toggle-link-websites" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/discovery_web_stories/?format=websites"> <span class="ap-a-ico"> <svg><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#amp-websites"></use></svg> </span> <span>websites</span> </a> <a class="ap-m-format-toggle-link ap-m-format-toggle-link-ads" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/discovery_web_stories/?format=ads"> <span class="ap-a-ico"> <svg><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#amp-ads"></use></svg> </span> <span>ads</span> </a> <a class="ap-m-format-toggle-link ap-m-format-toggle-link-email" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/discovery_web_stories/?format=email"> <span class="ap-a-ico"> <svg><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#amp-email"></use></svg> </span> <span>email</span> </a> </div> </div> <div class="ap-o-sidebar-default"> <div class="ap-o-sidebar"> <div class="nav"> <ul class="nav-list level-1"> <li class="nav-item level-1"> <span class="nav-link"> <span>Iniciar</span> </span> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-solid"></use></svg> </div> <ul class="nav-list level-2"> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/"> <span>Criar uma história visual com</span> <span class="nav-link-lastword">AMP<svg class="ap-a-ico nav-type-icon"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#tutorial"></use></svg></span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/create_bookend/"> Criação do bookend </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/setting_up/"> Setting up </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/parts_of_story/"> Understanding the parts of an AMP story </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/start_story/"> Iniciando nossa história </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/create_cover_page/"> Creating the cover page </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/add_more_pages/"> Adding more pages </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/animating_elements/"> Animação de elementos </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/validation/"> Validando o seu AMP HTML </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/visual_story/congratulations/"> Congratulations! </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/start/create_successful_stories/"> Melhores práticas para criar uma História Web de sucesso </a> </li> <li class="nav-item-tutorial-divider"></li> </ul> </li> <li class="nav-item level-1"> <span class="nav-link"> <span>Aprender</span> </span> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-solid"></use></svg> </div> <ul class="nav-list level-2"> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-actions-and-events/"> Ações e eventos </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/common_attributes/"> Atributos comuns </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/webstory_technical_details/"> Detalhes técnicos para Histórias Web </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/experimental/"> Recursos experimentais </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-html-layout/"> <span>AMP's Layout System</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-html-layout/"> Sistema de layout do AMPHTML </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-html-layout/layouts_demonstrated/"> Demonstrating AMP layouts </a> </li> </ul> </li> <li class="nav-item level-2"> <span class="nav-link"> <span>Fluxo de trabalho de validação</span> </span> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/validation-workflow/validation_errors/"> Erros de validação das AMP </a> </li> </ul> </li> <li class="nav-item level-2"> <span class="nav-link"> <span>Caches de AMP e CORS</span> </span> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-caches-and-cors/amp-cors-requests/"> CORS in AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-caches-and-cors/how_amp_pages_are_cached/"> Como páginas AMP são armazenadas em cache </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-caches-and-cors/amp-cache-debugging/"> Depuração de problemas de cache do AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/learn/amp-caches-and-cors/amp-cache-urls/"> Formato da URL do Cache do AMP e tratamento de solicitações </a> </li> </ul> </li> </ul> </li> <li class="nav-item level-1"> <span class="nav-link"> <span>Desenvolver</span> </span> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-solid"></use></svg> </div> <ul class="nav-list level-2"> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/style_and_layout/"> <span>Estilo e layout</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/style_and_layout/style_pages/"> CSS compatível </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/style_and_layout/control_layout/"> Consultas de mídia e layout </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/style_and_layout/placeholders/"> Placeholders e fallbacks </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/style_and_layout/art_direction/"> Responsive images with srcset, sizes & heights </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/style_and_layout/responsive_design/"> Criar páginas AMP responsivas </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/style_and_layout/custom_fonts/"> Add custom fonts </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/media_iframes_3p/"> <span>Include media, iframes & third-party content</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/media_iframes_3p/"> Incluir imagens e vídeo </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/advertise_amp_stories/"> Anuncie em histórias Web </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/develop/story_ads_best_practices/"> Melhores práticas para criar um anúncio de História Web </a> </li> <li class="nav-item-tutorial-divider"></li> </ul> </li> <li class="nav-item level-1"> <span class="nav-link"> <span>Integrar</span> </span> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-solid"></use></svg> </div> <ul class="nav-list level-2"> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/integrate/web-story-player-guide/"> Creating Web Story experiences using the Web Story Player on non-AMP sites </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/integrate/embed-stories/"> Incorpore histórias em páginas web </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/integrate/embed-stories-nonamp/"> Integrate Web Stories in non-AMP pages </a> </li> </ul> </li> <li class="nav-item active level-1"> <span class="nav-link"> <span>Otimizar e medir</span> </span> <input class="nav-trigger" type="checkbox" checked/> <div class="nav-icon"> <svg class="ap-a-ico"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-solid"></use></svg> </div> <ul class="nav-list level-2"> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/configure-analytics/"> <span>Configurar Analytics</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/configure-analytics/analytics-vendors/"> Fornecedores de análise </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/configure-analytics/analytics_basics/"> Analytics: the basics </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/amp-optimizer-guide/"> <span>Using an AMP Optimizer</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/amp-optimizer-guide/explainer/"> Como funciona um Otimizador AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/amp-optimizer-guide/node-amp-optimizer/"> Guia do Otimizador AMP do Node.js </a> </li> </ul> </li> <li class="nav-item active level-2" autoscroll> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/discovery_web_stories/"> Make your Web Stories discoverable </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/optimize_amp/"> Otimize suas páginas AMP hospedadas </a> </li> <li class="nav-item-tutorial-divider"></li> <li class="nav-item-tutorial-divider"></li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/optimize-and-measure/tracking-engagement/"> Como configurar análises básicas para suas páginas AMP <svg class="ap-a-ico nav-type-icon"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#tutorial"></use></svg> </a> </li> </ul> </li> <li class="nav-item level-1"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/"> <span>Contribute</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-solid"></use></svg> </div> <ul class="nav-list level-2"> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/"> How to contribute </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/contribute-documentation/"> <span>Contribute documentation</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/contribute-documentation/documentation-types/"> Tipos de documentação </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/contribute-documentation/terminology/"> Terminologia do AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/contribute-documentation/formatting/"> Formatting guides & tutorials </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/integrate-your-analytics-tools/"> Integre a sua ferramenta de análise com o AMP </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/vendor-contributions/"> <span>Third party contributions</span> </a> <input class="nav-trigger" type="checkbox"/> <div class="nav-icon"> <svg class="ap-a-ico light"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#angle-down-light"></use></svg> </div> <ul class="nav-list level-3"> <li class="nav-item level-3"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/vendor-contributions/release-schedule/"> Release Schedule </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/pt_br/documentation/guides-and-tutorials/contribute/translations/"> Contribute translations </a> </li> </ul> </li> </ul> </div> </div> </div> </ul> </nav> </amp-sidebar> <aside class="ap-o-translation-hint"> <p class="ap-o-translation-hint-wrapper">Sadly this page isn't translated yet, but will be shortly - check back soon!</p> </aside> <amp-install-serviceworker src="/serviceworker.js" data-iframe-src="https://challangerdeep.netlify.app/serviceworker.html" layout="nodisplay"></amp-install-serviceworker> </body> </html>