Skip to content

Book Details Widget

The Book Details Widget is a Shopify theme extension that displays key book metadata on your product pages — pulled directly from Ingram's data, sourced at import.

This is optional and requires an Online Store sales channel with a compatible theme. The Emersoft team installs and positions the widget during your onboarding session.


What it displays

The widget shows key book reference data on your product pages:

  • ISBN — the title's ISBN-13
  • Binding — e.g. hardcover, paperback, trade paperback
  • Page count — number of pages
  • Authors — all authors associated with the title
  • Publisher (imprint) — the publishing imprint

Displaying additional metadata

All other Ingram metadata imported with the book is stored in Shopify product metafields under the ingram prefix — audience type, language, series information, illustrators, and more. See Product Tags & Metafields for the complete reference.

Metafields of type Single line text (such as Ingram Binding, Ingram Language, and Ingram Audience Type) can be displayed anywhere on your product page template using a standard Text block in the Shopify theme editor — no coding required. Simply add a Text block to your product template and connect it to the relevant metafield.

More complex metafield types — such as lists, JSON objects, and True/False fields — require Liquid code in your theme to display. If you need help with this, the Emersoft team can assist during onboarding or as part of a theme customisation request.


Adding the widget to your theme

  1. In Shopify Admin, go to Online Store > Themes.
  2. Click Customize on your active theme.
  3. Navigate to a product page template.
  4. Click Add block or Add section (depending on your theme structure).
  5. Find Emersoft Books — Book Details in the app blocks list.
  6. Drag it to the position you want on the product page.
  7. Click Save.

Which products show the widget

The widget is added to your product page template and applies to all products in your store. It reads data from the Ingram metafields on each product. If a metafield is not present on a product — for example, on a product that was not imported through Emersoft Books — that field will display as empty.

If you want the widget to appear only on specific products (for example, only on books and not on other product types), you have two options:

  • Create a dedicated product template in your theme for books and add the widget only to that template.
  • Add a Liquid condition to your theme to hide the widget when the relevant metafields are absent.

The Emersoft team can help with either approach if needed.


Tip

The widget works best placed below the product description and above reviews or related products — after customers have read the headline copy and want to learn more about the book.