This guide will walk you through the various customizations that are available for Content Blocks. If you're ready to install them, then you can check out our installation guide.
Content blocks can be accessed by all merchants, but they can only be placed into the checkout by Shopify Plus merchants.
Shopify Plus merchants can add content blocks to:
Checkout
Thank you page
Order status page
Non-Shopify Plus merchants can add content blocks to:
Thank you page
Order status page
Uploading and Adding Images to a Content Block
Rebuy offers a variety of built-in icons—like secure checkout, payment methods, and social media logos. But if you’d rather use your own custom images, you’ll first need to upload them to the Image Gallery.
Image Sources
You can add images to a content block from these sources:
Upload from desktop – Select an image file directly from your computer.
Add via URL – Paste a link to display an external image.
Select from gallery – Use images you’ve already uploaded to the Rebuy gallery.
Use Rebuy icons – Choose from built-in icon options (you can preview each one before selecting).
How to Upload Custom Images
Click the Upload button.
Select the image(s) from your device to add to the Image Gallery.
Image Size Guidelines
Near Checkout Fields: Max width ~600px.
Near Order Summary (Right Side): Max width ~375px.
For images with text or fine detail: Upload at 2x the display size (e.g., 750px for a 375px display) for optimal clarity.
⚠️ You can upload images from within a content block, but image management—such as renaming, replacing, or deleting—must be done in the Image Gallery.
Adding Images to a Content Block
Once your images are uploaded, here’s how to add them:
In your content block settings, select Images.
Click Add Images.
A pop-out tray will appear with three options:
Upload new images (as described above)
Choose from Rebuy's built-in icons
Select from your Image Gallery
Customizing Image Settings
After selecting your image(s), you can adjust the following settings to match your store’s design and improve accessibility:
Image Display Settings
Image Width – Set a width from 0% to 100% to control how much space the image takes up.
Alt Text – Add a short, meaningful description for accessibility and SEO.
Object Fit – Choose how your image is displayed:
Original – Maintains the image's original size and proportions
Square (Cover) – Crops to fill a square container
Square (Contain) – Fits the entire image within a square, no cropping
Border Styling
Border Style – Options: None, Base, Dotted, Dashed
Border Width – Options: Base, Medium, Thick
Corner Radius – Options: None, Small, Base, Large, Fully Rounded
Default values for Alt-Text are provided for pre-canned images by Rebuy, but you have the flexibility to customize these values according to your preferences. You will need to add your own descriptions for custom images. This section is designed to assist users who rely on visual readers.
Rich Text Editor for Format Your Text
The Rich Text Editor makes it easy to style and format your text. You can:
Change text size for better emphasis
Add formatting like bold, italics, or underline
Insert clickable links (URLs)
Align text left, center, or right
Adjust line spacing for improved readability
There's also a language dropdown at the top of the editor. This lets you choose the language you want to view the interface in. However, you'll still need to manually type or paste your text in that language—the editor won’t translate it for you.
Layout
Layout Settings
The Layout settings let you control how content is arranged within a content block. You can customize:
Direction – Choose between rows or columns to set how elements are stacked.
Width – Define the width of each row or column to control how much space it takes up.
Nesting – You can nest layouts by adding a new section inside an existing one, giving you more flexibility in how you organize your content.
These options help you create structured, responsive layouts tailored to your design needs.
There’s no limit to the number of sections or levels of nesting you can create—giving you full flexibility to design structured, responsive layouts.
General Editor Capabilities
Rebuy's visual editor offers powerful features to help you customize your content with ease. Here’s an overview of what you can do:
Layout and Organization
Drag & Drop Sections – Rearrange sections effortlessly by dragging them into your preferred order.
Clone/Delete Sections – Duplicate existing sections or remove ones you no longer need.
Nested Sections – Use the Layout section to create sections within sections for more complex designs.
Editing Experience
Expand/Collapse Settings – Easily open or hide settings panels to keep your workspace tidy.
Language Selector – Set the editor interface to your preferred language for a localized experience.
Inspect Mode – Enable to quickly identify and jump to any section in the previewer.
🔍 When Inspect Mode is on:
Hovering over a section in the sidebar highlights it in the previewer with a light blue outline.
Clicking an element in the previewer auto-scrolls to its editing panel in the sidebar.
Disabling Inspect Mode turns off the highlight effect and click-to-jump behavior.
Preview and Device Support
Mobile Preview – View how your content appears on mobile devices to ensure responsive design.
Get Started with Installation
When ready to install, you can follow our documentation in the installation guide.
FAQ
Q: Can I upload custom images from inside a content block?
A: Yes. However, image management (renaming, replacing, deleting) must be handled through the Image Gallery.
Q: Does the language dropdown translate my text?
A: No — the dropdown changes the interface language. You must type or paste your content manually in the selected language.
Q: Are there any limits to section nesting?
A: No, you can add unlimited sections and nest them as deeply as needed to achieve your desired layout.