Skip to main content

Overview of Candu Components

Quick overview of Candu components like checklists, forms, flows, cards, and conditional logic that you can use to build experiences.

Written by Deborah Ramírez

Components are the building blocks you use in Candu to create in-app experiences. Some components serve a specific purpose, such as guiding users, collecting data, or prompting action, and can be styled centrally through your Styleguide for consistency.

By combining components like checklists, forms, flows, cards, buttons, and media, you can design onboarding, education, and engagement experiences without code, while tracking user interactions and personalizing what users see.

Checklist

Checklists drive product adoption by guiding users through setup and key actions. User checklist items can be completed manually or automatically via product events, user properties, or Candu events. You can create custom styles in your Styleguide and checklists come in two display types:

  • Accordion (no checkboxes)

  • Checklist (with checkboxes)

You can choose between tracking progress per User or Group.

Forms

Forms allow you to capture data about your users directly in your product. You can use them to build onboarding or sign up surveys, feedback surveys or contact forms. Styles are set in your Styleguide to ensure consistency. In Candu, forms include:

  • Fields: Text input, text area, select dropdown, email input, checkboxes, multi-select cards, single-select cards, submit button

  • Settings:

    • Redirect on submission: Send users somewhere else after submitting

    • Prevent resubmission: Based on User ID (avoid duplicate submissions)

  • States: Normal, Submitted (thank you message), Error (validation feedback)

Note: Forms require a submit button. These responses are tracked in the Responses section. For more details, see this guide.

Flow

Multi-step sequences that users navigate through, like a slideshow or carrousel. Use Flows for:

  • Walkthroughs (step-by-step guides)

  • Carousels (rotating content)

  • Multi-step forms

  • Onboarding sequences

Flow settings:

  • Step name: Label each step for organization

  • Save user progress: Remember where users left off if they exit flow

  • Preview flow: See the full sequence

  • View flowchart: Visualize step connections

Card

A container component that can display content and act as an interactive block. This means cards can be used as calls-to-action and set to be Dismissible. Cards are incredibly versatile:

  • Types: Action (clickable), No Action (display only)

  • Styling: You can change border radius, shadow, cursor type, hover state, and border to create transparent, action or static cards. Be sure to define styles in your Styleguide.

  • Actions: Cards can trigger all the same actions as buttons

  • Use cases: Feature blocks, pricing tables, option selectors, banners, notifications

Note: Actions, including dismissed actions, are tracked as user events

Conditional Logic

Great for personalization! Show or hide content dynamically based on conditions you set (user properties, location, behavior, etc.).

Other components

Typography

Text components with predefined styles (headings, body text, labels, etc.) Styles are set in your Styleguide to ensure consistency. Once defined, you can use them through your content.

Button

A clickable component that triggers an action and is tracked a user event. Buttons can be styled in your Styleguide and can trigger many actions, such as:

  • Dismiss overlay: Close a modal

  • Go to flow step: Navigate within a multi-step flow

  • Open URL: Link to another page

  • Callback: Add JavaScript snippets in the installation and call them from the Editor. An example of this is triggering a chat widget to open when a "Start chat" button is clicked.

  • Trigger tour/hotspot/overlay: Start other Candu experiences

  • Change content: Update overlay content dynamically

  • Send email: Trigger email notification

  • Trigger click: Click on behalf of the user

Image components

Display images from uploads or URLs and can include GIFs, SVGs, PNGs, and Webpts. You can configure images with:

  • Size: Width, height, min/max constraints

  • Fit: How image fills its container:

    • Contain: Full image visible, may have empty space

    • Cover: Fills container completely, may crop image

    • Fill: Stretches image (can distort)

    • Scale down: Like contain, but never enlarges

    • None: Original size, may overflow

Image upload limits:

  • File size: 1.5MB max

  • Resolution: 50,000 megapixels max

  • No limits: Self-host your images and provide the URL instead

Player (Video/Audio)

The Player component lets you add embedded video or audio content from supported media providers such as Wistia, YouTube, Vimeo, and Vidyard.

Candu does not host or process the video file directly. Instead, the Player component embeds the media provider’s player inside your Candu experience. This means the video provider controls video hosting, streaming, playback behavior, privacy settings, and embed permissions.

You can configure players in Candu with:

  • Aspect ratio: 16:9 (widescreen), 4:3 (classic), 16:10, 2:1

  • Loading image: Placeholder shown before media loads

  • Accessibility: Add a title and aria-label for screen readers

For the video to load correctly in Candu, the video must be accessible through the provider’s embedded player. It does not always need to be fully public, but the provider’s privacy and embed settings must allow the video to be embedded on the domain where the Candu experience appears.

For example, with Vimeo, a fully Private video may not load in an embedded Candu experience because Vimeo says private videos are only viewable by you and your team members, even if embedded elsewhere. Vimeo’s Hide from Vimeo setting is more suitable for this use case because the video is not viewable on Vimeo.com but can still be embedded on other websites. Vimeo also supports domain-level embed privacy, which allows you to specify which domains are allowed to embed the video.

Badge

Small visual indicators or labels, typically used to show status, counts, or categories. As with buttons, you can create primary, secondary, tertiary, warning, and danger badges. Style them through your Styleguide for consistency.

Divider

A simple horizontal line used to separate content sections.

Embeds

Embeds let you include rich, interactive content, like calendars, forms, videos, or other tools. There are two embed types:

  • Candu Content: Embed other Candu content (must be inline)

  • iFrame: Embed external website or apps via a public URL

Alert

A component for displaying important messages, notifications, or status updates. Alerts are static on the page and you can set styles in your Styleguide for consistency.

Did this answer your question?