Shopify ebook delivery

Place Familiar on Thank you and Order status

Add Familiar to both Shopify order surfaces so buyers can download a synced EPUB immediately after checkout and whenever they revisit their order.

One app, two placements

Shopify treats these as separate pages. Adding Familiar to one does not add it to the other.

Placement 1 of 2

Thank you

Shown once, immediately after the buyer completes checkout.

Added 1 · Thank you · Remove block

Placement 2 of 2

Order status

Available when the buyer returns to review the order later.

Added 2 · Thank you + Order status

A blank preview can be correct

Familiar only renders beneath an eligible ebook line item with a real delivery manifest. Shopify’s simulated editor might show a paperback or another unmatched product, so the center preview can remain blank even when the block is placed correctly.

In the sidebar, seeing Familiar ebook delivery under Added, labeled Thank you, with a Remove block action confirms the first placement.

Add both placements

Use the active configuration—the one your customers currently see.

Open Shopify Admin

1
Open the active checkout configuration
In Shopify Admin, open Settings, then Checkout. Edit the active checkout configuration that customers currently use.
2
Add Familiar to Thank you
Open the Apps sidebar, find Familiar ebook delivery, and add it to the Thank you page.
3
Confirm the Thank you placement
Confirm that Familiar appears under Added with the Thank you label. Seeing Added 1 and Remove block means the first placement is active.
4
Add Familiar to Order status
Switch to the Order status page and add Familiar ebook delivery again. Thank you and Order status are separate placements.
5
Save the checkout configuration
Save the checkout configuration. If you edited a draft configuration, publish it before enabling delivery in Familiar.

What buyers will see

These states appear beneath each matching ebook line item on a real order.

Preparing

Preparing your EPUB…

The order is paid and Familiar is still creating secure access.

Ready

Download EPUB

The buyer can open the secure Familiar download page.

Revoked

Access revoked

The delivery exists, but access was disabled after purchase.

Print books and other unmatched products show no Familiar content.

Finish in Familiar

1Return to Distribution → Setup → Shopify store → Ebook delivery.
2Check “Both extension placements are live.”
3Optionally set the buyer reply-to email, then enable automatic EPUB delivery.
4Save delivery settings.

Open Distributor Setup

Test a real ebook order

Place a paid order containing an ebook that is opted in and synced from Familiar. The editor preview is not an end-to-end test because it does not represent a real Familiar delivery.

On Thank you, confirm the book title and delivery state appear beneath the ebook line item.
Open the same order’s Order status page and confirm the delivery appears there too.
Open Download EPUB and confirm the secure buyer download page loads.

If a real ebook order is blank

Check the listing

Confirm the book is opted into Shopify, synced, and has an EPUB attached to its ebook edition.

Check the order

Delivery starts only for a paid order containing the matching synced ebook variant.

Check Familiar settings

Both placements must be confirmed and automatic EPUB delivery must be enabled and saved.

Check the live configuration

If you edited a draft checkout configuration, publish it before placing the test order.