AMP
  • email

Article Bookmark Email

Introduction

This sample demonstrates how to let users perform an asynchronous action (bookmarking an article) in an AMP email.

It leverages the amp-form extension to send a request to the server without the user leaving their e-mail client.

Setup

Additionally used AMP components must be imported in the header. We use

amp-form to submit bookmark requests to the server.

<script async custom-element="amp-form" src="https://cdn.ampproject.org/v0/amp-form-0.1.js"></script>

We use amp-mustache to render the result of a form submission.

<script async custom-template="amp-mustache" src="https://cdn.ampproject.org/v0/amp-mustache-0.2.js"></script>

Body

We display a simple summary of the article in the email.

Sample article

This is a short summary of a sample article. The user can choose to continue reading on the website or bookmark it to their account for later.

<div>
  <h1>Sample article</h1>
  <p>This is a short summary of a sample article. The user can choose to continue reading on the website or bookmark it to their account for later.</p>
</div>

We show a "bookmark" button under the article, which sends a bookmark request to the server asynchronously via amp-form.

Because there is no authentication for outgoing XHR calls from AMP email messages, all authentication should be done using access tokens.

In this example, this token is represented with 123abc. In a real-life scenario, this hidden input field auth_token would contain a real server-side validated limited-use access token.

An error occurred.
<div>
  <form action-xhr="https://amp.dev/documentation/examples/interactivity-dynamic-content/article_bookmark_email/submit-form-bookmark"
    method="post">
    <input type="hidden"
      name="id"
      value="ARTICLE_UNIQUE_ID">
    <input type="hidden"
      name="auth_token"
      value="123abc">
    <button type="submit">
      Bookmark
    </button>
    <div submit-success>
      <template type="amp-mustache">
        {{result}}
      </template>
    </div>
    <div submit-error>An error occurred.</div>
  </form>
</div>
Need further explanation?

If the explanations on this page don't cover all of your questions feel free to reach out to other AMP users to discuss your exact use case.

Go to Stack Overflow
An unexplained feature?

The AMP project strongly encourages your participation and contributions! We hope you'll become an ongoing participant in our open source community but we also welcome one-off contributions for the issues you're particularly passionate about.

Edit sample on GitHub