How to set up the Trust Badge block

What the Trust Badge block does

The block shows a title, for example “Trusted by thousands of customers”, above a vertical list of badges. Each badge is one row: an icon on the left, then a bold title and a short grey description, such as “Secure Checkout” over “SSL Protected”. It’s display only. Buyers can’t click or change anything.

When to use it

• Answer the questions buyers have at payment: secure checkout, returns, delivery times, guarantees.
• Give each message room to explain itself. The stacked layout fits a two-line description under every badge.
• Reassure first-time buyers who don’t know your store’s policies yet.

Before you start

• Know which messages you want to show. Keep titles short and put the detail in the description.
• Host any custom icons at a public URL, for example in Content → Files in your Shopify admin, if you don’t want to use the preset icons.

Set it up

1. In Checkout Ninja, go to Blocks and click Create New Block. Then click Start Fresh, or open an existing block you want to add it to.
2. Click Add block and choose Trust Badge.
3. Under Title, edit the Title Text, or clear it to hide the title. Set Title Alignment.
4. Under Trust Badges, add a badge. A new badge starts blank, so fill in:
   • Badge Title and Badge Description;
   • Icon Type: Preset Icon (pick from Choose Icon) or Custom Image (paste an Image URL);
   • Icon Size.
5. Repeat for each badge. Drag badges to reorder them.
6. Click Done. Check that Status is Active, then click Save and copy the Block ID.
7. Click Open Checkout Editor. Add the Custom Block app block where you want the badges, often near the payment step. Paste the Block ID and save.

Settings reference

Title

Setting	What it does	Default
Title Text	Heading above the badges. Leave empty to hide it.	Trusted by thousands of customers
Style Preset	Quick style: Heading Large, Heading, Subheading, Body, Body Small or Caption.	Heading Large
Advanced Options → Size	Extra Small to Extra Large.	Large
Advanced Options → Style	Normal, Bold or Italic.	Bold
Advanced Options → Color	Default, Accent (Blue), Subdued (Gray), Success (Green), Warning (Yellow) or Critical (Red).	Default
Title Alignment	Left, Center or Right.	Center

Trust Badges (per badge)

Setting	What it does
Badge Title → Title	The badge’s bold first line. Has the same Style Preset and Advanced Options as the block title.
Badge Description → Description	Up to 2 lines under the title, shown small and grey unless you change its style.
Icon Type	Preset Icon or Custom Image.
Choose Icon	(Preset Icon) One of Shopify’s checkout icons, such as Lock, Truck, Return, Credit Card, Gift or Star. The picker links to the full Shopify icon list.
Image URL	(Custom Image) URL of your own icon image. Use an https URL.
Icon Size	Small (24px), Medium (32px), Large (40px) or Extra Large (48px).

Verify it worked

1. Open your checkout with any product in the cart. The title shows at the alignment you chose, with each badge on its own row below.
2. Check that every badge shows its icon. A missing icon means the preset isn’t set or the image URL doesn’t load.
3. If you added visibility conditions, open a checkout that doesn’t meet them. The badges shouldn’t show.

Limitations

• Shopify Plus only for placement in the checkout steps. That’s a Shopify rule for all checkout apps.
• Text sizes are approximate. Shopify’s checkout components have no free font sizing, so the six sizes map to four steps: Extra Large shows as a heading, Large as bold text, Base and Medium as body text, and Small and Extra Small as small text.
• Accent (Blue) shows in your default text colour. Shopify’s checkout text has no brand-blue option.
• Some preset icons can’t reach the largest pixel sizes. Icons without a built-in drawing fall back to Shopify’s icon, which is capped at a smaller size.
• Badges are text and images only. They can’t link to a policy page.

Troubleshooting

A badge shows text but no icon. Open the badge and check Icon Type. For Preset Icon, choose an icon in Choose Icon. For Custom Image, check the Image URL opens in a browser and starts with https://.

A badge is missing its title or description. New badges start blank. Open the badge and fill in Badge Title and Badge Description. An empty field isn’t shown.

The block doesn’t show in checkout. Check the block is Active and its Block ID is pasted into a Custom Block in the checkout editor. Then run through the general checklist.