Make your Web Stories discoverable
Important: this documentation is not applicable to your currently selected format websites!
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.
Canonical link
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.