Checkout Components

Add custom banners, fields, and UI components directly into the checkout flow. Click on any of the components below to see its configuration steps.

Getting Started: Create a Component

  • Open the SmartFlow Checkout app in your Shopify Admin.
  • Navigate to the Checkout Extensions tab.
  • Click on Create and select your preferred component from the available options below.

Available Components Configuration

1. Progress Bar

Step 1: Configure Basic Details
  • Enter a Progress Bar Name. (Important: You will need to enter this exact name later in the checkout editor to display this specific progress bar).
  • Set the Status to Active or Draft.
  • Optionally, use the calendar icon to schedule a Start and End Date/Time for automatic activation.
Step 2: Add a Progress Bar Step
  • Click Add Step.
  • Enter values for all 4 inputs:
    • Step Name: Name of the step.
    • Step Threshold: Minimum order value to unlock the step.
    • Step Progress Message: Message shown while progressing.
    • Step Success Message: Message shown when the step is unlocked.
  • Click Save to add the step.
  • You can add multiple steps with different thresholds.
Step 3: Open Checkout Editor
  • Navigate to Settings → Checkout to open the checkout editor.
Step 4: Add the Progress Bar Block
  • Click Add block and select Checkout Progress Bar from the list.
  • Pick the progress bar you added from the sidebar dropdown.
  • Enter the exact unique progress bar name you created in Step 1.
  • You can create multiple progress bars and show any of them just by entering its unique name here!
  • The selected progress bar will instantly load inside the editor.
Step 5: Save and Verify
  • Click Save in the editor.
  • Check your checkout page to ensure the progress bar displays correctly.
Progress Bar Configuration

2. Product Upsell

Step 1: Basic Configuration
  • Enter a unique Name. (Important: You will enter this exact name later in the checkout editor to display this upsell).
  • Set the Status to Active or Draft.
  • Optionally, use the calendar to Select Date and Time for automatic scheduling.
Step 2: Headings & Text
  • Enter a Title (e.g., "Recommended for you").
  • Enter a Subtitle (e.g., "Here are some extras to complete your order").
  • Choose the Text Alignment (e.g., Center).
Step 3: Choose Your Offer Type
  • Select how you want to recommend items: Specific Products, Collections, Product Tag, or Product Type.
  • Select the actual products/collections you want to display in the upsell box.
Step 4: Layout & Product Settings
  • Layout Settings: Choose a Layout (Horizontal/Vertical), set the Max total products to show, pick a View Mode (like Slider), and choose a Button style.
  • Product Settings: Use toggles to configure the shopping experience:
    • Allow Editing Product Variant
    • Show product price
    • Allow Editing Product Quantity
    • Allow customer to redirect to main product page when clicking the image/title
Step 5: Display Conditions
  • Choose No Conditions to always show the upsell.
  • Or, choose Display by conditions to restrict it (e.g., only show if cart contains a specific item).
  • Click Save to store your upsell configuration.
Step 6: Open Checkout Editor & Add Block
  • Navigate to Settings → Checkout to open the checkout editor.
  • Click Add block and select Product Upsell.
  • Enter the exact unique Name you created in Step 1. The selected upsell will instantly load.
Step 7: Save and Preview
  • Click Save in the checkout editor.
  • Preview checkout to confirm your upsell products are displayed correctly.
Product Upsell Configuration

3. Custom Fields

Step 1: Basic Configuration
  • Enter a unique Form Name. (Important: You will enter this exact name later in the checkout editor to display this specific form).
  • Set the Status to Active or Draft.
  • Optionally, use the calendar to schedule a Start and End Date/Time for automatic activation.
Step 2: Create Your Form Fields
  • Click Add new field to start building your form.
  • Select field types such as Text Field, Dropdown, Checkbox, Date Picker, and more.
  • Customize each field’s label, placeholder, width, and alignment.
  • Popular Form Examples:
    • Gift Wrapping: Checkbox ("Add Gift Wrap") + Text Area ("Gift Message").
    • B2B / Wholesale: Text Field ("Company Name") + Text Field ("VAT / Tax ID").
    • Delivery Instructions: Date Picker ("Preferred Delivery Date") + Text Area ("Gate Code / Instructions").
Step 3: Set Display Conditions
  • Click Set Conditions if you only want to display this form in specific scenarios.
  • Example 1: Show the "Gift Wrapping" form ONLY when the cart total is greater than $50.
  • Example 2: Show the "B2B / Wholesale" form ONLY if the customer has the wholesale tag.
Step 4: Open Checkout Editor & Add Block
  • Navigate to Settings → Checkout to open the checkout editor.
  • In the editor, click Add block and select Custom Fields.
  • Enter the exact unique Form Name you created in Step 1. Your configured fields will instantly load.
Step 5: Save and Test in Checkout
  • Click Save in the checkout editor.
  • Preview your checkout to ensure all fields are displayed correctly.
  • Submit a test checkout to verify the data is saved safely into Shopify Metafields on the order!
Custom Fields Configuration

4. Custom Banner

Step 1: Basic Configuration
  • Enter a unique Banner Name. (Important: You will enter this exact name later in the checkout editor to display this specific banner).
  • Set the Status to Active or Draft.
  • Optionally, use the calendar to schedule a Start and End Date/Time.
Step 2: Headings, Text & Style
  • Enter a Banner Title (e.g., "Holiday Shipping Deadlines").
  • Enter the Message content.
  • Choose the Style to match the intent (Info, Success, Warning, Critical).
  • Optionally, enable the Close and Collapse buttons so customers can dismiss the banner.
Step 3: Set Display Conditions
  • Click Set Conditions to control exactly when the banner appears.
  • Example 1 (Urgency): Show a Warning "Sale ends in 1 hour!" banner ONLY on a specific date.
  • Example 2 (Shipping): Show a Success "Free shipping unlocked!" banner ONLY when the cart total is greater than $100.
Step 4: Open Checkout Editor & Add Block
  • Navigate to Settings → Checkout to open the checkout editor.
  • In the editor, click Add block and select Custom Banner.
  • Enter the exact unique Banner Name you created in Step 1. The banner will instantly load.
Step 5: Save and Verify
  • Click Save in the editor.
  • Preview your checkout to confirm the banner appears correctly under the right conditions.
Custom Banner Configuration

5. Custom Cart

Step 1: Basic Configuration
  • Set the Status to Active or Draft.
  • Optionally, use the calendar to schedule a Start and End Date/Time for when these cart rules apply.
  • Note: Unlike other components, the Custom Cart acts globally, so it does not require a Name.
Step 2: Configure Cart Rules
  • The main benefit: Customers no longer need to abandon checkout and go back to the cart page to make changes!
  • Enable options so customers can edit items, remove items, change variants, or update quantities directly on the checkout page.
  • Set a minimum cart quantity required before allowing checkout changes.
Step 3: Set Display Conditions
  • Click Set Conditions to control when these cart modifications are allowed.
  • Example Use Case (Flash Sale): Disable quantity editing during a flash sale. Set a condition where if the cart has the "BlackFriday" discount code applied, the custom cart block restricts changes to ensure inventory isn't oversold.
Step 4: Open Checkout Editor & Add Block
  • Navigate to Settings → Checkout to open the checkout editor.
  • In the editor, click Add block and select Custom Cart.
  • Because there is only one global cart configuration, the block will automatically apply your rules.
Step 5: Save and Verify
  • Click Save in the editor.
  • Preview your checkout to confirm the cart behaves exactly as configured under your specific conditions.
Custom Cart Configuration

6. Trust Badge

Step 1: Basic Configuration
  • Enter a unique Component Name. (Important: You will enter this exact name later in the checkout editor to display this block).
  • Set the Status to Active or Draft.
  • Optionally, use the calendar to schedule a Start and End Date/Time for when these badges should appear.
Step 2: Badge Layout & Design
  • Choose a Badge Layout: Display your badges in a Horizontal row or a Vertical stack.
  • Under Badge Settings, click Add badge to create one or more trust badges.
  • For each badge, customize its specific text (e.g., "30-Day Money-Back Guarantee", "Secure Checkout").
Step 3: Customize Icons
  • Enable Show Icon if you want an icon to display beside the text.
  • Choose from built-in standard icons or upload your own Custom Image.
  • You can mix and match—each badge can have its own unique text, color, and custom icon.
Step 4: Set Display Conditions
  • Click Set Conditions if you only want to display these badges in specific scenarios (e.g., only for certain products).
Step 5: Open Checkout Editor & Add Block
  • Navigate to Settings → Checkout to open the checkout editor.
  • In the checkout editor, click Add block and select Trust Badge.
  • Enter the exact unique Component Name you created in Step 1. Your customized badges will instantly load.
Step 6: Save and Verify
  • Click Save in the editor.
  • Preview your checkout to confirm that the badges display correctly with your chosen icons, text, and layout.
Trust Badge Configuration

7. Payment Icons

Step 1: Basic Configuration
  • Enter a unique Name (e.g., payment). (Important: You will enter this exact name later in the checkout editor to display this block).
  • Set the Status to Active or Draft.
  • Optionally, use the calendar to schedule a Start and End Date/Time.
Step 2: Headings & Alignment
  • Enter a Heading for the block (e.g., "Secure Payment Options").
  • Choose the Heading color (e.g., Info).
  • Set the Alignment (e.g., Center) so the icons fit perfectly with your checkout design.
Step 3: Add & Configure Icons
  • Under Icon Settings, click Add Icon to include a new payment option.
  • For each icon, choose from the built-in Payment Icons (e.g., Klarna, Visa, PayPal) or upload your own Custom Image.
  • Optionally, set a Link to URL if you want to redirect customers when they click a specific icon.
  • You can add multiple icons to showcase all your accepted payment methods!
Step 4: Set Display Conditions
  • Click Set Conditions if you only want to display these icons in specific scenarios (e.g., only if a certain shipping country is selected).
Step 5: Open Checkout Editor & Add Block
  • Navigate to Settings → Checkout to open the checkout editor.
  • In the checkout editor, click Add block and select Payment Icons.
  • Enter the exact unique Name you created in Step 1. Your customized icons will instantly load.
Step 6: Save and Verify
  • Click Save in the editor.
  • Preview your checkout to confirm the icons appear exactly as configured.
Payment Icons Configuration

8. Image Carousel

Step 1: Basic Configuration
  • Enter a unique Name (e.g., carousel). (Important: You will enter this exact name later in the checkout editor to display this block).
  • Set the Status to Active or Draft.
  • Optionally, use the calendar to schedule a Start and End Date/Time.
Step 2: Carousel Layout & Dimensions
  • Choose your Layout (e.g., Slider).
  • Configure dimensions by entering the Width (px) and Height (px).
  • Select the Image Fit preference (e.g., Cover).
  • Optionally, turn on Enable Autoplay and set the Autoplay Speed (seconds).
Step 3: Add & Configure Slides
  • Under Slider Settings, click Add Slide to create new carousel slides.
  • For each slide, upload your image using the Upload Image button.
  • Provide a Slide Label for accessibility and identification.
  • Optionally, set a Link to URL if you want the slide to redirect customers when clicked.
Step 4: Set Display Conditions
  • Click Set Conditions if you only want to display this carousel in specific scenarios (e.g., only show promotional slides if the cart is over a certain amount).
Step 5: Open Checkout Editor & Add Block
  • Navigate to Settings → Checkout to open the checkout editor.
  • In the checkout editor, click Add block and choose Image Carousel.
  • Enter the exact unique Name you created in Step 1. Your customized carousel will instantly load.
Step 6: Save and Test in Checkout
  • Click Save in the checkout editor.
  • Preview your checkout to confirm the carousel displays correctly.
  • Test autoplay and navigation arrows for proper behavior.
Image Carousel Configuration

Need help? Contact our support team at support@celirox.com