AMP
FR
English Español Português

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="/fr/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="/fr/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="/fr/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>Commencer</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="/fr/documentation/guides-and-tutorials/start/visual_story/"> <span>Create your first Web</span> <span class="nav-link-lastword">Story<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="/fr/documentation/guides-and-tutorials/start/visual_story/setting_up/"> Configuration </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/parts_of_story/"> Comprendre les parties d'une story AMP </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/start_story/"> Démarrons notre story </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/create_cover_page/"> Création de la page de garde </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/add_more_pages/"> Ajouter plus de pages </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/animating_elements/"> Animation d'éléments </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/create_bookend/"> Création du serre-livre </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/validation/"> Valider votre code HTML AMP </a> </li> <li class="nav-item level-3"> <div class="ap-m-tutorial-progress "></div> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/visual_story/congratulations/"> Félicitations ! </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/start/create_successful_stories/"> Bonnes pratiques pour réussir la création d'une story Web </a> </li> <li class="nav-item-tutorial-divider"></li> </ul> </li> <li class="nav-item level-1"> <span class="nav-link"> <span>Apprendre</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="/fr/documentation/guides-and-tutorials/learn/amp-actions-and-events/"> Actions et événements </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/learn/common_attributes/"> Attributs d'élément communs </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/learn/webstory_technical_details/"> Détails techniques des stories Web </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/learn/experimental/"> Activer les fonctionnalités expérimentales </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/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="/fr/documentation/guides-and-tutorials/learn/amp-html-layout/"> Système de mise en page AMPHTML </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/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>Flux de validation</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="/fr/documentation/guides-and-tutorials/learn/validation-workflow/validate_amp/"> Valider les pages AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/learn/validation-workflow/validation_errors/"> Erreurs de validation AMP </a> </li> </ul> </li> <li class="nav-item level-2"> <span class="nav-link"> <span>Caches AMP & 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="/fr/documentation/guides-and-tutorials/learn/amp-caches-and-cors/how_amp_pages_are_cached/"> Comment les pages AMP sont mises en cache </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/learn/amp-caches-and-cors/amp-cache-debugging/"> Déboguer les problèmes de cache AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/learn/amp-caches-and-cors/amp-cache-urls/"> Format d'URL du cache AMP et traitement des demandes </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/learn/amp-caches-and-cors/amp-cors-requests/"> CORS avec AMP </a> </li> </ul> </li> </ul> </li> <li class="nav-item level-1"> <span class="nav-link"> <span>Développer</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="/fr/documentation/guides-and-tutorials/develop/style_and_layout/"> <span>Créer des pages AMP responsives</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="/fr/documentation/guides-and-tutorials/develop/style_and_layout/style_pages/"> CSS compatibles </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/develop/style_and_layout/control_layout/"> Mises en page compatibles </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/develop/style_and_layout/placeholders/"> Caractères de remplacement et solutions de secours </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/develop/style_and_layout/art_direction/"> Images interactives avec les attributs srcset, sizes et heights </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/develop/style_and_layout/responsive_design/"> Comment créer des pages AMP interactives </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/develop/style_and_layout/custom_fonts/"> Comment ajouter des polices personnalisées </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/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="/fr/documentation/guides-and-tutorials/develop/media_iframes_3p/"> Ajouter des images et vidéos </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/develop/advertise_amp_stories/"> Annonces dans les stories Web </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/develop/story_ads_best_practices/"> Bonnes pratiques pour créer une story publicitaire Web </a> </li> <li class="nav-item-tutorial-divider"></li> </ul> </li> <li class="nav-item level-1"> <span class="nav-link"> <span>Intégrer</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="/fr/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="/fr/documentation/guides-and-tutorials/integrate/embed-stories/"> Intégrer des stories dans des pages Web </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/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>Optimiser et mesurer</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="/fr/documentation/guides-and-tutorials/optimize-and-measure/configure-analytics/"> <span>Configuration d'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="/fr/documentation/guides-and-tutorials/optimize-and-measure/configure-analytics/analytics-vendors/"> Analytics Vendors </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/optimize-and-measure/configure-analytics/analytics_basics/"> Analytics: principes de base </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/optimize-and-measure/configure-analytics/deep_dive_analytics/"> Deep dive into AMP analytics </a> </li> </ul> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/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="/fr/documentation/guides-and-tutorials/optimize-and-measure/amp-optimizer-guide/explainer/"> Comment fonctionne un optimiseur AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/optimize-and-measure/amp-optimizer-guide/node-amp-optimizer/"> Guide de l'optimisation AMP Node.js </a> </li> </ul> </li> <li class="nav-item active level-2" autoscroll> <a class="nav-link" href="/fr/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="/fr/documentation/guides-and-tutorials/optimize-and-measure/optimize_amp/"> Comment optimiser vos pages AMP hébergées </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="/fr/documentation/guides-and-tutorials/optimize-and-measure/tracking-engagement/"> Comment configurer des analyses basiques pour vos pages 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="/fr/documentation/guides-and-tutorials/contribute/"> <span>Participer</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="/fr/documentation/guides-and-tutorials/contribute/"> Comment contribuer </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/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="/fr/documentation/guides-and-tutorials/contribute/contribute-documentation/documentation-types/"> Types de documentation </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/documentation/guides-and-tutorials/contribute/contribute-documentation/terminology/"> Terminologie AMP </a> </li> <li class="nav-item level-3"> <a class="nav-link" href="/fr/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="/fr/documentation/guides-and-tutorials/contribute/integrate-your-analytics-tools/"> Comment intégrer votre outil d'analyse à AMP </a> </li> <li class="nav-item level-2"> <a class="nav-link" href="/fr/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="/fr/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="/fr/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>