APL Detail Page

You use the detail template to display more information and actions about a single item, such as a person, place, product, thing, or event. The overall layout contains an image on one side and text content on the other. This format shows more information on-screen with a short voice synopsis.

Detail template

How to use detail templates

Detail templates contain the following elements, which are numbered to correspond to the screenshot that follows:

1. Header

Includes a title, navigation, and attribution.

2. Primary text

Top-level information, such as the name of a movie, recipe, contact, or location.

3. Secondary text

Additional details about the item.

4. Buttons

Actions the user can take.

5. Image

Photos or artwork of contacts, restaurants, recipes, or movies.

6. Image text

Captioned information about the image.

The following screenshot shows the location of the six elements in the template.

Types of detail templates

You have four detail templates to choose from:

  • Generic
  • Movies and TV
  • Location
  • Recipe

Generic

You can use the generic detail template for a wide range of items. You can provide optional body text for greater detail, if needed.

Movie and TV

The movies and TV detail template provides more information about movies, TV series, releases, and show times. You can use metadata to display content ratings and other details, such as plot, director, and actors. You have the option to add body text to provide a longer summary.

Buttons can trigger an action to play a video, add to watch list, or display movie show times.

Location

Use the location detail template to provide information about a place, such as a business or restaurant. The template includes the address and ratings components.

Buttons can trigger an action to make a phone call or get directions.

Recipe

The recipe detail template provides recipe information, including a list of ingredients and ratings. The template also includes a jumping off point for step-by-step directions in a list format with ordinal numbers.

Buttons can trigger an action to add ingredients to a shopping list or save a recipe.

Best practices

  • The response has rich, detailed information and actions related to a single item.
  • The user has focused on a single item from a list.
  • The user’s request resulted in a list that has only one match.
  • There are multiple actions available related to an item, such as add to cart, favorite, see show times, etc.
  • Where possible, include a relevant image as the primary metadata. You can place images on the left or right side. When you can't find a relevant image, display a default no_image icon.

Do

horizontal divider line

Provide imagery for background and image components when possible. 

Don't

horizontal divider line

When no imagery is provided, a default background and empty state will be displayed.

Try it out
Related developer documentation