Skip to main content

Candu Editor Glossary

A comprehensive guide to understanding the Candu Editor

Deborah Ramírez avatar
Written by Deborah Ramírez
Updated yesterday

This glossary is organized into categories that mirror your workflow in Candu. Terms are explained in plain English and connected to how they work in the Candu Editor. As you work with Candu, you'll develop intuition for when and how to use each feature. Bookmark this guide and return to it whenever you encounter unfamiliar terms.

Let’s dig in!

👉 New to Candu? Start with our Getting Started guide to get your first experience live.

Before you get started

At the top of the editor, you’ll find a menu bar with key tools: segments, analytics, and settings.

In the Settings (⚙️) panel, you can view and manage:

  • The name, slug (the content's unique ID) and description

  • Options to import, clone, or move content to another section

  • You’ll also find the Danger Zone, where you can:

    • Archive content: Unpublishes the content and removes it from your main content list. It’s not permanently deleted, you can restore it at any time.

    • Change the slug: This ID is used in code, so changing it without updating references may break access for your users

To create new content, click the ➕ icon. And to create targeted content:

  • Click the three dots in the “Everyone” tab and select Retarget to assign a new segment

  • Or duplicate existing content and retarget it later

📌 Content is auto-saved, and you’ll see who’s working on it by checking the initials in the top right. If there are unsaved changes or errors, they’ll appear here as well.

When you’re ready to go live, click Publish. Make sure Candu is installed on the page where you want the content to show. For troubleshooting tips when content is not showing, click here.

📌 To preview your content or share it with someone, use the Share button.

Core Concepts

Styleguide

A Styleguide ensures consistent styles for typography, buttons, cards, badges, checklists, and other components. Define your styles early and clearly. It’s a best practice to treat your Styleguide as your design system in Candu.

For more details on setting up and managing your Styleguide, click here.

Palette

The left sidebar that serves as your main navigation and resource center while building content. The Palette contains five sections:

  • Components: All building blocks you can drag onto your canvas (Layouts, Typography, Buttons, Cards, Media, Flows, Forms, etc.)

  • Layers: Hierarchical view of your content structure.

  • Templates: Pre-built content from best-in-class companies.

  • History: Timeline of your changes that you can restore.

  • Shortcuts: Quick reference for keyboard commands.

Components

The building blocks in your content, like a layout, button, image, typography, or card. Think of components as LEGO pieces you can arrange, rename, and customize on your canvas.

  1. Drag components from the palette on the left.

  2. Click the pencil icon to see customization options in the right panel, the Toolbox.

Layers

It’s like a family tree for content. Shows all components in your content and how they’re nested inside each other. When content gets complex, the layers panel helps you select and organize components that might be hard to click on the canvas.

Tip: You can rename components for clarity and use breadcrumbs to navigate through layers.

Templates

Pre-built layouts you can use as starting points instead of building from scratch. They’re especially helpful when learning Candu.

History

A timeline of all changes you’ve made to your content, allowing you to undo mistakes, see who made updates, and restore previous versions.

Shortcuts

Keyboard commands that help you work faster without clicking through menus. Once you learn a few shortcuts, building content becomes significantly faster. Common shortcuts include:

  • Multi-select: Shift-click to select multiple components at once

  • Copy/Paste: Cmd + V / C (Mac) or Ctrl + V / C (Windows) to duplicate components quickly

  • Delete: Press the delete key to remove selected components

Toolbox

The right sidebar that appears when you select a component, showing all available customization options. You’ll find key configuration tools:

  • Edit: Apply styles to your components. Options change based on what you’ve selected. It’s organized into sections like Layout, Size, Spacing, Background, Border, and Shadow.

  • Interactions: This is where you manage what happens when users click or tap on a component, like a button or a card. You can choose from a range of actions, including: open URL, callback, trigger tour, send email, and more. We’ll explore each of these actions in more detail later.

  • Placements: Choose where your content appears based on URL or page conditions and take a snapshot to preview how it will look in that environment.

  • Candu AI: Can draft or refine content based on your prompts and any references you have, including from attachments, webpages or screenshots.

Contextual "Floating" Menu

A quick-access menu that appears when you click on a component. It offers different options depending on the selected component. For example, if you highlight text, you can add a link or input a variable. You can also:

  • Copy: Duplicate the component

  • Delete: Remove the component

  • Cut: Remove and save to clipboard

  • Paste: Insert copied/cut content

  • Candu AI: AI assistant for that component

Layouts and Structure

Layout

Layouts are the foundation of almost everything you build and is how components are arranged and positioned relative to each other. Layout controls whether things stack vertically, line up horizontally, or wrap to new lines.

A good layout creates visual hierarchy and guides users through your content. Every container (things like single layout, columns, or cards) has layout settings. The most common choice is between “block” (stacks vertically) and “flex” (gives you control over arrangement).

Think of a Flex container as a flexible row or column, items inside can stretch or shrink to fill space, or wrap onto new lines like text in a paragraph.

In Candu, you can drag a layout stack component (three layouts stacked on top of each other), a single layout, right or left image layouts, and columns.

👉 Need help making layouts responsive? See our layout best practices.

Columns Layout

A component that divides content into vertical columns, like a newspaper or magazine layout. Columns are perfect for tables, content with sidebars, feature sections.

In Candu, you drag a columns component from the Layouts section. You can:

  • Create 2-12 columns

  • Set width ratios (ex. 8/12 + 4/12 for a sidebar layout)

  • Choose “Space evenly” for equal-width columns

  • Add or remove columns as needed

📌 Columns are not recommended for responsive designs as they do not collapse on small screens. You can use layout stacks instead or simply create a separate mobile experience.

Display

Controls how a component behaves in the layout. Whether it takes up full width or sits inline with text. This is often the first decision you make when building a layout. Options in Candu:

  • Block: Component takes up the full width of its container and starts on a new line (like a paragraph)

  • Flex: Allows you to arrange components in rows or columns giving you control over spacing, alignment, and behavior (Recommended)

  • Inline Block: Component only takes up as much width as it needs and can sit next to other elements

  • Hide/Show: Toggles visibility (useful to hide layouts on different devices)

Flexbox

In Candu, when you set Display to “Flex”, you unblock flexbox settings:

  • Content Direction: Horizontal (Row) or Vertical (Column)

  • Vertical Alignment: Creates a column of items (like a form)

  • Horizontal Alignment: Creates a row of items (like a navigation bar)

  • Wrap Mode: Wrap determines how your content adapts to different screen sizes. When “No Wrap” selected, items stay in one line and may overflow or shrink. When “Wrap” selected, items move to a new line when space runs out.

  • Column and Row Gap: Spacing between items (we’ll cover these in greater detail later).

Flex child

This is how you create responsive layouts where some elements stay fixed (like a logo) while others expand to fill space (like a banner). In Candu, these options include:

  • Grow if possible: Component expands to fill available space

  • Shrink if necessary: Component can get smaller if space is tight

  • Flex Base Size: Starting size before growing or shrinking

  • Align: Override the parent’s alignment for this specific child (stretch, start, center, end, baseline)

Don’t worry if this feels abstract! You’ll get a feel for these settings by experimenting in the editor.

Alignment (Vertical and Horizontal)

Controls where items are positioned along the vertical and horizontal axes within their container. In Candu, these options are available when using “Flex” and include:

  • Start: Items align to the beginning (left/top)

  • Center: Items align to the middle

  • End: Items align to the end (right/bottom)

  • Space Between: Items spread out with space between them

  • Space Around: Items have equal space around them

  • Space Evenly: Items have perfectly equal space between them and at edges

  • Stretch: Items expand to fill the container (for vertical alignment)

  • Baseline: Items align based on their text baseline (useful for text components)

Column and Row Gap

Gap is a way to add spacing between items. One setting handles all the spacing instead of managing margins on each component. In Candu, when using flexbox, you can set column gap (horizontal space between items) and row gap (vertical space between items) by pixels (px) or percentage (%).

Sizing & Spacing

Proper sizing is crucial for responsive design.

Size (Width & Height)

The dimensions of a component, meaning how wide and how tall it is. In Candu, every component has size settings with different units:

  • Pixels (px): Fixed size that never changes

  • Percentage (%): Size relative to the parent container

  • Auto: Let the component size itself based on screen size

You also see:

  • Min-width/Min-height: Smallest the component can get

  • Max-width/Max-height: Largest the component can get

Rule of thumb:

  • Use pixels for things that should stay the same size

  • Use percentages for things that should adapt to different viewports

  • Use auto for content that should adapt and stay centered

⚠️ Avoid this common mistake: Setting fixed pixels can causes content to break on smaller (mobile) viewports.

Overflow

When content is too big to fit inside its container, it can be hidden, create scrollbars, or spill out. In Candu, you’ll find these settings under Size:

  • Show: Content spills outside the container (usually not what you want)

  • Hide: Content is cut off at the container’s edge

  • Scroll: Scrollbars appear when content is too large

  • Auto: [Default] Scrollbars appear when needed

Spacing (Margin & Padding)

The space around and inside components.

  • Margin: Space outside the component (pushes other components away)

  • Padding: Space inside the component (pushes content away from edges)

In Candu, you can control margin and padding for all four sides (top, right, bottom, left) at once by clicking the 🔗 or individually. In the editor, you’ll see what this looks like around the component as well.

Z-Index

Controls the stacking order of elements (the z-axis or an imaginary axis perpendicular to the screen). This determines which elements appear on top of others when they overlap. In Candu, this setting is available for Overlays, Product Tours, and Hotspots.

Styling

Background

The color or image behind a component’s content. In Candu, every container can have:

  • Solid color: Choose from any color, add the hex code, or type TRANSPARENT for no color

  • Background image: Upload or link to an image URL

Tip: To add a gradient, upload a gradient image and set it to fill the entire background area.

Borders

A line around the edge of a component, with customizable thickness, color, and roundness. In Candu, you can control borders for all sides or individually:

  • Border Width: Thickness in pixels

  • Border Color

  • Border Radius: How rounded the corners are

  • Individual sides: Top, right, bottom, left, or all

  • Individual corners: Top-left, top-right, bottom-right, bottom-left for border radius

Shadow

Use shadows to make cards look clickable or make elements pop off the page. In Candu, you can customize shadows with:

  • Color

  • Offset X: Horizontal shift

  • Offset Y: Vertical shift

  • Blur: How soft/fuzzy the shadow is

  • Spread: How far the shadow extends beyond the component

Content Types

Inline (Document)

Content that appears to be a native part of your product’s page. Use Inline content for:

  • Help content embedded throughout your product

  • Empty states

  • Banners

  • Full page experiences

Learn more about inline content →

Modal (Overlay)

Content that appears on top of the page, typically with a backdrop behind it. Use Overlays for:

  • Announcements

  • Onboarding flows

  • Floating onboarding checklists

  • Forms

  • Feature showcases

Overlay-specific settings:

  • Position: Where the modal appears on screen

  • Z-index: By default set to 5000

  • Dismissible: Add an X button to close (configure icon color, stroke width, padding)

  • Backdrop: Show darkened background behind modal (yes/no) and its color

Hotspot

A tooltip that points to a specific element in your interface, with a pulsing beacon to draw attention. Use Hotspot for:

  • Highlighting new features

  • Providing contextual tips

  • Drawing attention

Hotspot-specific settings:

  • Type: Choose from styles in your style guide

  • Tooltip position: Auto (Candu decides) or Manual (you control)

  • Arrow size: Visual pointer connecting hotspot to target

  • Beacon: Pulsing dot (configure color, position, size, z-index)

  • Hotspot Group: Control whether first hotspot opens automatically

  • Dismissible: Let users minimize or dismiss hotspots

  • Z-index: By default set to 4000.

Product Tour

A guided walkthrough that takes users through multiple steps, highlighting different parts of your interface in sequence. Use Product Tours for:

  • Onboarding new users

  • Introducing complex workflows

Tour-specific settings:

  • Save progress: Remember where users left off if they exit the tour

  • Step progress: Require users to click target before advancing (ensures engagement)

  • Tooltip position: Auto or manual

  • Backdrop: Highlight the current step by dimming everything else (configure color, border)

  • Dismissible: Let users exit the tour (configure icon)

  • Z-index: By default set to 4000

To learn more about product tours, see this guide.

Components

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)

📌 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

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. 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 content dynamically

    • Send email: Trigger email notification

    • Trigger click: Click on behalf of the user

  • Image: 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

  • Player (Video/Audio): Embedded media player for video such as Wistia, Youtube, Vimeo or Vidyard. Configure players with:

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

    • Loading image: Placeholder shown before media loads

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

  • 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.

Advanced Concepts

Conditional Logic

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

Create conditional views by:

  1. Dragging content into a conditional view

  2. Setting conditions (user properties, segmentation, behavior)

  3. Adding alternative content for when a condition isn't met

Interactions (Lightning Bolt)

The interactions panel where you configure what happens when users interact with your content. Click the lighting bolt icon in the Toolbox to access interaction settings. Here you define:

  • Click/tap actions

  • Hover behaviors

  • Conditional logic

  • Dynamic content changes

Segments

Segmentation ensures your content is seen by the right audience. By default, Candu content is set to Everyone, and you can define a Segment by clicking on the honeycomb on the top bar next to the pencil icon.

Variables

Variables offer a great way to personalize your content at scale by allowing you to make the most of the data that you send through to Candu. All variables can be based on the same data that you pass over to Candu to create Segments. This usually consists of user traits like name, email, role type, and company. You can add variables to text and URLs.

For more details on variables, see this guide.

Next Steps

Ready to create your first content? Explore our template gallery for inspiration.


Need more help? Reach out to us via chat or email us at [email protected].

Did this answer your question?