Skip to main content

Content Blocks Installation Guide

How to create and install Content Blocks on checkout, thank you, order status, and orders pages in Rebuy.

Written by Christian Sokolowski
Updated this week

A Content Block is a Rebuy Checkout Extension that lets you add static or branded content — such as customer reviews, trust badges, influencer testimonials, or promotional images — directly to your Shopify checkout and post-purchase pages. Content Blocks are configured in the Rebuy dashboard and installed through the Shopify checkout editor.

Content Blocks can be accessed by all Rebuy merchants, but placement on the Checkout page is available exclusively to Shopify Plus merchants. Non-Shopify Plus merchants can place Content Blocks on the Thank You page, Order Status page, and Orders (Customer Account) page.

Already know how to install a Content Block and want to customize it? Go directly to the Content Block Layout and Image Settings guide.


Before You Begin

Before creating and installing a Content Block, confirm the following:

  • You have access to the Rebuy Dashboard and your store's Shopify checkout editor.

  • You know which page you want to place the Content Block on (Checkout, Thank You, Order Status, or Orders/Customer Account).

  • If you want to place a Content Block on the Checkout page, your store must be on Shopify Plus. Checkout page placement is not available on other Shopify plans.

Shopify Plus merchants can add Content Blocks to: Checkout, Thank You page, Order Status page, and Orders Page (Customer Account).

Non-Shopify Plus merchants can add Content Blocks to: Thank You page, Order Status page, and Orders Page (Customer Account).

For a full breakdown of which features are available by plan, see the Compatibility Matrix section below.


How to Install a Content Block

Installing a Content Block involves two parts: creating and configuring the widget in the Rebuy dashboard, then installing it in the Shopify checkout editor using the widget ID. Follow the steps below to complete both parts.

A video walkthrough of the full installation process is also available in the Video Installation Guide at the bottom of this article.

Part 1: Create the Content Block in Rebuy

  1. Access Rebuy Admin — Log in to your Rebuy dashboard.

  2. Navigate to Checkout Extensions — Go to the Checkout & Post Purchase section, then select Checkout Extensions.

  3. Create a New Widget — Click New Widget to begin creating your Content Block.

  4. Select Placement — Choose where the Content Block will appear: Checkout Page, Thank You Page, Order Status Page, or Orders Page (Customer Account).

  5. Select Widget Type — From the widget options, select Content Block.

  6. Name Your Widget — Give your Content Block a clear name for easy identification later.

  7. Add Content — Add an image, layout, or text element to your Content Block.

  8. Copy Widget ID — Once your content is added, copy the Widget ID displayed in the widget settings. You will need this ID in Part 2.

  9. Open in Shopify Editor — Click Install this widget in Shopify Editor to be taken directly to the Shopify checkout editor.

Part 2: Install the Content Block in Shopify

  1. In the Shopify checkout editor, navigate to the Checkout Page (or the post-purchase page where you want to place the Content Block) and click Customize.

  2. Click Add Block, then select Rebuy Smart Component from the list of available blocks.

  3. In the Rebuy Smart Component settings panel, paste your Widget ID into the Widget ID field.

  4. Set "Hide this extension" to No.

  5. Toggle on "include block in shop pay."

  6. Click Save to publish the Content Block live on your store.

Your Content Block is now live. If you want to reposition it, click and drag it to the correct placement within the Shopify checkout editor.

Note: The Save button in the Shopify checkout editor does not automatically refresh the preview. After saving, refresh the page manually to see the Content Block appear in the checkout previewer.

Next Steps: Customize Your Content Block

Now that your Content Block is installed, you can customize its layout, images, and display settings. For full customization options, see the Content Block Layout and Image Settings guide.


Compatibility Matrix

The table below shows which Content Block and Product Recommendation placements are available by Shopify plan type.

Feature

Shopify Plus

Non-Shopify Plus

Content Blocks — Checkout

Yes

No

Content Blocks — Thank You Page

Yes

Yes

Content Blocks — Order Status Page

Yes

Yes

Content Blocks — Orders (Customer Account)

Yes

Yes

Product Recommendations — Checkout

Yes

No

Product Recommendations — Thank You Page

Yes

Yes

Product Recommendations — Order Status Page

Yes

Yes

Product Recommendations — Orders (Customer Account)

Yes

Yes

Product Recommendations — Post-Purchase

Yes

Yes


Frequently Asked Questions About Content Blocks

Where can I add a Content Block?

Where you can place a Content Block depends on your Shopify plan. Shopify Plus merchants can place Content Blocks on the Checkout page, Thank You page, Order Status page, and Orders (Customer Account) page. Non-Shopify Plus merchants can place Content Blocks on the Thank You page, Order Status page, and Orders (Customer Account) page only. Checkout page placement requires Shopify Plus.

Why is my Content Block pushing down into a different section of the Checkout page?

In some cases — such as when a customer is logged in — Shopify automatically collapses certain sections of the Checkout page. When a section collapses, any app blocks nested within it may shift position. To prevent this, nest the Rebuy Smart Component block inside a specific sub-section of the Checkout page layout, and enable the "Automatically expand sections to show app" toggle under "Checkout behavior" in the Shopify checkout editor.

For example:

Do I need a Data Source for a Content Block to work?

No, Content Blocks do not require a Data Source. Unlike product recommendation widgets that use Data Source rules to determine which products to show, a Content Block displays its content every time a customer lands on the configured page. There are no conditional display rules required — the Content Block simply shows the static content you added to the widget.

Do Content Blocks support videos?

No, Shopify does not currently support video files within Checkout Extensions, which includes Content Blocks. As a workaround, you can use an animated GIF file to add motion to a Content Block. Keep in mind that GIF files do not include audio and lack standard video playback controls, so they are best suited for short looping animations rather than full-length video content.

What are the recommended image dimensions for Content Blocks?

The recommended image dimensions depend on where the Content Block is placed within the checkout layout. Images placed near the checkout input fields have a maximum display width of approximately 600px. Images placed near the Order Summary on the right side have a maximum display width of approximately 375px. For images that contain text or important visual details, upload your assets at 2x the display size (for example, upload a 750px wide image for a 375px display slot) to ensure the image appears sharp on high-resolution and retina screens. We recommend a minimum upload width of 750px. Note that images cannot be scaled up beyond their original dimensions, so always start with a larger asset.

Can I add a survey to the checkout or post-purchase pages?

No, surveys are not currently supported in Rebuy Content Blocks or any Checkout Extension placement. This applies to the checkout page, thank you page, order status page, and post-purchase page. If survey functionality is important to your store, consider a third-party Shopify app that specializes in checkout surveys.

How do I find my Widget ID?

Your Content Block's Widget ID is a unique numeric identifier assigned when the widget is created. You can find it in the widget's settings panel in the Rebuy Dashboard at the top of the page. The Widget ID is also visible in the browser's URL when you are editing the widget — it appears as a number in the URL path. Copy this ID and paste it into the Widget ID field of the Rebuy Smart Component block in the Shopify checkout editor.


Video Installation Guide

For a step-by-step video walkthrough of creating and installing a Content Block, watch the video below. The video covers navigating to Checkout Extensions in the Rebuy Dashboard, creating a new Content Block widget, copying the Widget ID, and installing the Rebuy Smart Component in the Shopify checkout editor.

Prefer text-based instructions? The full written steps are available in the How to Install a Content Block section above.

Did this answer your question?