AMP by Example

Introduction
Introduction

Components
Components

Advanced
Advanced

Samples & Templates
Samples & Templates

AMP for Ads (A4A)
AMP for Ads (A4A)

View Source

Hello World

Introduction

An AMP HTML tutorial - learn the different building blocks of an AMP HTML file. AMP HTML is entirely built on existing web technologies. It achieves reliable performance by restricting some parts of HTML, CSS and JavaScript. To make up for those limitations AMP HTML defines a set of custom elements for rich content beyond basic HTML. This samples shows what's necessary to create a valid AMP HTML file.

<!doctype html>

This tells everyone that this is an AMP file. <html amp> works too.

<html ⚡>
<head>

The charset definition must be the first child of the <head> tag.

  <meta charset="utf-8">

The AMP runtime must be loaded as the second child of the <head> tag.

  <script async src="https://cdn.ampproject.org/v0.js"></script>

AMP HTML files require a canonical link pointing to the regular HTML. If no HTML version exists, it should point to itself.

  <link rel="canonical" href="https://ampbyexample.com/Introduction/Hello_World">
  <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">

CSS must be embedded inline.

  <style amp-custom>
    h1 {
      color: red;
    }
  </style>

The AMP boilerplate.

  <style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript>
</head>

Body

<body>

Most HTML tags can be used directly in AMP HTML.

  <h1>Hello World!</h1>

Hello World!

Certain tags, such as the <img> tag, are replaced with equivalent or slightly enhanced custom AMP HTML tags (see HTML Tags in the specification).

You can use the AMP Validator to check if your AMP HTML file is valid AMP HTML. Simply add #development=1 to an AMP URL. Validation errors will be printed in the Javascript console. You can try it with this website which is build with AMP.

Check out the other examples to learn more about AMP.

  <amp-img src="/img/amp.jpg"
      width="1080"
      height="610"
      layout="responsive"></amp-img>
</body>
</html>