# Accessibility on Komo Engagement Engine: A Quickstart Guide Source: https://knowledge.komo.tech/accessibility/general/accessibility-on-the-komo-platform-a-quickstart-guide/index Learn how to build inclusive digital experiences with Komo Engagement Engine that are accessible to users of all abilities ## Overview Accessibility ensures your digital experiences are inclusive, easy to navigate, and usable by everyone—including people with disabilities. Whether you're creating a prize draw, running a poll, or building an engagement site, making your experience accessible improves usability for all and is often a legal requirement in many regions. This guide provides an overview of how Komo Engagement Engine supports accessibility and the steps you can take to build inclusive, engaging experiences from day one. ## Accessibility by Default in Komo Engagement Engine Komo Engagement Engine comes pre-equipped with foundational accessibility features: * **Semantic HTML structure** for screen readers * **Keyboard navigability** across standard components * **High-contrast theme options** * **Accessible form elements** * **ARIA labels** on interactive components like buttons and modals These features are automatically applied, but their effectiveness depends on how you customize your content. ## Your Role: Making it Work for All As a creator, your input can either enhance or undermine accessibility. Here's what you can do: | Area | What to Do | | - | - | | **Text** | Use clear, concise language. Avoid overly decorative fonts. | | **Images** | Include meaningful alt text where possible, especially for logos and prize visuals. | | **Color** | Ensure sufficient contrast between text and background. Avoid using color alone to convey meaning. | | **Interactive Cards** | Keep instructions simple. Label buttons clearly. Test with just a keyboard. | | **Videos** | Add captions if the content is necessary for understanding the experience. | > [!TIP] > > ## Quick Checklist > > Before launching your campaign, ask yourself: > > * Can users navigate this site using only a keyboard? > * Are headings and labels clear and consistent? > * Does all text have good contrast against the background? > * Can screen reader users understand what's going on? > * Have I avoided flashing visuals that could cause discomfort? > [!TIP] > > ## Pro Tips for Testing Accessibility > > You don't need to be a developer to check your work. Try: > > * **WAVE by WebAIM** - Free web accessibility evaluation tool > * **Chrome's built-in Lighthouse accessibility audit** > * **Manual keyboard testing** - Using only your keyboard (Tab, Shift+Tab, Enter) to test flows > * **Screen reader testing** - Listening with a screen reader like NVDA (Windows) or VoiceOver (Mac) > [!TIP] > > ## Who Benefits? > > Accessibility helps more people than you might think: > > * Users with visual, motor, auditory, or cognitive impairments > * People on older devices or slow internet connections > * Multilingual users or those unfamiliar with digital formats > * Anyone using your experience in a noisy, low-light, or rushed environment # Designing Accessible Sites: Images, Colors, Contrast, and Font Best Practices Source: https://knowledge.komo.tech/accessibility/general/designing-accessible-sites-images-colors-contrast-and-font-best-practices/index Learn visual design best practices for creating inclusive and accessible Engagement Hubs with Komo Engagement Engine ## Why Accessibility in Design Matters The visual design of your Komo Engagement Hub plays a huge role in how inclusive and usable your experience is. Poor color contrast, hard-to-read fonts, or relying solely on visuals can make it difficult—or impossible—for some users to engage with your content. This article gives you practical, platform-aligned tips for designing with accessibility in mind—without sacrificing aesthetics or brand consistency. ## Images and Alternative Text Images can make your Komo Engagement Hub more engaging—but they should never become a barrier. Some users rely on screen readers to understand what's on the page, so images must be used thoughtfully. ### **Best Practices** * **Use alt text for meaningful images** - If an image conveys information (e.g. a prize, sponsor logo, or product), add clear alternative text describing it * **Skip alt text for decorative images** - If the image is purely visual (e.g. background confetti or design flourishes), leave the alt text blank so screen readers can skip over it * **Don't put important text inside images** - Text baked into an image can't be read by screen readers and often won't resize well on smaller screens. Use real text wherever possible > [!TIP] > > When uploading media to your site, always ask: **Would someone who can't see this image still get the message?** ## Choosing Accessible Colors Color can enhance your experience—but it shouldn't limit who can enjoy it. ### Best Practices * **Maintain strong contrast** - Aim for at least a 4.5:1 contrast ratio between foreground text and background * **Don't rely on color alone** - Always pair color cues (e.g. red for incorrect) with text or icons * **Test your palette** - Use tools like Colors Contrast Checker or WebAIM to validate your choices ## Fonts that Work for Everyone Fonts shouldn't get in the way of understanding your message. ### Best Practices * **Use legible, sans-serif fonts** - Avoid thin or decorative typefaces for body text * **Avoid all caps** in long stretches—use them sparingly for emphasis ## Design Pitfalls to Avoid Avoid these common mistakes: | Mistake | Why It's a Problem | | - | - | | Using pastel text on a white background | Low contrast = unreadable for many users | | Relying on hover states only | Not visible for keyboard users or mobile | | Using blinking or fast-animating visuals | Can trigger motion sensitivity or seizures | | Hiding key text in images | Screen readers can't access it | > [!TIP] > > ## Quick Checks Before You Publish > > * Can all text be read easily in daylight? > * Do links and buttons stand out clearly? > * Have you avoided color-only cues? > * Have you tested with one of the tools below? ## Tools We Recommend * [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/) * [Google Lighthouse](https://developer.chrome.com/docs/lighthouse/overview) * [Color Oracle](https://colororacle.org/) – Simulate colorblindness * [NoCoffee Vision Simulator](https://chromewebstore.google.com/detail/web-disability-simulator/olioanlbgbpmdlgjnnampnnlohigkjla?hl=en) (Chrome extension) – See how your site might look to users with vision impairments ## Want a Design Review? Send a link to your in-progress experience to [support@komo.tech](mailto:support@komo.tech) and we'll give you quick feedback to improve accessibility before launch. # How to Test Your Experience for Accessibility Source: https://knowledge.komo.tech/accessibility/general/how-to-test-your-experience-for-accessibility/index Before you hit "publish," it's important to make sure everyone can use and enjoy what you've built, no matter their device or ability ## Why Accessibility Testing Matters With Komo, it's easy to launch engaging digital experiences—quizzes, polls, scratch-and-wins, and more. But before you hit "publish," it's important to make sure everyone can use and enjoy what you've built, no matter their device or ability. This article walks you through a few simple things to check before launching your experience. ## Test on Different Devices Before you release: * View your experience on a **mobile phone** (both Apple and Android if possible) * View it on a **desktop computer or laptop** Check that everything looks clear, is easy to read, and that users can complete the experience with ease—whether by tapping, clicking, or using keyboard navigation. ## Fonts, Colors & Contrast Komo is configured to be as accessible as possible by default, but if you've changed fonts, background colors, or text colors, be sure to check: * Can you read the text clearly on all devices? * Does the text stand out from the background? * Is color being used **alone** to show meaning (e.g. red = wrong)? 👉 Need help choosing the right styles? [See Designing Accessible Sites](/accessibility/general/designing-accessible-sites-images-colors-contrast-and-font-best-practices) ## Images & Alternative Text Images add fun and flavor to your site—but remember: * Use **alt text** for any image that explains something important (like a prize or logo) * Decorative images (like background shapes) don't need alt text 👉 [Learn more in Accessibility on the Komo Platform](/accessibility/general/accessibility-on-the-komo-platform-a-quickstart-guide) ## Keyboard Testing Checklist Try your experience using only: * **Tab**: Move between interactive elements * **Enter / Spacebar**: Activate buttons * **Arrow keys**: Navigate options in sliders or choice-based cards ### Helpful Tools You don't need to be a developer to test your experience. These tools are free and easy to use: | Tool | What it Does | | - | - | | [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/) | Check that your text stands out clearly against your background | | [Google Lighthouse](https://developer.chrome.com/docs/lighthouse/overview) | A quick test in Chrome that spots common accessibility issues | | [Color Oracle](https://colororacle.org/) | See how your design looks for colorblind users | | [NoCoffee Vision Simulator](https://chromewebstore.google.com/detail/web-disability-simulator/olioanlbgbpmdlgjnnampnnlohigkjla?hl=en) | Chrome extension that simulates various vision challenges | ## Final Tip: Try It Like Your Users Would Before launching, try experiencing your site the way some of your users might: * **Turn on a screen reader** (VoiceOver on iPhone or TalkBack on Android) and listen to how your content is read out loud * **Use your phone's accessibility tools** to zoom, increase text size, or invert colors * **Navigate without using a mouse** — just tap around or use your phone's keyboard navigation features * **Try it on a small screen** — is everything still easy to read and interact with? If anything feels confusing, awkward, or missing—it probably will be for your users too. ## Still Have Questions? We're here to help! If you're unsure about anything accessibility-related—or just want a second set of eyes—reach out to [support@komo.tech](mailto:support@komo.tech). We'll be happy to review your experience with you. # Which Komo Cards Are Accessible (and Which Aren't) Source: https://knowledge.komo.tech/accessibility/general/which-komo-cards-are-accessible-and-which-arent/index Learn which Komo Engagement Engine interactive cards are fully accessible and which have limitations for inclusive experiences ## Komo Cards + Accessibility Komo Engagement Engine offers a wide range of interactive cards—such as quizzes, polls, Scratch and Win, Memory Challenge, and more—that can create fun and engaging experiences. But not every card is equally accessible. This guide helps you understand which Komo cards are fully accessible and which ones have limitations. It also provides practical tips for configuring each card to ensure your experience is inclusive for all users—whether they're using a keyboard, screen reader, or other assistive technology. ## Accessible Card Types > **Banner** > > A static, full-width visual card typically used for branding, announcements, or setting a tone for the Engagement Hub. > > **Best practices:** > > * Alternative text should describe the purpose of the image > * Place key messages in readable, overlaid text instead of embedding in the image > * Keep visual contrast strong between text and background > **Image & Image with Button** > > Displays a standalone image, optionally paired with a button to guide users to other content. > > **Best practices:** > > * Use descriptive alt text for the image to convey its meaning > * Button labels should clearly state what happens when clicked (e.g. "Enter Now" or "See Details") > * Avoid embedding key information inside images > **20 Words or Less** > > Prompts users to answer a question in 20 words or less using a simple text input. > > **Best practices:** > > * Provide clear written instructions or prompts > * Use high-contrast text over background > * Any accompanying images should have alt text > **Secret Code** > > Allows users to enter a code to unlock hidden content or rewards. The input field is screen reader accessible. > > **Best practices:** > > * Use clear instruction text to explain the action > * Avoid embedding instructions in images > **Quizzes** > > Presents one or more questions with multiple-choice answers, sometimes with scoring. > > **Best practices:** > > * Questions and answers should be written in text, not images > * Images used to support a question should have alt text > * Keyboard navigation is supported > * Results are announced by screen readers > **Personality Test** > > Presents users with a series of questions to determine a personality type, product match, or category result. > > **Best practices:** > > * All questions and answer options should be written in plain text > * Avoid using only images to convey questions or outcomes > * Add alt text for any illustrations or character graphics > * Keyboard navigation is supported throughout the experience > * Results are displayed on screen and announced by screen readers > * Use clear headings for readability > **Polls & Multi-Polls** > > Gathers audience opinion using single or multiple selections. > > **Best practices:** > > * Use text-based options and ensure questions are clearly phrased > * Keyboard navigation is supported throughout the experience > * Results are announced by screen readers > **Swiper** > > Users swipe left or right to indicate preference (e.g. like/dislike). > > **Best practices:** > > * Provide clearly labeled left and right buttons as an alternative to swiping > * Avoid relying on gesture-only input > * Screen reader users will hear the selected option before confirming > **Scratch and Win** > > Users scratch a surface to reveal a prize. > > **Best practices:** > > * A "Reveal" button is available for users who can't scratch > * Results are read aloud by screen readers > * Text descriptions of prizes should be included alongside visuals > **Spin to Win** > > Users spin a virtual wheel to receive a prize or message. > > **Best practices:** > > * Users can trigger the spin with the keyboard > * Outcome is read aloud by screen readers > * Keep on-screen labels short and descriptive > **Watch to Win** > > Users must watch a video to enter or claim a reward. > > **Best practices:** > > * Captions should be enabled for all videos. > * Playback controls work via keyboard. > * Instructions should explain what happens after the video. > **Treasure Hunt** > > Encourages users to discover content or complete a challenge. > > **Best practices:** > > * All hints and instructions should be presented as text. > * Avoid image-only clues. > * Progress is trackable with keyboard and screen reader support. > **Number Guess** > > User guesses a number using a slider or input field. > > **Best practices:** > > * Use clear labels to explain the number range. > * Ensure the context of the guess is explained (e.g. closest guess wins). > * Visual cues should be paired with text. > **Carousel** > > Displays a set of rotating content or images. > > **Best practices:** > > * All images should include alt text. > * Users can navigate carousel slides using visible buttons. > * Keyboard navigation is supported for navigating carousel slides. > **Carousel (Vote)** > > Allows users to cast a vote on carousel items (images, videos, or PDFs). Add it from **Media** → **Carousel (Vote)**. The older **Vote** card is no longer available to add. > > **Best practices:** > > * All images should include alt text. > * Vote options should use clear, concise language. > * Users can navigate carousel slides using visible buttons. > * Keyboard navigation is supported for navigating vote items. > * Users receive an on-screen confirmation message after submitting. > **User Generated Content (UGC) Upload** > > Lets users upload media like photos and videos. > > **Best practices:** > > * The image above the upload should have alt text. > * The upload button has information set for assistive technologies, including upload limits. > * Keyboard navigation is supported (Enter and Space) to open the file upload. > * Confirmation appears after a successful upload. > **Receipt Upload** > > Allows users to upload a receipt for validation. > > **Best practices:** > > * The image above the upload should have alt text. > * The upload button has information set for assistive technologies, including upload limits. > * Keyboard navigation is supported (Enter and Space) to open the file upload. > * Confirmation appears after a successful upload. > **Spotify Embed** > > Embeds a Spotify player to play a track or playlist. > > **Best practices:** > > * Keyboard navigation is supported. > * Inform users that playback controls are available. > * Add context text explaining what to listen for or why it matters. > **YouTube Embed** > > Displays an embedded YouTube video. > > **Best practices:** > > * Captions should be turned on by default if possible. > * Controls can be used with a keyboard. > * Avoid setting videos to autoplay. > **Facebook, Instagram, TikTok & X Embeds** > > Displays social media content in a feed or post format. > > **Best practices:** > > * Not all embeds are fully accessible—avoid using them as the only source of important content. > * Add a short summary or explanation next to the embed. > * Ensure the embed doesn't interrupt the experience flow. ## Cards That Have Accessibility Challenges The below cards have accessibility limitations and we do not recommend them for inclusive user experiences. > **Live Trivia** > > A real-time quiz where players must respond within a countdown. > > **Best practices:** > > * Requires fast, visual interaction. > * Timers cannot be paused or extended. > * Screen readers and slower users may not keep up. > * Better alternatives include simple quizzes. > **Live Predictor** > > Users submit predictions for future outcomes by answering questions. > > **Best practices:** > > * Not completely accessible for keyboard or screen reader currently, ongoing work is being conducted to improve accessibility with this card. > * Better alternatives include simple quizzes and number guess. > **Memory Challenge** > > Users match image pairs under time pressure. > > **Best practices:** > > * Requires fast, visual interaction. > * Timers cannot be paused or extended. > * Not accessible for keyboard or screen reader users. > * Better alternatives include simple quizzes and polls. > **Picker** > > A visual selection interface with interactive mechanics. > > **Best practices:** > > * Heavy visual experience that has limited keyboard support currently. > * Screen reader support is currently limited. > * Better alternatives include simple quizzes and polls. ## Need Help? Not sure which card to use? Want help reviewing your experience for accessibility? Reach out to [support@komo.tech](mailto:support@komo.tech) and we'll be happy to assist you. # Add new members to your company Source: https://knowledge.komo.tech/account-settings/account-management/add-new-members-to-your-company/index Adding a new member to your company platform enables others to edit the front and back-end of your hub. ## What is it When inviting new members you have the choice to give them a role of either a viewer, editor, or owner. Viewers will only be able to overlook your company without the ability to edit. The editor role grants these lack of permissions and the owner grants equal ability to you. You also have the ability to resend invites if needed. ## How do I do this? * [Step 1: Navigate to the Company settings](#step-1-navigate-to-the-company-settings) * [Step 2: Invite new members to join your company](#step-2-invite-new-members-to-join-your-company) ### Step 1: Navigate to the Company settings ![Add new members to your company: step 1 — Step 1: Navigate to the Company settings](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/add-new-members-to-your-company-step-1-navigate-to-step-1.gif?s=b01bc03635ccb4a5f4efee775d16799e) * Head to the **Company settings** on the company dashboard. ### Step 2: Invite new members to your company ![Add new members to your company: step 2 — Step 2: Invite new members to your company](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/add-new-members-to-your-company-step-2-invite-new-step-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=11679f1954fe6e544ca940c699b1c544) * **(1)** Under the Company members section, click on **Invite member.** * **(2) + (3)** Enter the new member's **email and name**. * **(4)** Select the **role** for the member. You can select from three; viewer, editor or owner. * Once a member has been invited, they will receive an email promoting them to create an account. ## FAQ **How do I change a member's email address (for example, after a company rebrand)?** On the **Company Members** page (under **Company Settings**), you can update an accepted member's email. Changing the email does not change their role or workspace access unless you also change those. 1. Open **Company Settings → Company Members**. 2. If your company has **Allowed Members** rules (**Email domains** or **Email addresses**), the new email must match them — otherwise the form shows "Email does not match required format for company". When moving to a new email domain, add it under **Allowed Members → Email domains** first (this section is visible to members with the **Owner** role). 3. In the members table, open the **...** menu for the member and select **Update**. 4. In the **Update member** modal, change the **Email** field. You can also update **Name**, and **Role** if you are allowed to assign roles. 5. Click **Update**. A "Member updated" toast appears. Komo sends a notification about the change to the member's old email address. The new email can't already be used by another Komo account — if it is, the update won't save and the **Email** field shows an error ("Invalid email" or "Email is already used"). Members can update their own name and email; updating other members needs member-management permission (for example, the **Owner** role). **Can I resend the invite if I have entered the wrong details?** **Resend Invite** sends the same invite again — it does not change the name, email, or role. For a pending invite (not yet accepted), the **...** menu only has **Resend Invite** and **Revoke member**; there is no Update or edit option. To fix a wrong email or other details, click **Revoke member**, then invite the person again with the correct details. **Why would I want to add a viewer over an editor?** You might find it useful to add specific members as viewers, such as marketers, collaborators and peers so that they can overlook relevant hub analytics, promotion mechanics, and user details. **What is the difference between editor and owner?** Owners can edit the portal, invite new members, revoke member invites, update details and delete members while an editor can edit the portal, manage API keys, and send password reset links for members. # Events Published to Tag Manager Data Layers Source: https://knowledge.komo.tech/account-settings/analytics/events-published-to-tag-manager-data-layers/index A list of events published to Tag Manager Data Layers ## Introduction When using Komo Engagement Engine for your marketing or promotional campaigns, it's crucial to track user interactions effectively. Komo Engagement Engine supports both **Google Tag Manager (GTM)** and **Adobe Launch Tag Manager**, which are commonly used to manage and implement tracking. Komo Engagement Engine automatically pushes important events to the respective data layers of these tag managers, giving you deep insights into user behavior without extensive manual configuration. In this article, we'll explain the events Komo Engagement Engine publishes to the data layers, how to access them, and provide sample code to retrieve the data in **Google Tag Manager (GTM)** and **Adobe Launch Tag Manager**. ## Supported Tag Managers ### Google Tag Manager (GTM) Google Tag Manager is a versatile tool that allows you to manage tags and track user interactions without modifying your code base constantly. GTM uses a JavaScript array called `dataLayer` to hold information about events and their related data. * [Google Tag Manager Documentation](https://support.google.com/tagmanager/answer/6102821?hl=en-GB\&sjid=9005108592727786343-AP) * [Komo's support for Google Tag Manager](/integrations-automation/tag-management/connect-google-tag-manager-to-your-hub) ### Adobe Launch Tag Manager Adobe Launch Tag Manager is another popular tool for managing tags and tracking user events. It uses `adobeDataLayer` to store and pass data from your site to Adobe Analytics or other tools you use within the Adobe Experience Cloud. * [Adobe Launch Tag Manager Documentation](https://experienceleague.adobe.com/docs/launch.html) * [Komo's support for Adobe Launch Tag Manager](/integrations-automation/tag-management/connect-adobe-launch-tag-manager-to-your-hub) ## Events Published by Komo Komo Engagement Engine automatically publishes key user interaction events to the respective tag manager's data layer `dataLayer` for Google Tag Manager, `adobeDataLayer` for Adobe Launch). Below is a list of the most common events and what they represent: | Event Name | Description | | :- | :- | | `auth-view` | Triggered when a user views the authentication page or dialog on the platform. | | `card-action` | Triggered when a user performs a specific action on an interactive card. These actions can include: - Competition - ExternalLink - ScrollToCard - OpenProfileDrawer | | `card-answered` | Triggered when a user answers a question on a card, such as Quiz, Poll, Personality Test or Predictor. | | `card-finished` | Triggered when a user completes a gameplay experience for a card. | | `card-item-viewed` | Triggered when a user views an individual item within a card, such as a Vote or Carousel item. | | `card-shared` | Triggered when a user shares a card via the Share options for a card. | | `card-social-click` | Triggered when a user clicks on a social media link within a card. | | `card-started` | Triggered when a user begins interacting with a card. | | `card-viewed` | Triggered when a card is viewed by a user. | | `coupon-redeemed` | Triggered when a user redeems a coupon offered through a card. | | `coupon-viewed` | Triggered when a user views a coupon offered through a card. | | `cover-clicked` | Triggered when a user clicks the cover image or button for a card. | | `embedded-card-page-viewed` | Triggered when a user views a page that has a Komo card embedded in it. | | `form-start` | Triggered when a user begins to fill out a form. | | `form-submission` | Triggered when a user submits a form. | | `page-viewed` | Triggered when a user views a specific page on a hub. | | `single-card-page-viewed` | Triggered when a user views a standalone single-card page. | | `survey-form-field-touched` | Triggered when a user interacts with a field on a Survey card. | | `survey-screen-finished` | Triggered when a user completes a screen within a Survey card. | | `survey-screen-started` | Triggered when a user starts a screen within a Survey card. | | `survey-screen-viewed` | Triggered when a screen within a Survey card is viewed by a user. | | `survey-submitted` | Triggered when a user submits a completed Survey card. | | `survey-viewed` | Triggered when a user views a Survey card. | | `trivia-card-action-bar-clicked` | Triggered when a user clicks a link in the action bar of a Live Trivia card. Includes the `gameplayStage` (`lobby`, `questions`, `finished`, `answers`, or `rules`) and the `link` that was clicked. | | `trivia-card-prizes-viewed` | Triggered when a user views the prize options in a Live Trivia card. | | `video-card-finished` | Triggered when a user finishes watching the video on a Video card. | | `video-card-paused` | Triggered when a user pauses the video on a Video card. | | `video-card-played` | Triggered when a user starts playing the video on a Video card. | | `video-card-resumed` | Triggered when a user resumes a paused video on a Video card. | | `video-card-viewed` | Triggered when a Video card is viewed by a user. | These events provide granular insight into user activity on Komo Engagement Engine, giving you the ability to measure engagement and adjust your campaigns accordingly. ## Tracked Properties Include selected contact properties on interaction events that flow to GTM and Adobe data layers. 1. Hub → **Settings** → **Tracked Properties** 2. UI subheading: **Track additional contact properties in your frontend web analytics integrations** 3. **Add Tracked Property** and select a contact property to include Selected properties appear on interaction events as `trackedData` and are pushed with those events to your tag manager data layers. > [!WARNING] > > Only **non-PII** contact properties can be tracked. When adding a property you must confirm it does not contain Personally Identifiable Information (PII) or other sensitive data — tracked values are revealed on the frontend. > [!TIP] > > Payload shape and field reference: [Tracked Data (developers.komo.tech)](https://developers.komo.tech/tracked-data). > [!NOTE] > > Also see [Tag Management](/integrations-automation/tag-management) for connecting GTM or Adobe Launch to your hub. ## Accessing the Data Layers ### Google Tag Manager: Accessing `dataLayer` When Komo publishes an event, it gets pushed to the `dataLayer` array in GTM. You can access this data using the following code in your web browser’s developer console or within your GTM tags: ```javascript theme={null} console.log(window.dataLayer); ``` To capture specific events, you can create a custom event trigger in GTM: 1. Open **Google Tag Manager** and go to your **Triggers**. 2. Click on **New Trigger** and choose **Custom Event**. 3. In the event name, add the event you want to capture, for example, `card-viewed`. 4. Save and publish your trigger. Once this trigger is set, you can send data to Google Analytics or other connected services for reporting. ### Adobe Launch Tag Manager: Accessing `adobeDataLayer` In Adobe Launch Tag Manager, Komo pushes events to the `adobeDataLayer`. You can access the data using the following ```javascript theme={null} console.log(window.adobeDataLayer); ``` To create a rule in Adobe Launch for specific events like form-submission: 1. In **Adobe Launch**, navigate to **Rules** and create a new rule. 2. Choose **Event Type** as `Custom Event`. 3. In the event configuration, define the event name (e.g., `form-submission`). 4. Save and publish your rule. This allows you to capture and analyze data from the Komo platform in Adobe Analytics or any other tools you have integrated with Adobe Launch. ### Example: Creating a Custom Trigger in Google Tag Manager Here’s a sample code for creating a custom event trigger for the `card-viewed` event in GTM: 1. In **GTM**, navigate to **Triggers** and click on **New**. 2. Choose **Custom Event** from the list of available trigger types. 3. In the **Event Name** field, enter `card-viewed`. 4. Set the trigger conditions if necessary (e.g., only fire the trigger on specific pages). 5. Click **Save** to finalize the trigger. You can now link this trigger to a tag, such as sending data to Google Analytics whenever a user views a card on Komo. ## Conclusion By leveraging the events Komo Engagement Engine publishes to `dataLayer` and `adobeDataLayer`, you can gain deep insights into user behavior and engagement. Whether you're using Google Tag Manager or Adobe Launch, these events enable you to track meaningful user actions, analyze campaign performance, and make informed decisions to optimize your platform's performance. For more information on setting up Google Tag Manager or Adobe Launch, refer to the official documentation linked above. # Insights and Dashboards Source: https://knowledge.komo.tech/account-settings/analytics/insights-and-dashboards/index Create custom insights and dashboards to stay up to date with the most important metrics across your workspace and hubs. ## What is it? Our Custom Insights and Dashboards feature is designed to give you complete control over how you visualize and interpret your activation data. With this tool, you can create tailored insights and dashboards that highlight the key metrics most relevant to your specific goals, allowing you to stay up to date with critical performance indicators across your entire workspace and Engagement Hubs. ## How do I set it up? ### Step 1: Create an Insight ![Insights and Dashboards: step 1 — Step 1: Create an Insight](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-1-create-an-step-1.gif?s=53537c45b4d7df3f11d111d200a4f320) * From within your workspace, navigate to **Insights** (located under Reporting in the left-hand column) * Once there, click **+ Create insight** * You will then see that your new insight has been created ### Step 2: Edit Insight parameters ![Insights and Dashboards: step 2 — Step 2: Edit Insight parameters](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-2-edit-insight-step-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=41c42670b8bf24cff386d993eb050ede) * **(1)** Give your Insight a relevant **Name** * **(2)** Provide a **description** that makes clear what your insight is showing * **(3)** Click the dropdown and select the insight **Series** you wish to be displayed > **Viewing Insight Series** > > ![Insights and Dashboards: option a — Step 2: Edit Insight parameters](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-2-edit-insight-option-a.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=7fd1cc5b1b5cb9640caa25f3f32cb92e) > > * **(A) Content Impressions** are events raised for a piece of content when it is in view for more than 2s, once per page load > * **(B) Coupon Events** are events raised when users receive, view, or redeem coupons > * **(C) Engagements** are events raised when users interact with content > * **(D) Entries** are the number of entries submitted via data capture forms on your content > * **(E) Gating Events** are events raised when users pass through a site gate e.g. age verification > * **(F) Page Views** are events raised when users view a page of content. Includes Engagement Hub pages, embedded content pages, and single card pages > * **(G) Share Events** are events raised when users share content > * **(H) Sessions** are a series of user session events that occur on a single device and browser. Sessions are ended after 30 minutes of inactivity * **(4)** Click the dropdown and select the **aggregation** you wish to be applied to your insight > **Applying Aggregation** > > ![Insights and Dashboards: option a — Step 2: Edit Insight parameters](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-2-edit-insight-option-a-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=70101fd81e7eb270d6549481e4248ded) > > * **(A) Total count** displays the total number of series events > * **(B) Unique sessions** displays the series event by number of unique sessions > * **(C) Unique Contacts** displays the series events by the number of unique contacts * **(5)** Here you can opt to apply **filters** to your insight > **Insight Filters** > > ![Insights and Dashboards: option b — Step 2: Edit Insight parameters](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-2-edit-insight-option-b.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=42c9d4dbcb4830c6d5c03e7ed8f3e72b) > > * **(A)** Here you can set the **filter parameters** for your insight * **(6)** Here you can **rename** your series (if desired) * **(7)** If you wish to **delete** your series, you can click the **bin icon** * **(8)** By selecting **Enable formula mode** you can enter a formula to calculate your series data * **(9)** Here you can opt to **breakdown** or slice your series by a range of variables * **(10)** Click **+ Add series** to include additional series data in your insight * **(11)** Here you can change the **time period** and **grouping** of the displayed insight * **(12)** Click **Options** to customize how the series is displayed * **(13)** Here you can change the **visualization format** for the series * **(14)** View the **visualization** of your series data over time and scroll over the line to view point-in-time metrics * **(15)** Scrolling down, you can view your series insights in **table form** * **(16)** Here you can export the data in CSV format * **(17)** Once satisfied with your insight parameters, click **Save** * You will now see that your insight has been created ### Step 3: View your Insight ![Insights and Dashboards: step 3 — Step 3: View your Insight](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-3-view-your-step-3.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=41a2ac75c556c9cfae50357ca67c2b56) * Now that your insight is created, you have the ability to **view** and **analyze** the data * **(1)** Click **Edit** to make any changes to the saved insight * **(2)** Here you can change the **time period** and **grouping** displayed * **(3)** By clicking **Options** you can customize how the insight is displayed * **(4)** Click here to change the **visualization format** for the data * **(5)** Here you can view the data in **table form** * **(6)** Select **export** to export the data in a CSV format ### Step 4: Create a Dashboard ![Insights and Dashboards: step 4 — Step 4: Create a Dashboard](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-4-create-a-step-4.gif?s=93617cef9d0fcfc87642b6f17570e04a) * After creating one (or multiple) insights, you can create custom dashboards, centralizing your insights in a single view * Navigate to **Dashboard** (located under Reporting in the left-hand column) * Click **+ Create Dashboard** * Give your dashboard a relevant **Name** and **Description** and select **Create** * Click **+ Add insight** * Add the insight(s) you wish to display on the dashboard by selecting the **checkbox** next to the insight name * Click **Add (x) insights** * You will now see your newly created dashboard with the desired insights displayed ### Step 5: View your Dashboard ![Insights and Dashboards: step 5 — Step 5: View your Dashboard](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/insights-and-dashboards-step-5-view-your-step-5.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=c20c51514dc2a8628ff4d6dd6d25d6e1) * You can now view and customize your dashboard as desired * **(1)** Click the **three dots** to **Rename, Clone**, or **Delete** the dashboard * **(2)** You can reorganize how the dashboard displays by selecting **Edit layout** and **dragging** and **dropping** the insight modules as desired * **(3)** Click **+ Add insight** if you wish to include additional insights on your dashboard * **(4)** Here you can **Add a text widget** that can be used to leave comments, annotations, and titles on your dashboard * **(5)** Click here to change the **time period** displayed for the insights * **(6)** Click the **three dots** to **edit, view**, or **delete** individual insights ## FAQ **What is a series?** A series refers to a sequence of related data points collected or observed over a period of time or across different categories. It can be presented as a time series or categorical series depending on the nature of the data. **Can I break down Insights by Badges?** **Badges** may not appear in the Insights **breakdown** dropdown currently. Use other breakdown dimensions available in the UI, or export series data if you need badge-related reporting elsewhere. # Data Collection and Analytics Source: https://knowledge.komo.tech/account-settings/faqs/data-collection-and-analytics/index Learn what data Komo collects through forms and interactions, how data connects with external systems, and how to report on campaign performance. Komo enables you to collect first-party and zero-party data through interactive experiences and forms. This includes system-defined and custom properties, contextual user agent data, and interaction data generated through engagement. ## Komo Contacts When a user first engages without submitting any identifiable data, Komo records them as an Anonymous Contact. Once the user submits a form with a uniquely identifying piece of data, such as an email address or mobile number, they transition to Identified. Further steps, such as contact verification through email confirmation or SSO, can elevate them to Authenticated Contacts. From there, whenever Komo sees that contact again, it continues to build upon a unified Contact profile. ## Data that can be collected through forms ### System properties These are default, built-in properties that can be captured through Komo forms: * First Name * Last Name * Email * Mobile * Address * Postcode * Date of Birth * Birth Year * Country ### Custom properties * You can create custom fields that map to the data you want to capture or to existing data in external systems. * Custom properties can capture additional attributes relevant to your campaign, such as favourite brand, purchase intent, or membership ID. * Custom properties can be applied to forms or embedded directly into games and other interactive experiences. ### Opt-ins and consent Komo provides built-in tools for handling consent and opt-ins: 1. **Communication Subscriptions and consent fields** manage ongoing marketing consent. They can power Komo's communication features and map to external systems. 2. **Opt-in form fields** support one-time confirmations, such as accepting terms and conditions or verifying age. ## Data collected outside forms ### User agent The following data is collected automatically in the background to enrich user profiles and support reporting: * IP address * Location derived from the IP address * Device type, such as desktop, tablet, or mobile * Browser information ### Interaction data Interaction data is captured whenever a user engages with a Komo experience. Read more about the specific event payloads in the [developer documentation](https://developers.komo.tech/user-interaction-events). #### Page and container events * `page-viewed`: A Komo page is viewed. * `embedded-card-page-viewed`: A page with an embedded Card is viewed. * `single-card-page-viewed`: A standalone single-Card page is viewed. #### Generic Card events * `card-viewed`: A Card is displayed to the user. * `card-started`: The user begins interacting with a Card. * `card-answered`: The user answers a question within a Card. * `card-finished`: The user completes a Card. * `card-item-viewed`: The user views an item within a Card, such as a slide or option. * `card-action`: The user clicks or triggers a defined Card action. * `card-shared`: The user shares a Card. * `card-social-click`: The user clicks a social link or action on a Card. * `cover-clicked`: The user clicks a Card's cover or hero area. #### Live Trivia events * `trivia-card-action-bar-clicked`: The trivia action bar is clicked. * `trivia-card-prizes-viewed`: The user views prize information on a Live Trivia Card. #### Video events * `video-card-viewed`: The Video Card is shown. * `video-card-played`: Video playback starts. * `video-card-paused`: Video playback is paused. * `video-card-resumed`: Paused video playback resumes. * `video-card-finished`: Video playback completes. #### Coupon events * `coupon-viewed`: A coupon is viewed. * `coupon-redeemed`: A coupon is redeemed. #### Form events * `form-start`: A user starts a form. * `form-submission`: A user submits a form. #### Survey events * `survey-viewed`: A survey is viewed. * `survey-screen-started`: The user enters a survey screen. * `survey-screen-viewed`: A survey screen is displayed. * `survey-screen-finished`: The user completes a survey screen. * `survey-form-field-touched`: A survey field is interacted with. * `survey-submitted`: A survey is submitted. ## Data sync, sharing, and integrations ### Syncing and sharing data with external systems Komo can send collected data to external systems. Through CRM Sync or Workflows, contact data, events, activities, and attributes can be pushed to third-party software when the target system exposes an API for integration. ### Custom events and ingesting data Komo supports ingesting external data through Custom Events. This allows contact data, external activities, and system events to flow into Komo in a consistent, structured way for segmentation, automation, and analytics. * Custom Events can represent external activity such as transactions, POS activity, website events, or other system-generated actions. * Events can be linked to existing Contacts or stored against anonymous users until they become identified. * Each event type can trigger Workflows. These can add Contacts to lists or segments, update loyalty tiers, add Contacts to campaign flows, sync data to external CRMs, or trigger follow-up campaigns. * Custom Events are defined by schemas created in Komo. Incoming data must match the schema or be transformed to fit it. ## Insights, analytics, and Dashboards Komo provides built-in tools for creating custom reports, called Insights, and Dashboards to help you measure engagement and performance across campaigns. [Learn how to set up Insights and Dashboards](/account-settings/analytics/insights-and-dashboards/index). You can create Insights based on the following data points: * **Impressions and page views:** How many people saw a page, Card, or campaign. * **Engagement and interactions:** Gameplay activity, form starts and submissions, survey responses, quiz answers, and coupon redemptions. * **Contact growth and engagement:** How many new Contacts have been identified and captured, and how often they return. * **Performance over time:** Trends in participation and engagement. * **Breakdowns:** Analyse any Insight by Site, Card, country, city, device, or browser. Komo provides more than 30 Insight templates out of the box, with more added over time: ### Impressions * Content Impressions (Total count) by Card * Total Content Impressions * Unique Content Impressions * Total vs Unique Impressions Per Day ### Engagements * Engagements (Total Count) * Engagements (Unique Contacts) * Engagement Rate * Engagement to Entry % Per Card * Impression to Engagement % Per Card * Unique Impressions to Unique Engagements % Rate (All Cards) * Total vs Unique Engagements Per Day ### Entries * Total Entries * Unique Entries * Entry Rate (Entries/Views) * Entry Rate per Card * Unique Entries by Card * Unique Entries by Card (%) * Engagement to Entry % Per Card * Impression to Complete/Enter % Per Card * Unique Engagements to Unique Entries % Rate (All Cards) * Unique Impression to Unique Completion % Rate (All Cards) ### Time and sessions * Total Engagement Time * Sum of Engagement Time / Unique Contacts * Sessions 90th Percentile * Sessions 90th Percentile Engaged * Sessions (95th Percentile Duration) * Sessions (95th Percentile Engaged Duration) * Sessions (99th Percentile Duration) * Sessions (99th Percentile Engaged Duration) ## Summary Komo provides a privacy-conscious framework for data collection: * System properties capture key identifiers. * Custom properties support campaign-specific data. * User agent data adds context and supports analytics. * Interaction data provides insight into engagement, behaviour, and preferences. Together, these categories support Komo's first-party and zero-party data strategy, enabling you to understand, segment, and activate your audiences. # Data Privacy FAQ Source: https://knowledge.komo.tech/account-settings/faqs/data-privacy-faq/index Learn what data Komo collects, how it is stored and used, who owns it, how to access or delete it, sub-processors, consent, and compliance. ## TL;DR * Any data your end users provide through the Komo Engagement Engine is **your data** — Komo does not claim ownership of it. * You control what is collected, how consent is presented, and how that data is used; Komo processes and stores data on your behalf to deliver the platform. * Komo keeps data secure and only shares it with sub-processors required to run the service. * Marketing communications require explicit opt-in before any message is sent. ### Contents * [Roles and ownership](#roles-and-ownership) * [What data is collected](#what-data-is-collected) * [How data is collected](#how-data-is-collected) * [How data is used](#how-data-is-used) * [Storage and retention](#storage-and-retention) * [Access, export, and deletion](#access-export-and-deletion) * [Sharing and sub-processors](#sharing-and-sub-processors) * [Cookies and consent](#cookies-and-consent) * [Security](#security) * [Compliance and legal](#compliance-and-legal) * [Contact](#contact) > [!WARNING] > > Please note that the information and advice that Komo provides regarding privacy, consent, data processing, or any other matter of this nature is of a general basis only, and we suggest you seek your own legal advice specific to your needs. ## Roles and ownership > **Who owns the data?** > > Any data captured on the Komo Engagement Engine is owned by **you**, not Komo. We do not place any rights on the data other than what is required to deliver the service under our [Terms of Service](/account-settings/faqs/data-privacy-faq#terms-of-service). > > You represent and warrant that you have obtained all necessary rights and permissions to collect and use the data you submit to the platform. > **What is Komo's role vs ours as data controller?** > > In general, **you** decide what personal data to collect, the legal basis for collection, and how end-user data is used for your campaigns and communications. **Komo** processes that data on your behalf to operate the Engagement Engine — hosting, delivery, support, security, and integrations you configure. > > The relationship is governed by our Terms of Service and, where applicable, a Data Processing Agreement (DPA). This FAQ is general guidance only; your legal team should confirm roles and obligations for your jurisdiction and use case. > **Does Komo sell or license our end-user data?** > > No. Komo does not sell, rent, or license your Customer Data to third parties for their own marketing or data enrichment purposes. Data is processed solely to deliver the services covered under our [Terms of Service](/account-settings/faqs/data-privacy-faq#terms-of-service). > **Can Komo staff access our data?** > > Komo personnel may access Customer Data only when authorised and typically only to resolve a support issue. All Komo staff are bound by confidentiality obligations and NDAs. See [Are Komo staff under an NDA?](#security) in Security. ## What data is collected > **What types of data can Komo collect on our behalf?** > > Komo collects only the data you configure the platform to capture. This typically falls into: > > * **Identity and contact details** — name, email address, mobile number, and any [contact properties](/crm/contacts/contact-properties/index) you create (e.g. date of birth, postcode, favourite team). > * **Competition and form responses** — answers submitted through [data capture forms](/getting-started/hub-setup/data-capture/index), including free-text responses, poll and quiz answers, and receipt uploads. > * **Engagement and behavioural data** — card interactions, game progress, badge achievements, hub visits, and entry history tied to a contact profile. > * **Consent records** — terms and conditions acceptance, [communication subscription](/crm/communications/communication-subscriptions/index) opt-ins, and cookie consent preferences. > * **Technical metadata** — IP address, timestamps, and device/session information used for fraud prevention, analytics, and platform operation. > > You decide which fields appear on each form and which are required. Komo does not automatically append third-party enrichment data to your contacts. > **What is the difference between anonymous, identified, and authenticated contacts?** > > Komo classifies end users based on what they have shared: > > * **Anonymous** — visited your Engagement Hub but has not provided identifying information. > * **Identified** — the end user has supplied identifying information (for example through a public data capture form), but Komo has not verified who they are. There is no email validation at this stage, and this is not the same as **Authenticated** (account login or SSO). Think of a standard competition or form submission where someone enters their details without proving their identity. > * **Authenticated** — created an account within your Engagement Hub and completed the required profile fields. > > See [Contacts](/crm/contacts/index) for more detail on how contact profiles are built over time. ## How data is collected > **How does Komo collect data from our end users?** > > Data is collected when end users interact with your Engagement Hub and the experiences you configure: > > * **Data capture forms** — attached to competitions, games, polls, and other cards. You configure the fields, required status, and consent checkboxes for each form. See [Data Capture](/getting-started/hub-setup/data-capture/index). > * **Account registration and profiles** — when authentication is enabled, users can create accounts and build profiles over repeat visits. > * **Passive engagement tracking** — card views, completions, and gameplay events are recorded against a session or contact profile for analytics and personalisation. > * **Integrations** — data can flow to or from external systems (CRM, email platforms, tag managers) based on rules and filters you configure. See [Integrations & Tag Management](/integrations-automation/tag-management/index). > > Komo does not collect data independently of the experiences you publish. You are responsible for ensuring you have the appropriate legal basis and notices in place for the data you choose to collect. > **Can we control exactly what we ask for on each form?** > > Yes. Every data capture form is fully configurable. You can: > > * Add, remove, and reorder fields using existing contact properties or create new ones. > * Mark fields as required or optional. > * Attach your [terms and conditions](/getting-started/resources/terms-conditions/index) to a mandatory T\&Cs acceptance checkbox. > * Add [communication subscription](/crm/communications/communication-subscriptions/index) consent fields for marketing opt-in. > * Set a [default data capture form](/getting-started/hub-setup/default-data-capture-form/index) at the Hub level and override it per card where needed. > > Nothing is collected through a form unless you have added the field and the end user submits it. ## How data is used > **How does Komo use the data we collect?** > > Komo uses Customer Data only to: > > * Operate and deliver the Engagement Engine (competitions, communications, CRM, analytics, and integrations you configure). > * Provide customer support when you or your end users raise an issue. > * Maintain platform security, monitor performance, and prevent fraud. > * Comply with legal obligations. > > Optional AI features process data only when you enable those features. Komo uses aggregated and anonymised platform data internally to improve the product. Komo does not use your Customer Data for Komo's own marketing to your end users. > **How can we use the data we collect?** > > As the data owner, you decide how to use the first-party data captured through Komo — for example: > > * Segmenting contacts and running prize draws. > * Sending [marketing communications](/crm/communications/communication-subscriptions/index) to opted-in subscribers. > * Syncing opted-in contacts to external CRMs and email platforms via [workflows and integrations](/integrations-automation/workflows/triggers). > * Exporting data for reporting, fulfilment, or transfer to your own systems. > > You must comply with your own privacy policy and all applicable laws governing how you use personal information. ## Storage and retention > **Where is our data stored?** > > Customer Data — the data your end users submit through the platform, including contacts, entries, form responses, and engagement history — is stored on infrastructure provided by **Google LLC** in one of the following data regions. > > **US1** and **AU1** are platform data regions. They determine which admin portal you use, which country your data is stored in and how your published Engagement Hub URLs are routed — not where Customer Data is physically stored: > > * **US1** — admin portal at [app.us1.komo.cloud](https://app.us1.komo.cloud); published sites use `*.komo.site` or `*.us1.komo.site` > * **AU1** — admin portal at [app.au1.komo.cloud](https://app.au1.komo.cloud); published sites use `*.au1.komo.site` > > Content is delivered globally via **Cloudflare, Inc.**, which routes traffic to the nearest edge data centre for performance. See [Sharing and sub-processors](#sharing-and-sub-processors) for how third-party providers fit into delivery and storage. > > Komo may disclose data to overseas service providers as described in our Terms of Service. We take reasonable steps to ensure data is handled in accordance with applicable privacy standards, including GDPR Standard Contractual Clauses and UK international data transfer mechanisms where applicable. > > Komo Technologies Pty Ltd is based in **Perth, Western Australia**. > **How long is data retained?** > > You control retention of your Customer Data during your subscription. You can export or delete contacts at any time from the Komo portal — see [Access, export, and deletion](#access-export-and-deletion). > > After a subscription ends, you may export Customer Data for up to **30 days** using the platform's export features. Komo may retain automated backup copies for up to 30 days from creation before they are destroyed. > > You are solely responsible for meeting your own data retention obligations under applicable law. > **Can Komo automatically delete entry data after a set period (for example 3 months)?** > > No. Komo does not provide a customer-configurable schedule that automatically deletes competition entries after a retention period. You control retention by exporting and deleting data yourself from the portal when your policy requires it. You remain responsible for meeting your own retention obligations under applicable law. ## Access, export, and deletion > **How can we access and export our data?** > > You can access your data at any time through the Komo portal: > > * **Contacts** — view, search, filter, and export your full contact list as CSV. See [Contacts](/crm/contacts/index). > * **Entries** — export competition entry data including form responses and consent status. See [Entry Management](/interactive-features/features/entry-management/index). > * **Integrations** — push data to external CRMs, webhooks, and automation tools based on rules you define. > > During your subscription and for up to 30 days after it ends, you can export Customer Data at no additional charge using the platform's existing export features. > **How do we export competition entries before a purge?** > > Use [Entry Management](/interactive-features/features/entry-management/index) on each card to export entries as CSV (optional zip with uploaded files). You can filter first, then export. Exports run as background jobs and the download is emailed to you. Export files are cleaned up after 30 days. > > For contact-level exports, see [Contacts](/crm/contacts/index). There is no single export that covers every competition in the workspace at once. > **Can we delete end-user data?** > > Yes. You can delete individual contacts from the Contacts area, or bulk-delete every contact in a workspace from the Workspace settings. Deletion is permanent and cannot be undone. > > Komo will not modify User data except as agreed with you in writing. > **What happens when we delete a competition entry?** > > Deleting a competition entry permanently removes that entry and its form submission from the product. The related **Contact** profile is not deleted. The portal confirms this with **Permanently delete entry**. > > To remove personal data at the contact level, delete the contact from [Contacts](/crm/contacts/index), or use workspace [bulk contact delete](#access-export-and-deletion). That process tombstones the contact so aggregate analytics remain intact. See [Can we delete end-user data?](#access-export-and-deletion). > **How do we bulk-delete every contact in a workspace?** > > A **Company Owner** can delete every contact in a workspace in a single action: > > 1. Open the workspace and go to **Workspace settings**. > 2. Scroll to the **Danger zone** panel at the bottom of the **General** tab. > 3. Click **Delete contacts**. > 4. Confirm by typing the workspace name into the modal. > > The action queues a background job that removes all contact records — including their entries, communications, and profile data — and replaces each contact with an anonymised tombstone so aggregate analytics remain intact. Deletion is permanent and cannot be undone. > > Only Company Owners see this action. Editors and Viewers will not have the button visible. > **Can deleted entries or contacts be restored?** > > No. Entry and contact deletions are permanent in the product and cannot be undone from the portal. There is no single-submission restore. Automated backup copies may be retained for up to 30 days from creation before they are destroyed; those backups are not a self-serve restore path for individual entries. > **How do end-user access or deletion requests work?** > > If an end user contacts Komo directly with a data access, correction, or deletion request (for example under GDPR or CCPA), Komo will promptly notify you unless required by law to act otherwise. **You**, as the organisation that collected the data, action the request through the portal — export, update, or delete the relevant contact or entry records. > > For privacy or DPA questions about this process, contact [privacy@komo.tech](mailto:privacy@komo.tech). ## Sharing and sub-processors > **Does Komo share our data with anyone else?** > > Yes, but only with **sub-processors** engaged to deliver aspects of the platform, and only to the extent necessary to provide the services covered under the Terms of Service. Komo remains responsible for sub-processor handling of your data per our instructions. > > The authoritative sub-processor list is maintained on our [trust site](https://komo.trust.site/subprocessors) and in **Annex 1** of our Terms of Service. A summary table is below and may lag behind live updates. > **Who are Komo's sub-processors?** > > The following third-party sub-processors may process data in connection with the Komo platform. Optional services are only engaged when you enable the relevant feature. > > For the current list, see [komo.trust.site/subprocessors](https://komo.trust.site/subprocessors). Annex 1 of our [Terms of Service](/account-settings/faqs/data-privacy-faq#terms-of-service) is also authoritative. > > | Sub-processor | Purpose | Applicable service | Location | > | - | - | - | - | > | Google, LLC | Hosting & infrastructure — server and data hosting | Core platform | United States | > | Cloudflare, Inc. | Content delivery network — web infrastructure, security, DDoS mitigation, DNS | Core platform | United States (global data centres; traffic routed to nearest) | > | PostHog Inc. | Product analytics and in-app behaviour insights | Core platform | United States | > | DataDog, Inc. | Infrastructure monitoring — uptime, performance, security | Core platform | United States | > | HubSpot | CRM, customer support, and marketing website | Komo internal operations | United States | > | Stripe | Online payments | Billing | United States | > | Sprinto | Security and compliance monitoring | Komo internal operations | United States | > | Xero | Accounting | Komo internal operations | Australia | > | OpenAI | AI language-model inference | Optional AI features | United States (optional) | > | Twilio, Inc. | SMS sending | Optional SMS communications | United States (optional) | > | ActiveCampaign, LLC | Email sending via Postmark (transactional and broadcast) | Optional email communications | United States (optional) | > > This summary may be updated from time to time. Always refer to the [live sub-processor list](https://komo.trust.site/subprocessors) or Annex 1 of the Terms of Service for the current version. ## Cookies and consent > **How does opt-in work on the Komo platform?** > > Komo provides layered consent controls so you can align collection and communications with your privacy policy and legal requirements. Consent is managed at three levels: > > 1. **Hub-level cookie and privacy consent** — enable a cookie consent banner in your Hub's [GDPR settings](/getting-started/hub-setup/hub-settings/index). End users see this when they first load the Engagement Hub and can accept or manage preferences before engaging with content. > > 2. **Form-level consent for data collection** — every data capture form supports a mandatory **terms and conditions** acceptance checkbox, linked to your uploaded T\&Cs. You can add additional required or optional fields for specific consents. > > 3. **Marketing opt-in via Communication Subscriptions** — create workspace-level [Communication Subscriptions](/crm/communications/communication-subscriptions/index) and add them to your forms. End users must **explicitly opt in** before they can receive marketing emails. Marketing communications cannot be sent to contacts who have not subscribed. Transactional email and SMS subscription controls are evolving — see the [Communication Subscriptions FAQ](/crm/communications/communication-subscriptions/index) for current scope. > > You configure the copy, required fields, and consent labels for each layer. Komo records consent status against each contact and entry, and this is visible in [Entry Management](/interactive-features/features/entry-management/index) and contact profiles. > **Can we show a cookie consent banner on an Engagement Hub?** > > Yes. Enable a cookie consent banner in your Hub's **GDPR** settings tab. You can customise the banner copy, colours, and call-to-action buttons. End users see the banner when they first load the Engagement Hub. See [Hub Settings — GDPR](/getting-started/hub-setup/hub-settings/index). > **Does Komo integrate with cookie consent providers?** > > Yes. Komo has a direct integration with **OneTrust Cookie Consent**, allowing you to connect your existing consent programme to your Engagement Hub. Komo is also open to exploring integrations with other providers — contact [privacy@komo.tech](mailto:privacy@komo.tech) to discuss. > **Does Komo use cookies?** > > Yes. Komo uses cookies for the following purposes: > > * Remember users when returning to the Engagement Hub > * Remember users who create an account so they do not have to re-enter information when entering competitions > * Remember where a user got up to in a given game > * Remember when a user has consented to a data and privacy consent form > > You must post a privacy policy on your Hub that provides notice of cookie use, and must not circumvent any opt-out mechanisms that are part of the platform. > **We want to enrich profiles with first-party data — how does consent fit?** > > Komo is designed for **zero- and first-party data collection** — data your end users voluntarily provide through engagement, not third-party data appended without their knowledge. > > A typical approach for building richer profiles while staying consent-aligned: > > * **Start with low-friction engagement** — polls, games, and quizzes that do not require personal data, building anonymous engagement first. > * **Gate deeper data behind explicit consent** — use data capture forms with T\&Cs acceptance when you need identifying information for competitions or rewards. > * **Separate competition consent from marketing consent** — require T\&Cs for entry, but treat marketing as a distinct, optional [Communication Subscription](/crm/communications/communication-subscriptions/index) checkbox that end users must actively tick. > * **Layer data over time** — as identified contacts return to your Hub, badges, profiles, and repeat entries add engagement data to existing contact records without re-asking for information they have already provided. > * **Respect subscription status in integrations** — when syncing to external CRMs or email platforms, use workflow filters so only contacts with active subscription consent are transferred. See [Mailchimp Contact Sync](/crm/syncs/mailchimp-contact-sync/index) for an example. > > You remain responsible for determining the appropriate legal basis and privacy notices for your use case. Komo provides the tools to capture and record consent; your legal and policy teams define how they are applied. > **How have other customers approached opt-in and consent?** > > While every organisation's legal requirements differ, common patterns we see across Komo customers include: > > * **Opt-in first for marketing** — rather than collecting data and relying on opt-out, customers use Communication Subscriptions so marketing emails are only sent to contacts who have explicitly opted in. This is the platform default for marketing communications. > * **Reusable workspace-level subscriptions** — consent fields are created once at the workspace level and added to forms across multiple campaigns, ensuring consistent consent language and auditability. > * **Separate subscriptions for different channels** — distinct opt-ins for email, SMS, and other channels, each with its own label and description visible on the communications preference page. > * **Hub-level cookie consent plus form-level T\&Cs** — a cookie banner on first visit, combined with mandatory T\&Cs acceptance on competition entry forms. > * **OneTrust integration** — customers with existing cookie consent programmes connect [OneTrust Cookie Consent](/integrations-automation/tag-management/index) to their Hub for a consistent consent experience across their web properties. > * **Filtered CRM syncs** — integrations and workflows are configured to sync only contacts who meet specific consent criteria (e.g. active email subscription), so external systems receive only appropriately consented data. > > Your Komo account team can discuss patterns relevant to your industry and jurisdiction. For legal interpretation, we recommend sharing this FAQ, our [trust centre](https://komo.trust.site), and your planned data flows with your policy team alongside our [Terms of Service](/account-settings/faqs/data-privacy-faq#terms-of-service) and [Privacy Policy](/account-settings/faqs/data-privacy-faq#privacy-policy). ## Security > **How does Komo protect our data?** > > Komo implements commercially reasonable technical and organisational security measures, including: > > * Encryption of data in transit and at rest > * Access controls limiting Komo personnel access to authorised support scenarios — see [Can Komo staff access our data?](#roles-and-ownership) > * Regular third-party penetration testing, code review, and grey-box testing > * Security and compliance monitoring via sub-processors such as Sprinto and DataDog > * Internal policies covering physical access, IT asset management, and data handling > > In the event of a security breach affecting Customer Data, Komo will notify you within 48 hours of confirming the nature and extent of the breach, or sooner if required by law. > **Do you regularly conduct penetration tests?** > > Yes. Komo engages third-party security experts to conduct penetration tests against our software. We also conduct code review and grey-box testing. See [How does Komo protect our data?](#security) for our broader security programme. > **Do you have a physical data security policy?** > > Yes. We maintain several policies covering physical access and control of data and IT systems, including an IT Asset Register, IT Asset Decommissioning Policy, Physical Data Policy, and Technology Equipment Agreement. > **Are Komo staff under an NDA?** > > Yes. All Komo staff are required to commit to confidentiality obligations and an NDA. For when staff may access Customer Data, see [Can Komo staff access our data?](#roles-and-ownership). ## Compliance and legal > **Where are Komo's Terms of Service?** > > Komo maintains separate Terms of Service for Australia/New Zealand and US/International customers. Use the version that matches your contract and region: > > * [Australia & New Zealand](https://www.komo.tech/terms-of-service) > * [US & International](https://www.komo.tech/us/terms-of-service) > > The sub-processor list is in **Annex 1** of the Terms of Service. The [live sub-processor list](https://komo.trust.site/subprocessors) on our trust site may also be useful. > **Where is Komo's Privacy Policy?** > > Komo maintains separate Privacy Policies for Australia/New Zealand and US/International customers. Use the version that matches your contract and region: > > * [Australia & New Zealand](https://www.komo.tech/privacy-policy) > * [US & International](https://www.komo.tech/us/privacy-policy) > **Where can we find trust and security documentation?** > > Our trust centre is available at [https://komo.trust.site](https://komo.trust.site). It includes security, compliance, and privacy documentation — including the [sub-processor list](https://komo.trust.site/subprocessors) — that may be useful when sharing information with your legal or policy teams. > **Are you GDPR compliant?** > > Yes. Komo complies with EU GDPR obligations, including Standard Contractual Clauses for international data transfers from the EU. For how end-user access and deletion requests are handled, see [How do end-user access or deletion requests work?](#access-export-and-deletion). > **Are you CCPA compliant?** > > Yes. Komo complies with the California Consumer Privacy Act (CCPA). End-user requests directed to Komo are routed to you as described in [How do end-user access or deletion requests work?](#access-export-and-deletion). > **Will Komo sign a Data Processing Agreement (DPA)?** > > Yes. Komo is happy to sign a DPA — please send agreements to [privacy@komo.tech](mailto:privacy@komo.tech) for review. ## Contact > **Whom do we contact for data and privacy questions?** > > Email [privacy@komo.tech](mailto:privacy@komo.tech) for privacy, DPA, and data processing questions. For platform support, contact [support@komo.tech](mailto:support@komo.tech). # Instant Win Games Source: https://knowledge.komo.tech/account-settings/faqs/instant-win-games/index How winners are determined in Scratch and Win, Spin to Win, and Watch to Win instant win games. Instant win games on Komo — [Scratch and Win](/interactive-features/features/scratch-and-win/index), [Spin to Win](/interactive-features/features/spin-to-win/index), and [Watch to Win](/interactive-features/features/watch-to-win/index) — reveal a result to the user at the moment of play. This FAQ explains how the winner is chosen and how prize allocation behaves. > **How is the winner determined?** > > There is no pre-selected winning entry (e.g. "entry #1000 wins"). Each play is an independent probability roll at the moment the user scratches, spins, or watches. > > For every prize you configure two things: > > * A **percentage probability** — the chance any given play reveals that prize. > * A **maximum prize allocation** — the total number of times that prize can be won. > > When a user plays, the system rolls against the configured probabilities and shows either a prize screen or the failure/fallback screen. > > > [!NOTE] > > > > The combined probability of all prizes cannot exceed 100%. Any remaining percentage rolls into the failure screen. > **Can I set scheduled 'win moments' (e.g. a prize only winnable in a specific time window)?** > > Komo instant win doesn't use fixed win moments. Every play is an independent probability roll with a maximum prize allocation, as described above. > > You can restrict when a prize can be won with eligibility rules. In the prize results table, click **Add** in the prize's **Eligibility Rules** column (**Edit** once rules exist) to open the **Add Eligibility Rules** modal. Give the rules a name, then under **Result can be achieved when:** add an **Entry** filter, choose **Date and time** or **Time of day**, then an operator (**Is before** / **Is after** / **Is between**) plus a time zone, and click **Save**. The rule is checked against the time the entry was made. Fallback results can't have eligibility rules. > > Use **Date and time** for a one-off window between two specific dates and times, for example a prize that can only be won on one day: > > ![Instant win eligibility rules: Add Eligibility Rules modal with an Entry filter set to Date and time, Is between 23/10/2026 00:00 and 23/10/2026 23:59 in Australia/Perth](https://mintcdn.com/komotechnologies/epV8OV7yVeVsnTzX/images/instant-win-games-eligibility-rule-date-and-time.webp?fit=max\&auto=format\&n=epV8OV7yVeVsnTzX\&q=85\&s=054f48f47f82d8f45892a68fd7b1efd9) > > Use **Time of day** for a window that applies every day at the same times, for example a daily happy hour: > > ![Instant win eligibility rules: Add Eligibility Rules modal with an Entry filter set to Time of day, Is between 16:00 and 17:00 in Australia/Perth](https://mintcdn.com/komotechnologies/epV8OV7yVeVsnTzX/images/instant-win-games-eligibility-rule-time-of-day.webp?fit=max\&auto=format\&n=epV8OV7yVeVsnTzX\&q=85\&s=070b540e8e36ba7d8a1cc73aa37486b8) > > Prizes with eligibility rules are listed under **Success results with eligibility rules** and are only available to users who meet those criteria. Make sure probabilities still make sense alongside the general success results. > > Times are set to the minute in the Portal; there is no seconds precision. Each time window is configured by hand per prize — there is no bulk import of time windows. > > If nobody wins a time-restricted prize during its window, it isn't carried over. > > For promotions previously run on win moments, the simplest compliant setup is published odds plus prize allocation limits. Your terms and conditions should describe odds and caps rather than guaranteed win moments. > **What happens once a prize's allocation is used up?** > > The game stays live and users can continue to play. The probability associated with that prize collapses into the **failure/fallback screen**, so no further users will win that specific prize. Any other prizes with remaining allocation continue to roll as normal. > **What if fewer users play than expected — can a prize go unawarded?** > > Yes. Because outcomes are rolled per play rather than assigned to a specific entry number, low traffic can mean the prize allocation is not reached within the campaign window. > > If awarding the prize is important, monitor entry volume against the configured probability and adjust as needed: > > * **Low traffic** — increase the probability so a larger share of plays reveal the prize. > * **High traffic** — lower the probability to pace the giveaway across the full campaign. > > You can update prize probability at any time while the game is live. See prize probability configuration on the [Scratch and Win](/interactive-features/features/scratch-and-win/index), [Spin to Win](/interactive-features/features/spin-to-win/index), and [Watch to Win](/interactive-features/features/watch-to-win/index) card pages. > **Can the same user win more than once?** > > That depends on the entry limits you configure in the [data capture](/getting-started/hub-setup/data-capture/index) settings for the card. See [Add Entry Throttling to a Competition](/interactive-features/features/add-entry-throttling-to-a-competition/index) for the entry-limit options. If you allow multiple entries per user (and enable the play again button), each subsequent play is an independent roll subject to the same probability and allocation rules. # Logging in and account access Source: https://knowledge.komo.tech/account-settings/faqs/logging-in-and-account-access/index Troubleshooting login, invite links, Google SSO account linking, workspace seat limits, and password resets for the Komo portal. Common issues logging into the Komo admin portal — invite links, Google SSO, seat limits, and password resets — and how to resolve them. ## Invite and activation > **My invite link says "Something went wrong" when I try to activate my account** > > Occasionally an invite email points at an activation flow that fails to complete on the first click. The interim fix while the underlying issue is resolved: > > 1. Contact [support@komo.tech](mailto:support@komo.tech) and mention the failing invite. Support can set a temporary password on your account. > 2. Once support confirms, go to the [portal login page](https://app.us1.komo.cloud/portal/auth/login) (or the AU region equivalent), click **Forgot password?**, and complete the reset flow using the email address on your invite. > 3. Sign in with your new password. > > From there you can add Google or Microsoft as a login method from **My profile → Add connections**. > **The Google button says "Account not linked" when I try to sign in** > > This happens when your Komo account was created via **email + password** — typically by accepting an invite with the "Sign in with password" option — and you later try to sign in with Google. The two identities are not automatically linked, so Google login refuses. > > To fix: > > 1. Sign in with **email and password** as usual. (Reset the password first if you do not have it.) > > 2. Once signed in, open **My profile** in the admin portal. > > 3. In the **Add connections** section, click **Connect** next to Google (or Microsoft) and complete the OAuth flow. > > 4. From now on, either sign-in method will work. > > > [!TIP] > > > > When accepting a Komo invite for the first time, click **Sign in with Google** on the invite acceptance screen rather than setting a password. This creates the account with Google already linked, so you do not have to link it afterwards. > **I forgot my password** > > Go to the [portal login page](https://app.us1.komo.cloud/portal/auth/login) and click **Forgot password?** — Komo will email you a reset link. If the email does not arrive within a few minutes, check spam and confirm you are using the email address associated with your Komo account. > > > [!WARNING] > > > > **Never send your Komo password over email, chat, or Slack.** Komo staff will never ask for it. If someone asks you to email or DM a password, treat it as suspicious. ## Workspace access > **I have been removed from the workspace unexpectedly** > > If you can log in but no longer see a workspace you previously had access to, the most likely cause is a **seat limit** on the workspace subscription. When a workspace is at its seat cap and a new admin is invited, an existing admin can be silently removed to make room. > > A Company Owner can check current seat usage under **Company settings → Billing**. If your seat was removed in error, ask a Company Owner to re-invite you. > **Can we enforce Google (or Microsoft) sign-in only, and disable password login?** > > Yes. A Company Owner can restrict which login methods are allowed for the whole company: > > 1. Open **Company settings → Company Members**. > 2. Scroll to the **Allowed Login Types** panel. > 3. Toggle **Email/Password**, **Google**, or **Microsoft** on or off. > > Changes take effect on next sign-in. Any admin who tries a disabled login method will be blocked. > > > [!WARNING] > > > > Before disabling a login method, make sure every admin on your company has linked at least one of the remaining allowed methods under **My profile → Add connections** — otherwise they will be locked out. > **Do you support Okta / Auth0 / SAML SSO for the admin portal?** > > The admin portal supports **Google** and **Microsoft** login via OAuth. Okta, Auth0, and generic SAML SSO for the admin portal are not currently available. > > If you need SSO for **end users** (the hub side, not the admin portal), Komo does support OAuth SSO integration with providers like Auth0 and Google via the [OAuth Single Sign On integration](/integrations-automation/tag-management/index). This is a separate product surface to admin login. > **I changed my password but I still can't sign in** > > Two things to check: > > * Confirm you are on the correct data-region login page. Komo has separate portals for **US1** (`app.us1.komo.cloud`) and **AU1** (`app.au1.komo.cloud`). Your account exists in only one region. > * If your account was originally created via Google SSO, resetting the password may not link a password login until you accept the reset flow all the way through. Try clicking the reset link again and following it end-to-end without opening any other Komo tabs. > > If neither resolves it, contact [support@komo.tech](mailto:support@komo.tech) with the email address on the account. ## Related * [Add new members to your company](/account-settings/account-management/add-new-members-to-your-company/index) — invite flow and role definitions. * [Data privacy FAQ](/account-settings/faqs/data-privacy-faq/index) — how account and contact data are handled. # Cloudflare Turnstile Source: https://knowledge.komo.tech/account-settings/settings/cloudflare-turnstile/index Add a CAPTCHA to your competitions to eliminate bot traffic. ## What is it? Cloudflare Turnstile is a type of CAPTCHA that is able to verify users as real humans to block any spam or bot traffic entering your competition. This feature applies at the end of the data capture form and is an automatic reading that doesn't affect the user experience. ## How do I set it up? ### Step 1: Connect your Hub to Cloudflare ![Cloudflare Turnstile: step 1 — Step 1: Connect your Hub to Cloudflare](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-1-connect-your-step-1.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=8cd64f9c75e7b595471f5d2b534acfcd) * To set up Cloudflare Turnstile, you will need to have a Cloudflare account. You can sign up and create an account [here](https://dash.cloudflare.com/sign-up). Don't worry, it's free! * **(1)** Navigate to the sidebar and click on **Turnstile** * **(2)** Click on **Add site** to connect your Komo Hub > **Adding your Komo Hub** > > ![Cloudflare Turnstile: option a — Step 1: Connect your Hub to Cloudflare](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-1-connect-your-option-a-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=1fdaf7e98f7a796cab408db19472e0ba) > > * **(A)** Here you will input an **internal name** > * **(B)** Enter your **Hub URL** here without the http\://. For example, komohub.komo.site, then click on the pop-up below, *Add custom domain* > > [!NOTE] > > > > *If you want to enable a CAPTCHA to multiple Hubs, you will need to add all the domains here.* > > ![Cloudflare Turnstile: option a — Step 1: Connect your Hub to Cloudflare](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-1-connect-your-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=f7b3fadef6d9107f21af773afd5d81c6) > * **(C)** Here you can select from different modes. Select **Managed** if you want Cloudflare to decide whether or not the checkbox needs to be manually filled for assumed bot activity. > * **(D) Non-interactive** means users don't need to check the box; it will automatically scan a user's session. > > ![Cloudflare Turnstile: option c — Step 1: Connect your Hub to Cloudflare](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-1-connect-your-option-c.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=e88d7283b3cdf26a9aca6f695f53640c) > * **(E) Invisible** means the Cloudflare Turnstile CAPTCHA will not be visible on the form. > > ![Cloudflare Turnstile: option c — Step 1: Connect your Hub to Cloudflare](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-1-connect-your-option-c-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=ff2f8bc2a6987e99eb47f35c0917911b) > * Then scroll down and click **Create**. ### Step 2: Copy the Turnstile keys ![Cloudflare Turnstile: step 2 — Step 2: Copy the Turnstile keys](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-2-copy-the-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=d670a22d4a0a7070d44f704ba282e00a) * **(1) + (2)** These are the **keys** you will need to have on hand to paste on the Komo portal. ### Step 3: Enable the Cloudflare Turnstile feature ![Cloudflare Turnstile: step 3 — Step 3: Enable the Cloudflare Turnstile feature](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-3-enable-the-step-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=c830c5fe7dbe9d5fe292de4fcab4a297) * Navigate to the Komo portal, click on your initials on the top right corner and then select Account settings. * **(1)** Click on **Create property** Connnected Apps on the left sidebar. * **(2)** Then select **Connect** under Cloudflare Turnstile to enable. > **Connect Cloudflare Turnstile** > > ![Cloudflare Turnstile: step 2 — Step 3: Enable the Cloudflare Turnstile feature](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-3-enable-the-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=7a980c7c64ff838836fe566f5b994663) > > * **(A)** Paste the **Site key** from Step 2 here. > * **(B)** Paste the **Secret Key** from Step 2 here. > * **(C)** Select which **Hubs** you want to apply the CAPTCHA to. > > [!NOTE] > > > > Any Hubs selected here must be on the Cloudflare Turnstile list in Step 1 (2C). > * Then click **Create** to save your settings. ### Step 4: Test the feature ![Cloudflare Turnstile: step 4 — Step 4: Test the feature](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-turnstile-step-4-test-the-step-4.gif?s=ccead9f8030561c0d4feb6c1ed19ad8e) * Navigate to your live site and engage with a piece of content with a data capture form to view the experience. ### FAQ **Can bots enter a competition if the Cloudflare Turnstile CAPTCHA is enabled?** No, they can't. The role of the CAPTCHA is to eliminate any type of bot traffic or illegitimate entries trying to enter or spam your competitions. **Will the CAPTCHA apply to all the competitions?** Yes, if you have enabled the feature, this will apply to all competitions on the Hub. # Notifications Source: https://knowledge.komo.tech/account-settings/settings/notifications/index Set up workspace notifications to stay informed about important events like workflow errors > [!NOTE] > > Notifications is currently in **beta**. You can start using it today — features and event types may expand over time. Notifications let you monitor important events in your workspace and receive alerts through configured delivery channels. Use them to stay informed about issues like workflow execution errors without manually checking the platform. ## Overview The Notifications settings page has two tabs: * **Notifications** — define what events you want to be notified about and how frequently * **Channels** — configure where notifications are delivered (for example, email) Navigate to **Workspace Settings > Notifications** in the sidebar to get started. ## Channels Channels define where your notifications are delivered. You need at least one active channel before you can create notification subscriptions. ### Creating a channel **1. Open the Channels tab** Go to **Workspace Settings > Notifications** and select the **Channels** tab. **2. Add a channel** Click **Add Channel** to open the channel creation form. **3. Configure the channel** Enter a **Channel Name** to identify this channel (for example, "Team Alerts"). Select a **Channel Type**: * **Email** — send notifications to one or more email addresses **4. Add recipients** For email channels, enter each recipient's email address and click **Add**. You can add multiple recipients to a single channel. **5. Save** Click **Create** to save the channel. ### Managing channels You can edit existing channels to update the name or modify recipients. If a recipient address has delivery errors, a warning icon appears next to it with details about the failure. ## Notification subscriptions Subscriptions define which events trigger a notification and which channels receive it. ### Creating a subscription **1. Open the Notifications tab** Go to **Workspace Settings > Notifications** and select the **Notifications** tab. **2. Add a notification** Click **Add Notification** to open the subscription creation form. **3. Name the subscription** Enter a **Subscription Name** (for example, "Workflow failure alerts"). **4. Select an event type** Choose which event triggers the notification. Currently available: * **Flow Execution Error** — triggers when a workflow execution fails **5. Configure event settings** For workflow error notifications, choose the scope: * **All workflows in workspace** — receive alerts for errors in any workflow * **Specific workflows** — select individual workflows to monitor **6. Select channels** Choose one or more notification channels to deliver this alert. Only enabled channels with a valid status appear in the list. **7. Set a cooldown** Configure a **notification cooldown** to limit how frequently you receive alerts. The minimum cooldown is 5 minutes. This prevents notification spam when multiple errors occur in quick succession. **8. Save** Click **Create** to activate the subscription. ### Managing subscriptions You can edit existing subscriptions to change the event scope, update channel assignments, or adjust the cooldown period. ## FAQ > **What events can I subscribe to?** > > Currently, you can subscribe to **Flow Execution Error** events, which notify you when a workflow fails. More event types may be added as the feature evolves. > **Can I send notifications to multiple channels at once?** > > Yes. When creating a subscription, you can select multiple channels. Each selected channel receives the notification independently. > **What does the cooldown setting do?** > > The cooldown limits how often a notification fires for the same subscription. For example, with a 5-minute cooldown, if multiple workflow errors occur within that window, you receive one notification instead of many. > **Why don't I see any channels when creating a subscription?** > > You need to create at least one channel in the **Channels** tab first. Only channels that are enabled and have a valid status appear as options. # August 2025 Source: https://knowledge.komo.tech/changelog/2025-august Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **August 29, 2025** ### **Localized built-in text** You can now translate standard text in Memory Challenge and Live Trivia cards into Spanish and Portuguese. This helps you localize experiences for broader audiences. ### **Quick survey resends** A new action in the survey recipients table lets you quickly resend communications. This helps you boost response rates with less effort. ### **Advocacy score insights** We added an "Advocacy Score" option to Opinion Scale questions, complete with analytics. This makes it easier to measure brand loyalty and sentiment. ### **Direct survey links** You can now open and preview surveys directly from the survey table via a new "Link" column. This saves you clicks when managing surveys. ### **Fixed: Prize filter rules** You can now correctly select "is set" and "is not set" options in prize filter rules. ### **Fixed: Text colors** Text color settings now apply correctly to lobby, scratch, and result screens. ### **Fixed: Game layouts** Layouts for scratch and watch & win are now consistent between the admin editor and the front-end view. ### **Fixed: HTML card ratios** Aspect ratio settings now apply correctly in both the front-end and editor preview for HTML cards. ### **Fixed: Hub validation** Hubs now check the site cache first when validating existence, improving accuracy and performance. ### **Fixed: Survey triggers** Survey workflow trigger filters now work as expected to ensure your automation runs correctly. ### **Fixed: Table pagination** Table pagination controls in the portal are now properly aligned. ### **Fixed: Empty state images** We corrected broken images that were appearing on empty state screens in the portal. ### **Fixed: Thuzi environment settings** The Thuzi workflow environment selection no longer reverts from production to staging after saving. ### **Consistent swiper colors** Swiper result screens now inherit modal colors to ensure a consistent design across your card. ### **Better image management** We fixed drag overlay behavior and enabled moving multiple files at once in the workspace. ### **Enhanced workspace organization** A new folder structure and select image button make managing your workspace images much easier. ### **Updated Mailchimp flow** The connection flow now uses the "id" callback page for a smoother integration process. ### **Custom badge notifications** You can now customize badge toast notifications to better personalize the user achievement experience. ### UGC accent colors Card shell customization now includes an accent color option, which applies to the UGC upload outline and icon. Restrict email updates A new setting allows you to prevent users from updating their email addresses in forms. Toggle swiper scores You can now toggle the result score display ("You got X out of X") on or off in Swiper cards. Styled instant win forms Extra data forms within instant win cards can now be styled to match your campaign's look and feel. Automated workflow cloning Workflows now automatically clone when you copy cards, surveys, or hubs within the same workspace. AI brand guidelines You are now prompted to complete brand guidelines before generating content, ensuring AI outputs match your style. **August 5, 2025** Major Feature Release ### **Workspace brand guidelines** You can now define brand guidelines at the workspace level. Kai uses this information to generate content that better reflects your brand's identity. ### **Rich text profile descriptions** The profile description field now supports HTML editing. This allows for rich formatting like bold text, font sizing, and hyperlinks. ### **Default site timezones** You can now define a default timezone for your site. This supports more accurate timing across all your features. ### **API domain security** You can now set which domains are permitted to access the new public API for Photo Frame and Meme Generator content. ### **Timezone aware countdowns** Countdown timers can now be set to specific timezones, ensuring accurate timing for users in different regions. ### **Precise competition closures** Competition end times can now be set using specific timezones, giving you precise control over campaign deadlines. ### **Loyalty toast notifications** Loyalty campaigns can now trigger on-screen toast notifications. This gives users real-time feedback when they complete loyalty actions. ### **Loyalty tier gating** You can now restrict access to specific data capture forms based on a user's loyalty tier. ### **Points as prizes** You can now award loyalty points directly as a prize outcome within the card builder. ### **Public UGC API** You can now retrieve approved user-generated Photo Frame and Meme Generator items using a public API. ### **Cleaner card UI** You can now choose to hide the gameplay status indicator from cards for a cleaner, less cluttered interface. ### **Enhance text with AI** You can now use the Enhance Text feature to improve content in HTML and email fields, directly inside the editor. ### **Shuffle swiper options** Swiper now supports randomly shuffling the order of options to keep each play-through fresh. ### **Visual tag chips** Tag-related workflow steps now show visible chips. This provides better clarity and makes editing easier. ### **Predictor slider suffixes** You can now add unit suffixes to predictor slider questions to provide clearer context for user input. ### **New opinion scale field** A new Opinion Scale field is now available, letting users give feedback using a customizable, pre-defined scale. ### **Coupon error feedback** Users now get clear error messaging if they enter an invalid shared barcode. ### **Clearer code uploads** We improved the language in the upload modal to better explain the expected column headers. ### **Invalid variable alerts** Invalid variables are now highlighted with clear visual indicators in the email editor. ### **Fixed: Precise search** Search now treats full queries as a single term. This improves result accuracy and better matches your expectations. ### **Fixed: Quiz capture warnings** A warning now appears if no quiz results are linked to data capture steps to prevent lost data. ### **Fixed: Avatar selection** The selected avatar now uses the drawer text color, making it easier to see which option is active. ### **Fixed: Analytics formatting** We resolved issues where some funnel analytics numbers were not formatting correctly. ### **Fixed: Cloned data sources** You can now edit or delete data sources from cloned screens with data feeds as expected. ### **Fixed: Workflow previews** Workflow steps with long, unbroken text (like URLs) now wrap correctly in the preview pane. ### **Fixed: Radio button colors** Radio button colors now render correctly across all theme combinations. ### **Fixed: Text area resizing** Text input fields with multiple lines now expand automatically as users type. ### **Kai access button** The Kai button is now more prominently placed in the main portal header for easier access. ### **Kai now for everyone** Kai, your AI assistant for card building and creative generation, is now live for all customers across the platform. ### **Fixed: Entry condition text** Hub entry condition descriptions now update immediately as expected. ### **Fixed: Email validation** Forms now correctly validate email addresses that use numeric domains. ### **Fixed: Narrowcast scrollbars** We removed unnecessary scrollbars that were appearing on some narrowcast device displays. ### **Fixed: Profile icons** We fixed an issue where duplicate profile icons would appear in the portal editor. ### **Fixed: Coupon workflow scope** Workflow steps for distributing coupons now correctly follow their assigned hub context. ### **Fixed: Form text alignment** Text alignment settings are now properly applied to HTML fields in Forms. ### **Subscription event variables** Workflow and event variables now include a contact's subscription settings, allowing for more targeted communications. ### **Richer prize data** Workflow events for PrizeAwarded now include more detailed prize data for use in downstream logic or integrations. ### **Fixed: Transparent QR codes** QR codes with transparent backgrounds now render correctly across all browsers and devices. ### **Fixed: Meme test images** Custom images now display correctly during testing, replacing the placeholder images. ### **Fixed: Portal page load** We fixed a bug that caused card pages to fail when opening in the portal. ### **Fixed: Spin to Win styling** Spin to Win cards now apply your configured styling settings correctly. ### **Fixed: Spin to Win cloning** Cloned Spin to Win cards now retain their settings when copied to another hub. ### **Fixed: Embedded layouts** We removed excess spacing on embedded card covers to ensure a tighter, cleaner layout. ### **Fixed: Contact merging** Merging contacts by email now correctly retains all associated data, including orphaned fields. ### **Fixed: Hovercard scrolling** Hovercards with long lists of loyalty sources now scroll properly within the view. # December 2025 Source: https://knowledge.komo.tech/changelog/2025-december Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **December 16, 2025** ### **Track checkpoint progress** You can now view completed checkpoint information directly in the entries table. This makes it easier to track participant progress through your treasure hunts. ### **Coupon workflow triggers** We added new workflow triggers for when coupons are issued or redeemed. This helps you automate follow-up actions based on coupon activity. ### **Sprout integration available** You can now connect Sprout Social to your workspace. This new integration helps streamline your social media workflows directly from the platform. ### **Shareable workflow filters** Filter states in Flow Executions are now saved to the URL. This allows you to bookmark specific views or share filtered logs with your team. ### **Fixed: Indexing settings display** The Google indexing setting now displays correctly in the portal, ensuring you know exactly when your pages are visible to search engines. ### **Fixed: Import validation hangs** We resolved an issue where contact import validation would get stuck loading. Your imports now process smoothly without hanging. ### **Fixed: Bulk tagging status** Background job monitoring for bulk entry tagging now reports status correctly, so you know exactly when your updates are complete. # November 2025 Source: https://knowledge.komo.tech/changelog/2025-november Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **November 11, 2025** ### **Better small screen layouts** We adjusted the layout so the "Show less" button displays correctly on small screens, ensuring a cleaner and more consistent experience. **November 4, 2025** ### **Richer workflow context** Workflow steps now have access to event IDs and additional context data. This allows you to build smarter workflows that utilize detailed event information. ### **Fixed: Embedded content sharing** We resolved issues affecting sharing functionality for Photo Frame and Meme Generator components. Your embedded content now shares smoothly as intended. **October 30, 2025** ### **Clearer navigation buttons** Carousel and vote navigation buttons are now more prominent. We applied consistent styling to improve clarity and user interaction. **October 21, 2025** ### **Query parameters for embeds** Embed SDK and React Native widgets now support passing query parameters like UTM tags. You can also configure parameter forwarding directly in the Admin Portal embed settings. ### **Scheduled card visibility** You can now hide cards on a page using scheduling configurations. This gives you control to show or hide content automatically at selected times. ### **Custom leaderboard ranks** Trivia leaderboards can now display specific ranks, such as 13th or 66th, instead of just the top players. This offers more flexibility for your competitive trivia experiences. ### **Smarter asset library** The Asset Library now remembers your last folder location, sorting, and view preferences. This helps you pick up exactly where you left off for a smoother workflow. ### **Random frame display** You can now randomize the display order of frames for each user. This provides a fresh and dynamic experience every time the photo frame is accessed. ### **Cleaner trivia admin** We reorganized the settings and styling sections in trivia admin screens for better clarity. We also removed drop shadows from various images to clean up the visual interface. ### **Fixed: Competition entry limits** Entry limit validation now performs more reliably on competitions with high activity. ### **Fixed: Leaderboard data cloning** Trivia leaderboard data sources now wire up correctly when cloned in the block editor. ### **Fixed: Entitlement updates** Entitlements now update immediately after you create a new subscription. ### **Fixed: Workflow cloning** Workflows within cards now update their entities properly when the card is cloned. ### **Fixed: Hub color palette** Updating the hub color palette from outside Hub Settings no longer overwrites the existing palette. **October 8, 2025** ### **Fixed: Currency input validation** Currency inputs with trailing zeros now validate and display correctly without inconsistencies. ### **Precise eligibility filtering** You can now filter participants based on contact properties, subscription status, list membership, or loyalty balance. This allows for much more precise targeting. ### **Time-based receipt rules** We added time-of-day operators to receipt validation rules. This enables you to apply specific conditions based on exactly when a transaction occurred. ### **Entry time filtering** Eligibility rules can now include entry date and time filters. This gives you more flexibility for time-specific campaign configurations. ### **Attachment size warnings** You will now see a warning if your distribution attachments exceed the allowed size limit. This helps prevent failed sends before they happen. ### **Custom analytics tracking** Admins can now define exactly which contact properties are tracked for frontend analytics. This improves data flexibility and gives you more control over your insights. **October 1, 2025** ### **Fixed: Swiper text visibility** We adjusted the text color in swiper result answers to ensure better readability across all themes. **September 26, 2025** Latest Updates ### **Refreshed illustrations** We have replaced various system images with new illustrations for a updated, refreshed look. ### **Clearer Photo Frame editor instructions** We improved the instructions within the Photo Frame editor to make setup easier and clearer. ### **Improved email address readability** Long email addresses in contact lists and views are now truncated. This makes the interface cleaner and easier to read. ### **Customizable progress bars in Treasure Hunt** You can now override progress bar limits and customize the completion text shown when a user reaches 100%. ### **Transparent text editor** The rich text editor background is now transparent. This makes it much easier to edit and view white text against your design. ### **Clearer SMS setup** We clarified the input fields for alphanumeric Twilio SMS senders to reduce confusion during setup. ### **Bulk content moderation** You can now approve or reject UGC uploads, photo frames, and meme generator submissions in bulk. This speeds up your moderation workflow significantly. ### **Import validation rules** You can now copy and import receipt validation rules. This saves time when setting up similar validation logic across campaigns. ### **Simplified poll results** Poll result screens now display in a simplified format when there is only one question involved. ### **Custom banner colors** Confirmation and Closed message banners now support custom colors to better match your branding. ### **Fixed: Disqualified entries** Disqualifying a trivia entry now properly removes it from the leaderboard. ### **Improved grid layouts** The Asset Library and UGC uploads now use a simple grid layout instead of masonry. This makes scanning and selecting files easier. ### **Fixed: Timeline scrolling** We improved the scrolling experience when you are editing the loyalty timeline. ### **Fixed: Coupon exports** Viewing and exporting coupon recipients now includes records linked to deleted contacts. **September 11, 2025** ### **Fixed: Salesforce step labels** We resolved inconsistencies in step labels and improved modal loading states for a smoother Salesforce workflow experience. ### **Salesforce HTTP data** HTTP request details are now included for transaction journal and Get Object steps. This makes troubleshooting integrations clearer and easier. **September 9, 2025** ### Loyalty Timeline for Contact Activity Contact activity history is now displayed on a timeline, giving clearer visibility into engagement over time. ### Fixed: Video Upload Progress Indicator A loading indicator is now displayed during video uploads, providing clear feedback on upload progress. ### Auto-Reject Duplicate Receipts A new setting automatically rejects duplicate receipts based on merchant name, date/time, and amount, ensuring cleaner data collection. ### Fixed: Trivia question reordering issues Resolved problems where reordering questions after a game started sometimes caused questions to be skipped or shown out of order. ### Fixed: Trivia screens not appearing during gameplay Resolved an issue where newly added screens would not appear during live gameplay. **September 3, 2025** ### **Fixed: Email editor crash** Resolved a crash that occurred when adding a button to an email outside of a hub context. ### **Fixed: Turnstile connection** Resolved a crash that occurred when attempting to connect the Turnstile app. ### **Fixed: Audit log filter** Resolved a crash that occurred when attempting to open the audit log filter. ### **Fixed: Contact event logs** Resolved a crash that occurred when viewing details for "contact added to list" events in the audit log. ### **Fixed: Portal stability** We resolved multiple issues that were causing crashes in the admin portal to improve overall stability. **September 1, 2025** ### **Fixed: Image resolution** Picker result, option, and detail images now display in higher resolution for a clearer visual experience. ### **Fixed: Insight dashboards** We addressed a crash that occurred when creating insight dashboards to improve reliability. ### **Fixed: Salesforce transactions** We corrected an issue requiring a currency code and improved point formatting in the Salesforce Transaction Journal workflow step. ### **Fixed: Tag loading** Tags now load properly to ensure smoother navigation and usage. **August 29, 2025** ### **Localized built-in text** You can now translate standard text in Memory Challenge and Live Trivia cards into Spanish and Portuguese. This helps you localize experiences for broader audiences. ### **Quick survey resends** A new action in the survey recipients table lets you quickly resend communications. This helps you boost response rates with less effort. ### **Advocacy score insights** We added an "Advocacy Score" option to Opinion Scale questions, complete with analytics. This makes it easier to measure brand loyalty and sentiment. ### **Direct survey links** You can now open and preview surveys directly from the survey table via a new "Link" column. This saves you clicks when managing surveys. ### **Fixed: Prize filter rules** You can now correctly select "is set" and "is not set" options in prize filter rules. ### **Fixed: Text colors** Text color settings now apply correctly to lobby, scratch, and result screens. ### **Fixed: Game layouts** Layouts for scratch and watch & win are now consistent between the admin editor and the front-end view. ### **Fixed: HTML card ratios** Aspect ratio settings now apply correctly in both the front-end and editor preview for HTML cards. ### **Fixed: Hub validation** Hubs now check the site cache first when validating existence, improving accuracy and performance. ### **Fixed: Survey triggers** Survey workflow trigger filters now work as expected to ensure your automation runs correctly. ### **Fixed: Table pagination** Table pagination controls in the portal are now properly aligned. ### **Fixed: Empty state images** We corrected broken images that were appearing on empty state screens in the portal. ### **Fixed: Thuzi environment settings** The Thuzi workflow environment selection no longer reverts from production to staging after saving. ### **Consistent swiper colors** Swiper result screens now inherit modal colors to ensure a consistent design across your card. ### **Better image management** We fixed drag overlay behavior and enabled moving multiple files at once in the workspace. ### **Enhanced workspace organization** A new folder structure and select image button make managing your workspace images much easier. ### **Updated Mailchimp flow** The connection flow now uses the "id" callback page for a smoother integration process. ### **Custom badge notifications** You can now customize badge toast notifications to better personalize the user achievement experience. ### UGC accent colors Card shell customization now includes an accent color option, which applies to the UGC upload outline and icon. Restrict email updates A new setting allows you to prevent users from updating their email addresses in forms. Toggle swiper scores You can now toggle the result score display ("You got X out of X") on or off in Swiper cards. Styled instant win forms Extra data forms within instant win cards can now be styled to match your campaign's look and feel. Automated workflow cloning Workflows now automatically clone when you copy cards, surveys, or hubs within the same workspace. AI brand guidelines You are now prompted to complete brand guidelines before generating content, ensuring AI outputs match your style. **August 5, 2025** Major Feature Release ### **Workspace brand guidelines** You can now define brand guidelines at the workspace level. Kai uses this information to generate content that better reflects your brand's identity. ### **Rich text profile descriptions** The profile description field now supports HTML editing. This allows for rich formatting like bold text, font sizing, and hyperlinks. ### **Default site timezones** You can now define a default timezone for your site. This supports more accurate timing across all your features. ### **API domain security** You can now set which domains are permitted to access the new public API for Photo Frame and Meme Generator content. ### **Timezone aware countdowns** Countdown timers can now be set to specific timezones, ensuring accurate timing for users in different regions. ### **Precise competition closures** Competition end times can now be set using specific timezones, giving you precise control over campaign deadlines. ### **Loyalty toast notifications** Loyalty campaigns can now trigger on-screen toast notifications. This gives users real-time feedback when they complete loyalty actions. ### **Loyalty tier gating** You can now restrict access to specific data capture forms based on a user's loyalty tier. ### **Points as prizes** You can now award loyalty points directly as a prize outcome within the card builder. ### **Public UGC API** You can now retrieve approved user-generated Photo Frame and Meme Generator items using a public API. ### **Cleaner card UI** You can now choose to hide the gameplay status indicator from cards for a cleaner, less cluttered interface. ### **Enhance text with AI** You can now use the Enhance Text feature to improve content in HTML and email fields, directly inside the editor. ### **Shuffle swiper options** Swiper now supports randomly shuffling the order of options to keep each play-through fresh. ### **Visual tag chips** Tag-related workflow steps now show visible chips. This provides better clarity and makes editing easier. ### **Predictor slider suffixes** You can now add unit suffixes to predictor slider questions to provide clearer context for user input. ### **New opinion scale field** A new Opinion Scale field is now available, letting users give feedback using a customizable, pre-defined scale. ### **Coupon error feedback** Users now get clear error messaging if they enter an invalid shared barcode. ### **Clearer code uploads** We improved the language in the upload modal to better explain the expected column headers. ### **Invalid variable alerts** Invalid variables are now highlighted with clear visual indicators in the email editor. ### **Fixed: Precise search** Search now treats full queries as a single term. This improves result accuracy and better matches your expectations. ### **Fixed: Quiz capture warnings** A warning now appears if no quiz results are linked to data capture steps to prevent lost data. ### **Fixed: Avatar selection** The selected avatar now uses the drawer text color, making it easier to see which option is active. ### **Fixed: Analytics formatting** We resolved issues where some funnel analytics numbers were not formatting correctly. ### **Fixed: Cloned data sources** You can now edit or delete data sources from cloned screens with data feeds as expected. ### **Fixed: Workflow previews** Workflow steps with long, unbroken text (like URLs) now wrap correctly in the preview pane. ### **Fixed: Radio button colors** Radio button colors now render correctly across all theme combinations. ### **Fixed: Text area resizing** Text input fields with multiple lines now expand automatically as users type. ### **Kai access button** The Kai button is now more prominently placed in the main portal header for easier access. ### **Kai now for everyone** Kai, your AI assistant for card building and creative generation, is now live for all customers across the platform. ### **Fixed: Entry condition text** Hub entry condition descriptions now update immediately as expected. ### **Fixed: Email validation** Forms now correctly validate email addresses that use numeric domains. ### **Fixed: Narrowcast scrollbars** We removed unnecessary scrollbars that were appearing on some narrowcast device displays. ### **Fixed: Profile icons** We fixed an issue where duplicate profile icons would appear in the portal editor. ### **Fixed: Coupon workflow scope** Workflow steps for distributing coupons now correctly follow their assigned hub context. ### **Fixed: Form text alignment** Text alignment settings are now properly applied to HTML fields in Forms. ### **Subscription event variables** Workflow and event variables now include a contact's subscription settings, allowing for more targeted communications. ### **Richer prize data** Workflow events for PrizeAwarded now include more detailed prize data for use in downstream logic or integrations. ### **Fixed: Transparent QR codes** QR codes with transparent backgrounds now render correctly across all browsers and devices. ### **Fixed: Meme test images** Custom images now display correctly during testing, replacing the placeholder images. ### **Fixed: Portal page load** We fixed a bug that caused card pages to fail when opening in the portal. ### **Fixed: Spin to Win styling** Spin to Win cards now apply your configured styling settings correctly. ### **Fixed: Spin to Win cloning** Cloned Spin to Win cards now retain their settings when copied to another hub. ### **Fixed: Embedded layouts** We removed excess spacing on embedded card covers to ensure a tighter, cleaner layout. ### **Fixed: Contact merging** Merging contacts by email now correctly retains all associated data, including orphaned fields. ### **Fixed: Hovercard scrolling** Hovercards with long lists of loyalty sources now scroll properly within the view. # October 2025 Source: https://knowledge.komo.tech/changelog/2025-october Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **October 30, 2025** ### **Clearer navigation buttons** Carousel and vote navigation buttons are now more prominent. We applied consistent styling to improve clarity and user interaction. **October 21, 2025** ### **Query parameters for embeds** Embed SDK and React Native widgets now support passing query parameters like UTM tags. You can also configure parameter forwarding directly in the Admin Portal embed settings. ### **Scheduled card visibility** You can now hide cards on a page using scheduling configurations. This gives you control to show or hide content automatically at selected times. ### **Custom leaderboard ranks** Trivia leaderboards can now display specific ranks, such as 13th or 66th, instead of just the top players. This offers more flexibility for your competitive trivia experiences. ### **Smarter asset library** The Asset Library now remembers your last folder location, sorting, and view preferences. This helps you pick up exactly where you left off for a smoother workflow. ### **Random frame display** You can now randomize the display order of frames for each user. This provides a fresh and dynamic experience every time the photo frame is accessed. ### **Cleaner trivia admin** We reorganized the settings and styling sections in trivia admin screens for better clarity. We also removed drop shadows from various images to clean up the visual interface. ### **Fixed: Competition entry limits** Entry limit validation now performs more reliably on competitions with high activity. ### **Fixed: Leaderboard data cloning** Trivia leaderboard data sources now wire up correctly when cloned in the block editor. ### **Fixed: Entitlement updates** Entitlements now update immediately after you create a new subscription. ### **Fixed: Workflow cloning** Workflows within cards now update their entities properly when the card is cloned. ### **Fixed: Hub color palette** Updating the hub color palette from outside Hub Settings no longer overwrites the existing palette. **October 8, 2025** ### **Fixed: Currency input validation** Currency inputs with trailing zeros now validate and display correctly without inconsistencies. ### **Precise eligibility filtering** You can now filter participants based on contact properties, subscription status, list membership, or loyalty balance. This allows for much more precise targeting. ### **Time-based receipt rules** We added time-of-day operators to receipt validation rules. This enables you to apply specific conditions based on exactly when a transaction occurred. ### **Entry time filtering** Eligibility rules can now include entry date and time filters. This gives you more flexibility for time-specific campaign configurations. ### **Attachment size warnings** You will now see a warning if your distribution attachments exceed the allowed size limit. This helps prevent failed sends before they happen. ### **Custom analytics tracking** Admins can now define exactly which contact properties are tracked for frontend analytics. This improves data flexibility and gives you more control over your insights. **October 1, 2025** ### **Fixed: Swiper text visibility** We adjusted the text color in swiper result answers to ensure better readability across all themes. # September 2025 Source: https://knowledge.komo.tech/changelog/2025-september Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **September 26, 2025** ### **Refreshed illustrations** We have replaced various system images with new illustrations for a updated, refreshed look. ### **Clearer Photo Frame editor instructions** We improved the instructions within the Photo Frame editor to make setup easier and clearer. ### **Improved email address readability** Long email addresses in contact lists and views are now truncated. This makes the interface cleaner and easier to read. ### **Customizable progress bars in Treasure Hunt** You can now override progress bar limits and customize the completion text shown when a user reaches 100%. ### **Transparent text editor** The rich text editor background is now transparent. This makes it much easier to edit and view white text against your design. ### **Clearer SMS setup** We clarified the input fields for alphanumeric Twilio SMS senders to reduce confusion during setup. ### **Bulk content moderation** You can now approve or reject UGC uploads, photo frames, and meme generator submissions in bulk. This speeds up your moderation workflow significantly. ### **Import validation rules** You can now copy and import receipt validation rules. This saves time when setting up similar validation logic across campaigns. ### **Simplified poll results** Poll result screens now display in a simplified format when there is only one question involved. ### **Custom banner colors** Confirmation and Closed message banners now support custom colors to better match your branding. ### **Fixed: Disqualified entries** Disqualifying a trivia entry now properly removes it from the leaderboard. ### **Improved grid layouts** The Asset Library and UGC uploads now use a simple grid layout instead of masonry. This makes scanning and selecting files easier. ### **Fixed: Timeline scrolling** We improved the scrolling experience when you are editing the loyalty timeline. ### **Fixed: Coupon exports** Viewing and exporting coupon recipients now includes records linked to deleted contacts. **September 11, 2025** ### **Fixed: Salesforce step labels** We resolved inconsistencies in step labels and improved modal loading states for a smoother Salesforce workflow experience. ### **Salesforce HTTP data** HTTP request details are now included for transaction journal and Get Object steps. This makes troubleshooting integrations clearer and easier. **September 9, 2025** ### Loyalty Timeline for Contact Activity Contact activity history is now displayed on a timeline, giving clearer visibility into engagement over time. ### Fixed: Video Upload Progress Indicator A loading indicator is now displayed during video uploads, providing clear feedback on upload progress. ### Auto-Reject Duplicate Receipts A new setting automatically rejects duplicate receipts based on merchant name, date/time, and amount, ensuring cleaner data collection. ### Fixed: Trivia question reordering issues Resolved problems where reordering questions after a game started sometimes caused questions to be skipped or shown out of order. ### Fixed: Trivia screens not appearing during gameplay Resolved an issue where newly added screens would not appear during live gameplay. **September 3, 2025** ### **Fixed: Email editor crash** Resolved a crash that occurred when adding a button to an email outside of a hub context. ### **Fixed: Turnstile connection** Resolved a crash that occurred when attempting to connect the Turnstile app. ### **Fixed: Audit log filter** Resolved a crash that occurred when attempting to open the audit log filter. ### **Fixed: Contact event logs** Resolved a crash that occurred when viewing details for "contact added to list" events in the audit log. ### **Fixed: Portal stability** We resolved multiple issues that were causing crashes in the admin portal to improve overall stability. **September 1, 2025** ### **Fixed: Image resolution** Picker result, option, and detail images now display in higher resolution for a clearer visual experience. ### **Fixed: Insight dashboards** We addressed a crash that occurred when creating insight dashboards to improve reliability. ### **Fixed: Salesforce transactions** We corrected an issue requiring a currency code and improved point formatting in the Salesforce Transaction Journal workflow step. ### **Fixed: Tag loading** Tags now load properly to ensure smoother navigation and usage. # April 2026 Source: https://knowledge.komo.tech/changelog/2026-april Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **April 20, 2026** ### Survey Activity Now Tracked in Audit Logs Survey actions are now recorded in your company audit log. You can see when surveys are created, updated, deleted, published, unpublished, or cloned — along with who made the change and a link to the survey. For update events, a diff of what changed is also included. ### **LocalCard integration available** You can now connect your LocalCard account to your workspace. Use this new integration to award gift cards directly to your audience. ### **Issued coupons can now be voided** Made a mistake issuing a coupon to the wrong user? You can now void issued coupons directly in the portal returning it back into the sock to be issued again. **April 9, 2026** ### Adjust Game Show Text Positioning You can now control the vertical position of question text on the Big Screen. This ensures your game show content is perfectly aligned and easy for your audience to read. **April 8, 2026** ### Archive Cards Automatically on Unpublish We added an option to automatically archive cards when their scheduled unpublish time arrives. This keeps your workspace clean by skipping the draft stage for expired content. ### Track Workflow Versions More Easily Workflow runs now display the specific version they executed against, complete with a handy version filter. This makes it easier to troubleshoot and track exactly which workflow logic was applied during each attempt. ### **Fixed: Leaderboard pagination controls** We resolved an issue where pagination controls were not appearing on leaderboard views. You can now navigate through leaderboard results as expected. # August 2026 Source: https://knowledge.komo.tech/changelog/2026-august Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **Aug 25, 2026** ### Loyalty Balances in the Contacts Table You can now surface each contact's loyalty balance as an optional column in the contacts table. This lets your team spot high-value members without opening the contact detail view. ### Attach Images to Email Distributions Email distribution attachments now accept PNG, JPEG, GIF, and WebP files alongside PDFs. You can send campaign visuals directly with your outbound emails. ### Beta: Komo Links Komo Links is now available in beta for enrolled workspaces. Use the new Links section in your workspace nav to build tracked, branded short links backed by Komo infrastructure. ### Access Policies Now in Beta Access Policies are now available to all admins as a public beta. You can gate card and site access using rich policy expressions from the standard workspace UI. ### Cleaner Picker Analytics Picker analytics now only counts option picks that came in via competition entries when data capture is enabled. Your reporting stays consistent with what participants actually submitted. **Aug 21, 2026** ### Links: Trails, UTM Templates, and QR Templates Komo Links picked up a big round of upgrades. You can now group short links into trails, reuse UTM parameter templates, and standardize QR code styles across your team so every campaign link stays on brand. ### Audience Sync We introduced Audience Sync so you can push contact segments to your ad platforms as reusable audiences. Configure a sync once and keep the audience fresh either on a schedule or as part of a workflow. ### Audience Sync Workflow Step Workflows now include a dedicated Audience Sync step, and you can chain multiple syncs from a single Enqueue step. Enrol contacts into an ad audience the moment they hit a trigger — say, completing a competition or joining a loyalty tier. ### Inline Forms on Vote Cards Vote cards now fully support inline forms for participant data capture. You can collect entrant details natively without breaking the voting flow. ### Form Card for All Admins Every admin can now build standalone Form Cards from the standard card library. ### Interactive Q\&A Auto-Approve Interactive Q\&A moderators can now switch on auto-approval so new questions publish without manual review. This is ideal for trusted audiences and live events where speed matters. ### Confirm Before Removing Receipt Validation Rules We added a confirmation modal when deleting receipt validation rules. This prevents accidental removal of the rules powering your receipt-based promotions. ### Multi-Instance Auth for HTTP Workflow Steps The HTTP workflow step can now authenticate through connected apps that have multiple instances. You can pick the exact instance your outbound call should use, matching how the rest of your workflow already works with those apps. ### Hierarchical Schema and Variable Pickers in Workflows Workflow schema and variable pickers now use a searchable, hierarchical tree instead of a flat list. Finding the right templating value in complex flows is much faster. ### Clearer Timezone Labels in the Admin Date and time labels that use your admin timezone now say "your timezone" in tooltips, and the workspace reporting timezone is named directly on Insights, CRM, and dashboard share expiry. You always know which zone a given time is being shown in. ### Streamlined Dashboard Share Modal The dashboard share modal now saves only when you press Save, and expiry date and password are optional fields without extra toggles. Sharing dashboards feels less fiddly and there are no more surprise auto-saves. ### Polished Links Trails and Templates UX We tightened up the trails and templates experience across Komo Links, including requiring a destination on create and inheriting your trail's default QR style on new short links. Creating consistent, on-brand links is simpler out of the box. ### Better Receipt Uploader on Mobile The receipt uploader now shows instructions tailored to whether the participant is on mobile or desktop. Entrants get clearer guidance on how to snap or upload their receipt. ### Expanded Audit Log Coverage The company audit log now tracks loyalty program, campaign, and tier changes; receipt validator updates; and Result Created events from Spin, Swiper, card creation, and card or site cloning. You get a much richer trail of who changed what and when. ### SDK Identify Now Works With Access Policies Workspace App SDK identify calls now set the site session verification needed for Access Policies. Contacts logging in through the SDK pass access policy checks as expected, and Dropdown and Multi-Choice claims map cleanly onto catalog options. ### Friendlier Card Mapping Sidebar Errors The card mapping sidebar now shows a helpful message when a mapped property has been deleted or fails to load, instead of crashing the editor. You can keep working and clean up stale mappings safely. ### Fixed: Login Page Vertical Centering The login page once again uses the full portal height so the login card is properly centered on wider screens. ### Fixed: Quiz Results Showing Disabled Competition Button Quiz results screens no longer show an "Enter competition" button when the competition is switched off. Participants only see the actions that are actually available. ### Changelog and Feature Requests Have Moved The in-portal Feature OS widget has been retired. Changelog now links directly to the knowledge base and Feature Requests opens a message to Komo support. **Aug 6, 2026** ### Align In-Page and Cover Embeds In-page and cover embeds now support an optional alignment setting (start, center, or end), with an admin override in the embed code modal. You can drop cards into your host page exactly where the layout calls for them. ### Fixed: iOS Dropdown Text on White Form Backgrounds Form dropdown options on iOS no longer inherit a white text color that made them invisible against a white form body. Every option is readable regardless of the form's theme. # Feburary 2026 Source: https://knowledge.komo.tech/changelog/2026-february Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **February 16, 2026** ### Show All Answer Options Instantly You can now enable a setting to display all question answer options without requiring users to click a "Show More" button. This reduces friction and makes your quizzes quicker to navigate. ### Fixed: Empty Avatar Save Errors We fixed a bug that caused errors when attempting to save an empty avatar. Your profile setup process is now smoother and free of unexpected glitches. ### Smarter Avatar Selection Display The avatar selection menu will now only appear if there are actually avatars available to choose from. This cleans up the interface and avoids confusing users with empty options. **February 2, 2026** ### **Competition entry tag workflow triggers** You can now trigger workflows when tags are added to or removed from competition entries. This enables automated actions like sending emails when prize status tags are updated (for example, when an entry is tagged as "Awaiting Address" or "Posted"). Configure tag filters to target specific tags or trigger on any tag change. # July 2026 Source: https://knowledge.komo.tech/changelog/2026-july Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **Jul 29, 2026** ### Disable Form Auto-Pop on Cards You now have the manual form entry option to completely disable the auto-pop feature on your Cards. This ensures forms only appear exactly when the user initiates them. ### Configure Form Auto-Pop Delays We added a new control to adjust the specific delay before a form automatically appears. This gives you exact control over the pacing and user experience of your pop-up forms. ### View Number Guesses in Entries Table Player guesses from Number Guess competitions are now visible directly on the competition entries table. You can quickly review and verify all participant submissions at a single glance. ### Map Number Guesses to Contact Properties You can now map participant guesses to contact properties as either Text or a Number. This helps you build richer, more detailed participant profiles directly from their gameplay input. ### Customize Picker Results Titles Independently You can now override or completely hide the Results title in the Picker independently from the main gameplay settings. This provides much cleaner control over the final screen your users see. ### Live Preview for Picker Items Drawer The Picker items drawer now features a live preview directly within the gameplay edit mode. You can instantly see how your structural changes look without having to load the full test environment. ### Custom Colors for Picker Filter and Sort Filter and Sort options within the Picker can now use optional, custom accent colors. If left unset, they will automatically inherit your default Modal theme for a consistent look. ### Add Inline Forms to Quizzes Quizzes now fully support inline forms to capture participant data natively. You can collect user information smoothly without forcing them into a separate pop-up. ### Clearer Source Fields in Property Mapping The contact property mapping UI now explicitly displays exactly which source field value is being written to your mapped property. This makes tracking your data integrations across fields instantly clear. ### Beta: In-Page Card Embeds We are testing a new in-page embed mode for supported card types. Instead of relying on covers and full-page modals, your cards can now render directly within your host page's native layout. ### Generate Campaign Links with UTM Builder We introduced a UTM Builder tool to help you easily create tracking URLs for your campaigns. You can securely generate and standardize links with all necessary UTM parameters right from your dashboard. ### Reorganized Sidebar Navigation We reorganized the workspace sidebar for a much more logical daily workflow. Your navigation will now flow clearly from Apps, to Tools, and down to Workspace Settings. ### Hide Quiz Results for Inline Experiences You can now configure quizzes to display no results screen at the end of the flow. This is a perfect setting for inline experiences where you want a seamless transition back to your core page content. ### Mobile-Friendly Bottom Sheets for Pickers Filter and sort menus in the Picker now utilize bottom sheets instead of popovers. This provides a much smoother, mobile-friendly interface for participants browsing your items. ### Smarter Image Loading for Data Feeds Images in data feeds are now fully layout-aware. They will automatically request smaller file sizes based on the container, saving bandwidth and improving display speed. ### Universal Image Preloading and Sizing We made layout-aware CDN sizing and next-image preloading a standard feature across all accounts. The site allowlist flags have been removed, meaning everyone gets this performance boost by default. ### Faster Image Loading with Cloudflare WebP We stopped auto-converting images to WebP internally and offloaded this completely to our Cloudflare CDN. This results in far more efficient processing and noticeably faster image load times for your users. ### Fixed: Legacy Media Paths in Asset Exports Gameplay asset exports will now automatically resolve blob paths when stored media URLs are still using legacy CDN hosts. Your exported media remains fully accessible without needing manual path corrections. # June 2026 Source: https://knowledge.komo.tech/changelog/2026-june Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **Jun 22, 2026** ### Fixed: Hidden Trivia Question Images We fixed an issue in trivia game show mode to ensure that question images can now be completely hidden when toggled off. This guarantees full control over what your audience sees during competitive gameplay. **Jun 19, 2026** ### Control Big Screen Trivia Text Game show admins can now choose to display question text on the Big Screen even if that same text is set to be hidden on participants' individual mobile devices. This gives you perfect structural flexibility for hosting live trivia events. ### Trigger Automations on Duplicate Receipts "Receipt rejected" workflows will now automatically fire whenever a user uploads a duplicate receipt file. This allows you to immediately trigger automated alerts to notify users exactly why their receipt wasn't accepted. **Jun 18, 2026** ### Test New AI Receipt Data We've added the new Store Name and Store Number fields directly into the "Test Receipt" preview tool when the Content Understanding AI Reader is turned on. This lets you quickly test and verify exactly what data our AI is pulling before launching live rules. ### Fixed: Broken Layout Cloning We fixed a critical layout cloning issue in data feeds where duplicating a template caused its nested child elements to vanish from sight while remaining bugged in the background. Your cloned data feed arrangements will now copy over flawlessly. **Jun 17, 2026** ### New AI Receipt Fields Available Merchant store names and store numbers are now fully integrated across receipt rules, reviews, entries, and CSV exports when using our upgraded Content Understanding AI reader. This gives you deeper data tracking and granular control over how you process and export your receipt submissions. ### Fixed: Contact List Filter Errors We fixed a bug where filtering contact lists by the "Added to list at" attribute caused the screen to crash. You can now filter your audience milestones without any technical interruptions. ### Fixed: Contact Button Popover Sticking We resolved an issue where the "Add/Create Contact" button popover menu would stay stuck open on the screen. The layout will now cleanly close as soon as you complete your action. **Jun 15, 2026** ### Use Dynamic Values For Bonus Entries You can now use dynamic values, such as contact fields, to configure workflow bonus entries. This allows you to create more personalized and flexible reward structures tailored to individual users. ### Fixed: Repetitive Image Search Results We fixed an issue where the image search would repeatedly return the exact same results. You will now see a fresh, diverse set of images every time you run a search. ### Fixed: Code Editor Cursor Jumping We resolved a frustrating bug where the cursor would jump around in the workflow code editor during fast typing. You can now write and edit your workflow logic smoothly without interruptions. ### Fixed: Workflow Save Recovery Errors We fixed an issue where recovering a saved workflow could accidentally alter data in related workflows. Your automated processes and their associated data will now remain completely secure and accurately isolated. **Jun 8, 2026** ### Refresh Receipt Tables Instantly You can now manually refresh the receipt table right from the header. This ensures you are always looking at the most up-to-date receipt data without having to reload the entire page. ### Customize Hub Entry Text Hub entry condition screens now support upgraded rich text formatting, including customizable link styles. This allows you to easily align entry screens with your brand's unique look and feel. ### View Receipt Rejection Reasons Workflows now include the specific reason a receipt was rejected right in the trigger event data. This makes it easier to build automated follow-up messages explaining exactly why submissions failed. ### Access Contact IDs in Workflows You can now access the specific Contact ID when a workflow is triggered by a contact event. This makes tracking and updating user records across your automated processes much more reliable. ### New GIF Search Integration We've introduced KLIPY GIF search to the portal image editor, replacing the retiring Tenor service. You can continue adding engaging, fun GIFs to your content without any interruption. ### Fixed: Portal Download Buttons We resolved an issue where download buttons on the portal were unresponsive. You can now download files smoothly and reliably. ### Configure Scoped Workflows Easier We've improved the trigger options available for scoped workflow configurations. This gives you more precise control over exactly when and how your targeted workflows execute. ### Better Barcode Coupon Layouts We added extra visual padding around barcode-style coupons. This improves the visual layout and ensures physical scanners can quickly read the codes without interference. ### Fixed: Double Coupon Reporting We fixed a bug that caused coupon usages to be counted twice when attached to different workflow versions. Your coupon redemption analytics will now be perfectly accurate. ### Clearer CSV Upload Requirements We've updated the guidance for Question CSV uploads to clearly outline the required columns. This takes the guesswork out of formatting your data, helping you import questions successfully on the first try. ### Fixed: Mass Email Delivery We resolved a bug where mass email campaigns would occasionally fail to reach all intended recipients. Your bulk communications will now reliably deliver to everyone on your list. # March 2026 Source: https://knowledge.komo.tech/changelog/2026-march Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **March 24, 2026** ### Clone Entire Workflows With Ease You can now duplicate complete workflows through a streamlined interface. This saves you time when building similar processes, allowing you to quickly rename and deploy your new flow. ### Issue Multiple Coupons At Once The "Issue Coupon" step now allows you to distribute multiple coupons simultaneously. This streamlines your promotional campaigns and gets rewards to your users faster. ### Duplicate Individual Workflow Steps You can now clone specific steps right within your existing workflow. This eliminates repetitive setup, speeding up your workflow creation process. ### Catch Errors Before You Publish We've introduced pre-publish checks that surface warnings and errors when you try to publish a draft. This ensures your content is flawless and functioning correctly before it reaches your audience. ### Enjoy Better Receipt Processing Accuracy We've upgraded our AI receipt processing with a new, advanced custom analyzer. This significantly improves accuracy, ensuring your customers' receipt data is captured correctly every time. ### Control Your Data Refresh Rates You can now set a custom polling time to control how often user content is fetched from single-screen data feeds. This gives you greater flexibility over when and how your displays update. ### Add Custom Scripts To Surveys Survey pages now support custom hub scripts. This enables better third-party integrations and more detailed tracking of your survey engagement. ### New Official Feature Graduations Dashboards, Insights, Loyalty, Leaderboards, Communication Subscriptions, and Create Workspace have officially moved out of Beta. You can now rely on these fully stabilized features for your daily operations. ### Fixed: Quiz Question Properties Resetting We fixed an issue where toggling the question text would accidentally reset your other question settings. Your quiz configurations will now stay exactly how you set them. ### Fixed: iOS Special Character Errors We resolved an issue by improving how secret codes handle special characters from iOS devices. This ensures smoother code entries for your Apple users without unexpected errors. ### Fixed: Missing Treasure Hunt Text We fixed a bug where AI-generated Treasure Hunt cards were missing text on the submit checkpoint button. Participants will now clearly see how to submit their progress. **March 5, 2026** ### Improved Loyalty Leaderboard Accuracy Loyalty leaderboards now automatically exclude deleted contacts and voided points. This ensures your rankings accurately reflect your active, valid participants. **March 4, 2026** ### Fairer Tie-Breakers For Leaderboards Loyalty leaderboards now resolve tie-breakers based on who achieved the score first. This makes your competitions fairer by rewarding the fastest participants. # May 2026 Source: https://knowledge.komo.tech/changelog/2026-may **May 8, 2026** ### **Faster Image Loading** You can now benefit from smaller image sizes and faster page loads without sacrificing quality. Improved image compression applies to newly uploaded images after this release. ### **Faster AI Receipt Validation** You can now process AI receipt validations faster with increased queue throughput, helping results arrive sooner. **May 7, 2026** ### **Full Export Downloads** You can now download a complete export package with your CSV, uploaded files and images, plus an `index.html` preview with thumbnails. This makes it easier to review and share exported content in one place. Available across Competitions, Surveys, Receipt Uploads, UGC Uploads, Photo Frame, Meme Generator, and Picker creations. ### **Treasure Hunt Progress Filters** You can now filter Treasure Hunt entries by completed or incomplete checkpoints. This makes it easier to quickly find and review participant progress. ### **Treasure Hunt Export Details** You can now see completed checkpoints included in Treasure Hunt CSV exports. This makes it easier to track progress and analyse participant activity. ### **Clearer Coupon Reminder Timing** You can now see clearer “sends at” helper text for coupon reminders when available. This helps make send schedules easier to understand. ### **Workflow Replay Updates** You can now replay workflow executions using the current published version. This makes it easier to test and rerun experiences with the latest setup. ### **Expanded Workflow Data** You can now access gameplay score and correct answer count in workflow data. This enables smarter automations and richer participant journeys. ### **Fixed: Improved Tall Images** Tall images are no longer clamped too aggressively, reducing pixelation and improving image quality. ### **Sharper High-Resolution Images** You can now see sharper images on high-resolution screens with early Retina display support. This helps visuals look crisper on supported devices. ### **Fixed: Memory Challenge Timing** Memory Challenge result timing now matches the duration used for score calculation, ensuring more consistent results. ### **Fixed: Contact Email Validation** Contact verification now validates email inputs correctly, helping prevent submission issues. ### **Fixed: Profile Header Colours** Custom back button colours in profile headers now apply correctly for a more consistent branded experience. ### **Fixed: Double Spins Prevention** Spin to Win now prevents accidental double-spins, helping avoid unintended gameplay. ### **Fixed: Samsung Receipt Uploads** Receipt uploads now work more reliably on some Samsung devices, improving upload success. **May 4, 2026** ### Add a Custom Code step to your workflows You can now run inline JavaScript inside your workflows with the new **Custom Code** step. Use it to transform variables, derive new values, or apply conditional logic that goes beyond the built-in steps. Code runs in a sandboxed environment and exposes outputs you define for downstream steps. ### Add entries across competitions with one step The new **Add Competition Entry** workflow step lets you enter a contact into another competition card from inside a workflow. This is ideal for grand-prize draws, cross-promotions, and aggregating entries across multiple cards. ### Rainfocus integration available You can now connect a Rainfocus account to your workspace as a Connected App. Once connected, attendees signing in through Rainfocus can be authenticated against your hub via single sign-on. ### Workflow drafts and version history Workflows now support drafts alongside their published version. You can edit a draft without affecting live workflow runs, publish when ready, and discard a draft to roll back to the active published version. Workflow runs continue to record the exact version that executed for easier troubleshooting. # October 2026 Source: https://knowledge.komo.tech/changelog/2026-october Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **Oct 22, 2026** ### Fixed: Security Updates We applied security updates across the platform. **Oct 21, 2026** ### Copy Public Links to Image Assets You can now copy a public link to any image asset in the Asset Manager straight from the grid, the table, or the asset viewer, ready to paste wherever you need it. ### Reopen Completed Treasure Hunt Checkpoints Treasure Hunts can now let participants reopen checkpoints they've already completed. You can also show your own content on a completed checkpoint instead of the code or QR entry. ### Audience Preview Before Sending Marketing Emails Before you send a marketing email to a list, you now see a live preview of how many people will receive it and why anyone will be skipped. Sent emails also show how many went out and how many were skipped. ### Admins Only See Actions They Can Use Admins now only see the edit, publish, and clone buttons they're actually allowed to use across flows, loyalty, Connect, the CMS, reporting, and Kai. ### Rainfocus Connections Need a Tenant Slug and API Profile ID Rainfocus connections now require a tenant slug and an API profile ID. If you already have a Rainfocus connection, reconnect it from the Rainfocus admin page. ### Contact "Last Updated" Includes Property Changes A contact's **last updated** date now also changes when their property values change. ### Fixed: Scheduled Emails Getting Stuck Scheduled emails no longer occasionally get stuck instead of sending. **Oct 14, 2026** ### Join Paths and Saved Step Positions in Workflows Workflow steps can now have more than one input path, so separate branches can join back into a single later step instead of repeating the same steps on every branch. Step positions on the workflow canvas are now saved, so your layout stays the way you arranged it. See the [workflows guide](/integrations-automation/workflows) for how to join paths. ### "Is Not" Filters for Card and Prize Triggers Card and Prize workflow triggers now support **is not** and **is not in** filters, including on Card type. You can exclude specific cards, prizes, or card types instead of listing every one you want to include. ### Grouped Admin Action Menus Action menus across the admin are now grouped into clear sections, so copy actions, main actions, and destructive actions such as delete are easier to find. ### Faster Contact Imports and Email Lookups Contact imports now run faster, and looking up a contact by exact email address is quicker. ### Fixed: Expired Connected App Connections When a connected app's connection has expired or is no longer valid, you now see a clear message and a **Manage connection** option instead of an error, so you can reconnect straight away. ### Fixed: Forms on Dark Branding Opinion scales, radio buttons, and button borders stay readable on forms with dark branding. Form and survey submit buttons now have a border color too. ### Fixed: Fewer Background Calls from Embedded Experiences Embedded experiences now make far fewer background refresh calls. ### Fixed: Image Processing Security Update We applied a security fix to the image-processing library the platform uses. **Oct 8, 2026** ### Fixed: Interactive Q\&A Question Count Color The **question count color** setting on Interactive Q\&A cards now applies correctly, so the question count in the gameplay header shows the color you choose. The gameplay header preview in the card editor has also been tidied up so it matches what participants see. # September 2026 Source: https://knowledge.komo.tech/changelog/2026-september Stay informed about the latest updates, features, and improvements to Komo Engagement Engine. **Sep 30, 2026** ### Fixed: Embed SDK Prefill for Verified Users Verified Embed SDK users now get form pre-fill information reliably after login. When an authenticated embed session matches an existing site user, contact attributes load correctly so data-capture forms are no longer left blank. **Sep 29, 2026** ### Initial Rows for Multi-Line Form Fields Multi-line text contact properties now include an **Initial rows** setting that controls how tall the field appears when a form loads. If you leave it blank, the field starts at 3 rows and still grows as participants type. Individual forms can override that height when you need a different starting size. ### Search on the Pages Selector The pages selector now includes a search input, so you can filter and find the page you need without scrolling through the full list. **Sep 23, 2026** ### Memory Challenge Show Score Toggle Memory Challenge cards now include a **Show score** toggle. You can choose whether participants see their score after they finish, matching how other game cards already handle scoring visibility. ### Liquid Templating for Loyalty Point Descriptions Award and Redeem Loyalty Points workflow steps now support Liquid templating in their description fields at execution time. You can personalize point-balance messages with contact and workflow context instead of using a static string. ### Swiper Poll Questions and Richer Results Swiper now supports poll-style survey questions, so you can collect preference-style responses alongside classic left/right swipes. The All Results list shows result triggers, and the all-questions list includes item counts so it is easier to see how each question is set up. ### Hide Dropdown Form Fields Dropdown form fields can now be hidden. You can keep a dropdown in the form for mapping or workflow use without showing it to participants. ### Limit Top Poll Responses in Data Feeds Data feeds that surface poll responses now include a setting to limit how many top responses are shown. You can keep leaderboards and feed blocks focused on the most popular answers. ### Scoring Tab Available to All Admins The card editor **Scoring** tab is now available to every admin. You can configure scoring from the standard card editor. ### Fixed: Workspace Apps Multi-Choice JWT Claims Workspace App JWT claim mapping now correctly handles multi-choice properties, so mapped options land on the right contact property values. ### Fixed: Swiper Editor, Analytics, and Exports We cleaned up several Swiper issues: view-answers styles render correctly; Questions and Results analytics mount as expected; competition entry CSV exports use the right `Q{n}` LEFT/RIGHT columns and option-group order; the question editor items menu supports edit, clone, and delete; and result triggers warn when unreachable or error when their ranges overlap. ### Fixed: Case-Insensitive Form Dropdown Updates Post-entry updates on dropdown and option form fields are now case-insensitive, so value changes still apply when casing differs from the original submission. **Sep 17, 2026** ### Higher Limits for Workflow Custom Code Workflow Custom Code steps can now run up to 2,000 JavaScript statements per execution (up from 100). That unblocks loops over larger webhook payloads without hitting the statement cap. Memory (5MB) and time (5s) limits still apply as the primary safety controls. **Sep 15, 2026** ### Data Feed Question Response Alignment Question response blocks in data feeds now respect text alignment settings. Poll and quiz answer layouts stay consistent with the rest of your feed design. ### Fixed: Contact Search With Apostrophes and Quotes Workflow Contact Search no longer fails when the search value includes an apostrophe or quote. Contacts with names like O'Brien resolve correctly in SQL-backed searches. **Sep 14, 2026** ### Video and Carousel Corner Radius Video and Carousel cards now support corner radius controls, and native video playback respects the configured aspect ratio so media sits cleanly in your hub layout. ### Treasure Hunt Checkpoint Schedules and Import Treasure Hunt checkpoints can be scheduled, and you can import checkpoints from CSV or zip packages to stand up larger hunts faster. ### Access Policies Image Insert Access Policy editors can insert images directly, so gated experiences can include richer visual content in policy messaging. ### Loyalty and Challenges Contact Filters The contacts table for Loyalty and Challenges now supports richer filters, making it easier to find the members and entrants you care about. ### Workspace Apps JWT Liquid and Contact Exports Workspace App JWT claims can use Liquid templating, and contact exports now include the contact id so downstream systems can match records reliably. ### Workflow Competition Entry Variables Workflows expose a dedicated competition entry variable group, so you can reference entry fields without digging through unrelated schema paths. ### Embed SDK Auth Cache and Site Cloning The Embed SDK caches auth more reliably across embeds, and cloning sites across companies no longer fails on edge cases that previously blocked the copy. # Coupon Reminders Source: https://knowledge.komo.tech/competitions-promotions/digital-coupons/coupon-reminders/index Send targeted communications to remind users to redeem their digital coupons before expiry ## What is it? This feature allows you to send communications to all users who have not yet redeemed their digital coupons. Create a sense of urgency by informing users they have limited time to redeem their prize and increase redemption rates. ## How do I set it up? * [Step 1: Create an unsubscribe group](#step-1-create-an-unsubscribe-group) * [Step 2: Select the coupon](#step-2-select-the-coupon) * [Step 3: Create a reminder](#step-3-create-a-reminder) * [Step 4: Set up your communication](#step-4-set-up-your-communication) ### Step 1: Create an unsubscribe group ![Coupon Reminders: Step 1: Create an unsubscribe group](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/coupon-reminders-step-1-create-an-step-3.gif?s=1ee79dc78ab841c3a053a03feeab3f35) As we will be sending marketing emails for coupon reminders, we need to ensure we give users the ability to opt out of receiving communications. Learn more about how to create a [communication subscription here](/crm/communications/communication-subscriptions). ### Step 2: Select the coupon ![Coupon Reminders: Step 2: Select the coupon](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/coupon-reminders-step-2-select-the-step-2.gif?s=32f4e0f1aaf086d69efd8477c6d334d0) * Go to your **Engagement Hub** and select the **Coupons** tab at the top * Select the coupon you want to set up a reminder for * Click on the **Reminders** tab in the left sidebar ### Step 3: Create a reminder ![Coupon Reminders: Step 3: Create a reminder](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/coupon-reminders-step-3-create-a-step-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=24ae9239612e89345f549cc02b4b8574) * Click on **Add communication** ![Coupon Reminders: Step 3: option a: Create a reminder](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/coupon-reminders-step-3-create-a-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=a6f7d76ad50878a39ffd9f2480cc0130) * **(A)** Add an **internal name** for the reminder * **(B)** Here you can set whether your recipients will receive the particular communication via email or SMS > [!NOTE] > > Make sure to pick the communication channel that matches the information captured by any competitions that uses the coupon. E.g. if your competition form collects email addresses, then select Email. If you use the SMS channel and the competition doesn't capture mobile phone, then reminders will not be sent. * **(C)** Sets the conditions that need to be met for an entrant to receive this communication. The options are: * **Based on coupon issue or expiry dates** - All participants will receive this communication depending on when they received the coupon or the expiry dates set * **Manually Sent** - Requires you to send the communication manually * **(D)** Then click here to **create** your communication ### Step 4: Set up your communication ![Coupon Reminders: Step 4: option d: Set up your communication](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/coupon-reminders-step-4-set-up-option-d.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=145aebe6258204f9707658a180efb324) * **(1)** Here you will select the **unsubscribe group** you created in Step 1 * **(2)** This is the **sender name**. By default, this is your Company name in the portal. To add a new sender name or make any updates, click on **Add or edit senders** * **(3)** Here you have the option to create an email from a **template** * **(4)** Set when to **automatically send** this communication. Select if you want this communication to be sent before or after the coupon was issued (and unused) or based on the coupon expiry * **(5)** Add a **subject line** * **(6)** Here is where you'll create your **email body**. Use the toolbar for greater options when creating your communication > [!NOTE] > > As this is sent to a bulk list of users, we cannot personalize the email communication. * **(7)** Copy and paste the **coupon link code** and **unsubscribe group code** into the email for users to redeem and opt-out > [!NOTE] > > ![Coupon Reminders: step 4: 7a: Set up your communication](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/coupon-reminders-step-4-set-up-screenshot.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=fa4234e2f61b01be5ff61e97deda1797) > > We recommend using the button feature to add in your coupon link and hyperlinking the copy Unsubscribe with the unsubscribe group code. > > ![Coupon Reminders: step 4: 7b: Set up your communication](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/coupon-reminders-step-4-set-up-screenshot-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=a32923442f99c6814906fbcc406f425a) > > With SMS communication, you also have the same editing options as when creating an email communication. ## FAQ **Will this send to everyone who has not redeemed their coupon?** Yes, this reminder communication will be sent only to those who are yet to redeem their coupon. **Can I set this up to send a week or a few days before the coupon expires?** You can set up the exact time and days you wish to send this communication before the coupon expiry dates. You can see these options in Step 4 above. **Can I personalize the communication?** Not currently. # Digital Coupons Source: https://knowledge.komo.tech/competitions-promotions/digital-coupons/digital-coupons/index Set up your first Digital Coupon! ## What is it? Komo's Digital Coupons offer our customers a way to reward their Engagement Hub users! Digital Coupons are completely customizable and offer: * **Detailed tracking -** Use a swipe, a unique code, a barcode, or a QR code to be scanned to redeem * coupons can even connect directly to your POS system! * **Seamless redemption -** Track clicks and redemptions along every stage of the coupon funnel so you can better understand how consumers are interacting with your offers. * **Email and SMS automation -** Send coupons directly to your consumers via email or SMS. Simply set up a trigger event, and when that event occurs, the consumer can receive their coupon. * **Anti-screenshot technology -** Limit coupon fraud with the use of our anti-screenshot technology. The pulsing dots ensure that the coupon you're redeeming is legitimate and not a screenshot. * **Promotional screens -** Use promotional screens before your coupon is viewed to promote and upsell customers during the coupon redemption process. Read more about Digital Coupons [**here**](https://www.komo.tech/features-digital-coupons). ## How do I build one? ### Step 1: Create a Digital Coupon ![Digital Coupons: step 1 — Step 1: Create a Digital Coupon](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-1-create-a-step-1.gif?s=9b0b865fc4aa6e8fb62cff619058af0d) * Navigate to your **Engagement Hub,** then head to the **Coupons** tab. * Click **+ Create offer,** give your Coupon an **internal name** that will make it easy to track against others you may create, then click **Create**. ### Step 2: Configure your Offer ![Digital Coupons: step 2 — Step 2: Configure your Offer](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-2-configure-your-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=3bba4ec5f992f2df72d1c196ff25ca39) **(1)** Configure your **redemption option**. Choose one of the following from the drop-down menu: * **Swipe** - This redemption option invites users to simply swipe to redeem their Coupon * **Barcode Unique** - This redemption option invites users to use a barcode unique to them to redeem their Coupon ![Digital Coupons: option a — Step 2: Configure your Offer](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-2-configure-your-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=b2a43a4d7ea74685fc673fed7a3dbd58) **(A)** Clicking **Manage codes** allows you to add your barcodes through a range of different options. ![Digital Coupons: option a — Step 2: Configure your Offer](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-2-configure-your-option-a-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=8a6754aff969b691b25019be8e8d39b0) * **(a) Add single** allows you to manually type in a single barcode and an optional PIN * **(b) Add multiple** allows you to manually type in multiple barcodes * **(c) Generate From Pattern** allows you to define parameters which will automatically add all possible barcodes based on your defined pattern * **(d) Upload CSV** allows you to add barcodes from an existing list of barcodes stored in CSV format **(B)** Select the **type of barcode** to communicate with your POS system. * **Barcode Shared** - This redemption option invites users to use a barcode that is shared among the recipients. This option works well for inserting a discount code at checkout! ![Digital Coupons: option b — Step 2: Configure your Offer](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-2-configure-your-option-b.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=cf893ed10674e630af838a4263afc7e9) * **(A)** Select the **type of barcode** you wish to use * **(B)** Allow your consumers to **revisit** the coupon * **(C)** Enter the **code** for users to use to redeem their coupon. This can be letters, numbers, and/or symbols! **(2)** Here, you can update the **internal name** of the offer. This is for internal use only; we recommend setting a descriptive name that will make your reporting easier. **(3)** Give your Coupon a **page title**. This is the name that appears at the top of a user's browser when they view the coupon. **(4)** Set your **offer limits**. This is a limit on the total number of coupons issued and redeemable across the campaign. Within these settings, you can also add **offer limits** and add contacts who should be notified by email once the **issue limit has been reached** so you can remove the competition or promotional collateral. > [!TIP] > > Run a "first-in, best-dressed" campaign, and increase your coupon redemption limit. To do so, set the redemption limit only, with no issue limit. **(5)** Configure the **Availability**. This is the time and duration of your coupon issuing and redemption. > [!WARNING] > > We highly recommend chatting with our customer success team before using this feature, as this can prevent your coupons from being sent. ### Step 3: Input your Locations ![Digital Coupons: step 3 — Step 3: Input your Locations](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-3-input-your-step-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=0fca3a5b6f185971568e70cbdf35bb5f) * **(1)** Here, you can choose to enable a **redemption locations list** and **(2)** to **show geolocation** markers as a part of the redemption process * **(3)** Use the **manage locations** button to add locations manually or upload a CSV file of multiple locations ![Digital Coupons: option a — Step 3: Input your Locations](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-3-input-your-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=8e3d4f95b3db90d72ac58358ed4372b1) * **(A)** Click here to begin adding your redemption **locations** ![Digital Coupons: option a — Step 3: Input your Locations](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-3-input-your-option-a-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=5f998933d2ada0013a8051f6b6168bf2) * **(a)** Select the **country** of your location * **(b)** Start typing the **address of your location**. As you type the address, **(c) + (d)** will **automatically populate** once you select an address * **(e)** You can have the option to include additional **information** for this location. For example trading hours, specific directions of the location in-center (next to Kmart), or what is available for redemption if it is a restaurant! * **(B)** Click here to upload a **CSV file** and add multiple locations. **(4) + (5)** Here, you can also set a **default limit per location**. This is very useful if you have stock limits at certain locations. ### Step 4: Set up your Screens ![Digital Coupons: step 4 — Step 4: Set up your Screens](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/digital-coupons-step-4-set-up-step-4.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=cf03e80efb50c852ae857bf5ec5e02fc) * **(1)** Set up your **Select Locations** screen * **(2)** Upload an **image** that will appear at the top of your Digital Coupon > [!NOTE] > > This is a great place to bring your brand assets into your rewards. Use your color palette and other visual assets to bring the Coupon to life! * **(3)** Here you can edit the **text** that appears when end users are looking for the closest location to redeem their coupon * **(4)** Edit the **color of the messaging bar and text** * **(5)** Update the **background color and text** of the coupon > [!NOTE] > > Any updates made to the styling colors will apply to all screens. * **(6)** Set up your **Ready to Redeem** screen ![Digital Coupons: option a — Step 4: Set up your Screens](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/digital-coupons-step-4-set-up-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=d7a9f57bf9a85ebfd486de43c84bbbc7) * **(A)** Alter the **copy** of the messaging * **(B)** Add any **additional copy** you wish to share with your consumers > [!NOTE] > > Any updates made to the styling colors will apply to all screens. * **(7)** Set up your **Not Ready to Redeem** screen. ![Digital Coupons: option a — Step 4: Set up your Screens](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-4-set-up-option-a-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=7a92fcb5cf213550e0b6a687b6eb9fda) * **(A)** Alter the **copy** of the messaging * **(B)** Add any **additional copy** you wish to share with your consumers > [!NOTE] > > Any updates made to the styling colors will apply to all screens. * **(8)** Set up your **Swipe to Redeem** screen. ![Digital Coupons: option a — Step 4: Set up your Screens](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-4-set-up-option-a-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=6bfa06d7e059e8a984d87faf7642b209) * **(A)** Update the **title** here * **(B)** Edit the **swipe to redeem** copy here > [!NOTE] > > Any updates made to the styling colors will apply to all screens. * **(9)** Set up your **Coupon Code** screen. ![Digital Coupons: option a — Step 4: Set up your Screens](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-4-set-up-option-a-4.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=1bf1f4dac407374ddd95e0093680c55f) * **(A)** Update the **title** here * **(B)** Edit the **sub title** copy here * **(C)** You have the option to add call-to-action buttons on this screen. Click on the **+ icon** to add a **back to Hub button** or an **external link button** * **(D)** Here you can type in your **barcode content** if required > [!NOTE] > > Any updates made to the styling colors will apply to all screens. * **(10)** Set up your **Coupon Already Redeemed** screen. ![Digital Coupons: option a — Step 4: Set up your Screens](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-4-set-up-option-a-5.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=d4a36f63258b2b4c95ea1775f8771a63) * **(A)** Update the **title** here * **(B)** You have the option to add call-to-action buttons on this screen. Click on the **+ icon** to add a **back to Hub** button or an **external link button** > [!NOTE] > > Any updates made to the styling colors will apply to all screens. * **(11)** Set up your **Coupon Exhausted** screen. ![Digital Coupons: option a — Step 4: Set up your Screens](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/digital-coupons-step-4-set-up-option-a-6.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=bb588bda4e0ae7a47a87ab5054655474) * **(A)** Update the **title** here * **(B)** Edit the **coupon exhausted** copy here > [!NOTE] > > Any updates made to the styling colors will apply to all screens. ### Step 5: Create your Coupon Reminders ![Digital Coupons: step 5 — Step 5: Create your Coupon Reminders](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/digital-coupons-step-5-create-your-step-5.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=67b7f8e0728d985ba9715e7d4b4e76b6) * **(1)** Click on **add communication** to set up your reminders [Learn how to set up coupon reminders here.](/competitions-promotions/digital-coupons/coupon-reminders) ### Step 6: Connect your Coupon to a competition ![Digital Coupons: step 6 — Step 6: Connect your Coupon to a competition](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/digital-coupons-step-6-connect-your-step-6.gif?s=8a884dbdf6168e15e204385127bb117b) 1. Now that you've created your Digital Coupon, it's time to connect them to a competition! 2. Navigate to your competition, open the data capture dropdown menu, and click on **prizes** 3. Click the **+ Add prize** button and add an **email communication** > [!TIP] > > If you need assistance in configuring your prizes, head to the [Data Capture Knowledge Base Article](/getting-started/hub-setup/data-capture/index). ![Digital Coupons: step 6: Connect your Coupon to a competition](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/digital-coupons-step-6-connect-your-screenshot.gif?s=3b553cb8c408284ed82d83261e2637a6) 4. Use this modal to **edit your prizing communication**. This is the email or SMS your users will receive upon winning a prize. [Learn more on how to set up email communications](/competitions-promotions/setup-management/prizes-and-comms#step-3) 5. Navigate to the **coupon tab**, select the coupon you configured earlier and go to **insert** to paste the coupon code to the email > [!NOTE] > > We highly recommend presenting this in a button format. ![Digital Coupons: step 6: Connect your Coupon to a competition](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/digital-coupons-step-6-connect-your-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=be641c6931328a5585684b9474fa67d1) ## Coupon codes vs coupon links When you attach a coupon offer to an email or SMS, two template variables can appear: | Variable | Label | What it inserts | | - | - | - | | `{{coupon_link}}` | **Coupon link** | Unique redeem URL for that recipient (`/coupon/{id}` on your hub domain) | | `{{coupon_code}}` | **Coupon code** | Barcode or shared code string for POS / checkout | **How to insert them** 1. Open the prize or distribution communication. 2. Under **Attach a coupon offer**, select the offer. 3. Paste **Coupon link** and/or **Coupon code** into the message body (button recommended for the link). **When to use which** * **Coupon link** — send users into the branded redeem experience (swipe, barcode screen, locations, anti-screenshot). Prefer this for email/SMS CTAs. * **Coupon code** — put the redeemable string in the message itself. Available for barcode/shared-code offers; not shown for **Swipe** redemption. You can also copy a recipient’s link from the offer **Recipients** tab (row ⋮ → **Copy link**). ## Issue a coupon to everyone who submits a form Use a workflow when every person who submits a card's data capture form should get their own unique coupon, with no prize draw. You can see each coupon issued in Workflow Runs. ### Step 1: Create the coupon offer 1. In the hub, open **Coupons** → **+ Create offer** and set up the offer as in [Step 1](#step-1-create-a-digital-coupon) and [Step 2](#step-2-configure-your-offer). 2. For a unique code per person, choose **Barcode Unique** and add your codes with **Manage codes** (**Upload CSV**, **Add multiple** or **Generate From Pattern**). Load at least as many codes as you expect entries. 3. Set any **offer limits** (total issue or redeem limits) and the **Availability** window. These apply to the workflow too. ### Step 2: Add the form to your card Add a data capture form to the card the entries will come from. See [Data Capture](/getting-started/hub-setup/data-capture/index). Include an **Email** field to send the coupon by email, or a mobile number field to send it by SMS. ### Step 3: Create a workflow with the Data captured trigger 1. Go to **Automations → Workflows** → **+ Create Workflow** and choose **Card** scope for that card. See [Creating your first workflow](/integrations-automation/workflows/index). 2. For the trigger, choose **Data captured (Including disqualified)**. It runs on every form submission. 3. To issue only to entries that pass your entry rules, choose **Data captured (Qualified entries only)** instead. See [Gameplay triggers](/integrations-automation/workflows/triggers#gameplay-triggers). > [!TIP] > > Use **Data captured**, not **Gameplay ended**. Gameplay ended can fire before the form is submitted, so the workflow may not have the entrant's email or mobile yet. ### Step 4: Add an Issue coupon step 1. Add an **Issue coupon** step (in the **Cards and Coupons** group) after the trigger. 2. In **Offer**, select the coupon offer from Step 1. Only offers in the card's hub are listed. 3. Under **Output variables**, click **Manage variables** and add a String variable, for example `coupon_link`. Then pick it in **Issued coupon URL(s)**. You can also map **Issued coupon code(s)** if you want the raw code in the message. 4. Optional: under **Advanced**, set **Limit per contact** (for example `1`, so someone who submits twice still gets one coupon). Leave **Quantity** empty to issue one coupon. **Allow partial award** only applies when **Quantity** is more than 1. See [Issue coupon configuration](/integrations-automation/workflows/actions#issue-coupon-configuration) for every setting and output. ### Step 5: Send the coupon by email or SMS 1. From the **Issue coupon** step's success output, add a **Send email** step (choose **Transactional**) or a **Send SMS** step. **Send SMS** only appears if SMS is set up for your workspace. 2. In the message, insert the variable you mapped in Step 4 from the **variables** group, for example `{{variables.coupon_link}}`. Put the link behind a button in emails. > [!NOTE] > > In a workflow, the coupon comes from the **Issue coupon** step's variable, not from `{{coupon_link}}`. `{{coupon_link}}` is the variable used when you attach a coupon offer to a prize communication. ### Step 6: Handle "no coupon issued" The **Issue coupon** step has three outputs. Hover a handle to see its name. | Output | When it's used | | - | - | | **Success** | The coupon was issued. Connect your Send email or Send SMS step here. | | **Offer limits exceeded** (`OfferLimitsExceeded`) | The offer's issue or redeem limit is reached, unique codes have run out, or the contact has hit **Limit per contact**. | | **Offer expired** (`OfferExpired`) | The offer is outside its **Availability** window. | Connect **Offer limits exceeded** and **Offer expired** to a fallback, for example a **Send email** saying the offer has ended. If you leave them unconnected, the run stops at the **Issue coupon** step and nothing is sent. You can see these runs, and the reason, in [Workflow Runs](/integrations-automation/workflows/workflow-runs). > [!TIP] > > Add contacts under the offer's limits so you're emailed when the issue limit is reached, and top up codes in **Manage codes** before they run out. **Example workflow** ![Digital Coupons: example workflow with a Data captured (Qualified entries only) trigger, then an Issue coupon step (Offer: Free Ticket, Limit per contact 1, Quantity 1). The success output sends a transactional email "Here's your free ticket!" and the fallback output sends a transactional email "Sorry, we're out of tickets!"](https://mintcdn.com/komotechnologies/MUDwm0T9B209e9ZV/images/digital-coupons-coupon-on-form-submit-workflow.webp?fit=max\&auto=format\&n=MUDwm0T9B209e9ZV\&q=85\&s=80e1eb0ddb7dadc8d21e2f675304964b) ## Resetting coupons Two different resets exist. Do not confuse them. ### Reset one recipient Use when someone redeemed early and needs a second chance (e.g. before an event). 1. Open the hub → **Coupons** → open the offer. 2. Open the **Recipients** tab. 3. Filter to **Redeemed** if needed. 4. On that row, click ⋮ → **Reset Coupon** → **Yes, reset it**. That coupon returns to **Redeemable**. The same link and code still work. Redeemed timestamps clear. > [!WARNING] > > You cannot reset a coupon that is already **Redeemable**, **Voided**, or on an expired offer. ### Reset all coupons (destructive) Use only when you intend to wipe every issued coupon for the offer. 1. On the **Coupons** list, open the offer row ⋮ → **Reset coupons** (or **Reset coupons and unique codes** for unique-barcode offers). 2. Or open the offer → **Manage codes** → **Reset all coupons**. 3. Confirm by typing the offer name, then **Reset**. This **deletes all issued coupons**, invalidates old links in sent messages, and (for unique codes) returns used banks to **Available**. > [!WARNING] > > Reset all cannot be undone. Prefer per-recipient reset unless you truly need a full wipe. ## Exporting recipients (including deleted contacts) 1. Open the offer → **Recipients**. 2. Click **Export recipients**. 3. Download the CSV from the export email/job when ready. Deleted contacts stay in search and export so historical coupon activity is not lost. Their name, email, and mobile show as `*DELETED*` in the CSV; coupon status and dates still export. The Recipients table labels those rows **Deleted Contact**. # Prizes and Communications Source: https://knowledge.komo.tech/competitions-promotions/setup-management/prizes-and-comms/index Need help setting up prizes and communications for your Hub? Check out the article below. ## What is it? For every card with a data capture attached, you can create prizes to send to the winners with communications. ## How do I set it up? * [Step 1: Add a Data capture](#step-1-add-a-data-capture) * [Step 2: Set up your Prizes](#step-2-set-up-your-prizes) * [Step 3: Set up your Prize communications](#step-3-set-up-your-prize-communications) * [Step 4: Add additional Communications](#step-4-add-additional-communications) * [Step 5: Set up Marketing Email Communications](#step-5-set-up-marketing-email-communications) ### Step 1: Add a Data capture ![Prizes and Communications: step 4 — Step 1: Add a Data capture](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-1-add-a-step-4.gif?s=d3a7a83da3db4e42a674f490d49f4cd3) * Navigate to your **Engagement Hub.** * Go into the card settings, click on **Data capture,** and then **+ Add Data Capture.** ### Step 2: Set up your Prizes ![Prizes and Communications: step 2 — Step 2: Set up your Prizes](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=82de743ddc1a8b0e1b2632181715b581) * **(1)** Click on the **Prizes** tab under the **Data Capture** dropdown. * **(2)** Click **+ Add** **prize**. ![Prizes and Communications: option a — Step 2: Set up your Prizes](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-2-set-up-option-a.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=14300d39e9fb2dea0a33b01d9b17d8cd) * **(A)** Give the prize **Prize Name** (this will be internal only) * **(B)** Click **Edit prize rules**. ![Prizes and Communications: option a — Step 2: Set up your Prizes](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-2-set-up-option-a-2.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=dffcb23aeb82e3d751026a2f35dcc53b) * **(a)** Set your **awarding rule** under **Award to**. This refers to what group of entrants you want a particular prize to be awarded to. > **Awarding Rule** > > * **Award prize manually:** \ > This allows you to manually select a particular entrant or group of entrants to receive the prize. This prizing rule cannot be automated and requires you to select the recipients post-game. > * **Random pick X person/s:** \ > This option randomly awards the prize to entrants. The number of entrants who receive this prize is completely up to you and can even be automatically awarded post-game using scheduling. > * **Everyone who entered:** \ > This rule simply provides everyone who has entered with the prize you've created. > * **Everyone who didn't win any other prizes in this competition:** \ > Use this rule to provide a particular communication to entrants who didn't win a prize in your competition. > * **Live prize awarding:**\ > This option allows you to send prizes to users live/instantly while they engage with your content. > > [!NOTE] > > > > **If** you select this option, you will need to enable this prize once it is all setup. You can see how to enable live prizing [here](/live-predictor-advanced#Step-6). * **(b)** Select **when** to award the prize. This is where you'll set additional parameters that need to be met. > [!NOTE] > > This is what is mainly used for personalized prizing. > **Prize Parameters** > > * **Answered 'select question' with 'select answer':** \ > This option awards the particular prize to entrants who respond with a selected answer to one of your questions. Ie: In your Live Trivia game you may have asked "What's your favorite ACME sports drink flavor?", with the potential answers being lime or apple. By using this parameter you can provide users who responded with 'lime' a lime coupon in the prize. > * **Got result x:**\ > Award prizes based on a result they receive. Ie: In your Personality Quiz, a result could be "You're a shoe shopper", and reward users with a discount voucher to spend at a shoe store. > * **Answered X or more questions:**\ > This option simply allows you to reward people who answered a predetermined number of questions. > * **Answered X or more questions correctly:**\ > Awards the prize to people who answered a predetermined number of questions correctly. > * **(c)** Click **Save** to confirm your awarding rule. ### Step 3: Set up your Prize Communications ![Prizes and Communications: step 3 — Step 3: Set up your Prize Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-3-set-up-step-3.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=aefc595f928c5e6b6fd5a3baeb3646a2) * **(1)** Here you will create your **Email communication** for this prize. > **Setting your Email Communication** > > ![Prizes and Communications: option a — Step 3: Set up your Prize Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-3-set-up-option-a.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=b9f088af41309c96e13cd48756802797) > > To send email communications, you'll need to have the email field on your form. > > * **(A)** Here you can give your prize communication an **Internal name**. > * **(B)** Select a **sender name.** If you don't have one listed, **(C)** click **Manage** to **add a new name.** > * **(D)** Enter your **email subject line** here. > * **(E)** You have the option to use **HTML code** for your email. > > ![Prizes and Communications: option a — Step 3: Set up your Prize Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-3-set-up-option-a-2.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=c38654e73999b09b29918b254c87d8ed) > > * **(a)** Paste your **HTML email code** here. > * **(b) Test** your email and preview the code. > * When HTML is turned on, the **Insert** panel (including **Image**) isn't available, so any images in your HTML need a full public URL. See [How do I add images to an HTML email?](#how-do-i-add-images-to-an-html-email) > * **(F) Build** out your email here. > * **(G)** Utilize the **toolbar** to construct your email body. > * **(H)** Here you can add **additional features** to your email body > > ![Prizes and Communications: step 3: Set up your Prize Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-3-set-up-screenshot.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=a04f502206893fc39660e73f6b3507ae) > > * **(a)** Add **images, call-to-action buttons, or horizontal rule.** > * **(b)** To personalize the experience, pull the entrant's responses to your data capture form from the **recall form data** section. > * **(I)** Edit the **body** and **container colors.** > > ![Prizes and Communications: step 3: Set up your Prize Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-3-set-up-screenshot-2.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=279a19aac05d74bfef82193af0b57c34) > > * **(a)** Alter this will change the background color **behind the email container.** > * **(b)** Update this to change the background color **behind the email body.** > * **(J)** Here you can attach a **coupon** to the prize. Select your desired coupon from the drop-down and then head back to the Insert tab and paste the code into the email body. > > ![Prizes and Communications: step 3: Set up your Prize Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-3-set-up-screenshot.gif?s=a351abb771174dfbc2ecf40dc167d15f) > * **(K) Test** the communication here. * **(2)** Or you can send out an **SMS communication** here. > **Setting your SMSCommunication** > > ![Prizes and Communications: step 3: Set up your Prize Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-3-set-up-screenshot-3.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=45b3e3e0937e2063240ca281a780b81e) > > To send SMS communications you'll need to add an SMS field to your form. > > > [!NOTE] > > > > To send SMS communications and with the new laws and regulations, you will need to have a Twilio account. [Click here to learn more on how to set this up.](/getting-started/hub-setup/sms-sender-ids/index) > > * **(A)** Here you can give your prize communication an **Internal name**. > * **(B)** You can create an SMS from our **templates.** > * **(C)** Select the **sender name** from your Twilio account. > * **(D) Create** your SMS copy here. > * **(E)** Pull the entrant's responses to your data capture form from the **recall form data** section. This means you can automatically personalize communications to the entrant by simply copying and pasting the code into the email body. > * **(F)** Here you can attach a **coupon** to the prize. Select your desired coupon from the drop-down and then copy and paste the code into the email body. > * **(G) Test** your SMS communication. > * **(H) Delete** the SMS communication here. ### Step 4: Add additional Communications ![Prizes and Communications: step 4 — Step 4: Add additional Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-4-add-additional-step-4.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=491fb596d79690d82bd1f1eb1841abf0) * Click on the **Communications** tab and then **+ Add Communication.** * **(1)** Give the communication an **Internal name.** * **(2)** Select the **type** of communication want to send - transactional or marketing email or SMS. > [!NOTE] > > A transaction email is triggered by an action taken by a user while a marketing email is sent to a user outside of the campaign. * **(3)** Choose when you want this communication to be sent. ![Prizes and Communications: option a — Step 4: Add additional Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-4-add-additional-option-a.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=83e9b5c58f08c8753ffc4c74acd749b9) * **(A) Manually** send this communication to users. * **(B)** Send this communication once a user completes the **data capture form.** * **(C)** Have the communication sent out at a **scheduled time and day.** * **(4)** Click **Create.** > [!NOTE] > > If sending a transactional email or SMS, build out your communications as per [**Step 3**](#step-3-set-up-your-prize-communications). If sending a marketing email, follow the steps detailed in [**Step 5**](#step-5-set-up-marketing-email-communications). ### **Step 5: Set up Marketing Email Communications** ![Prizes and Communications: step 3 — Step 5: Set up Marketing Email Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-5-set-up-step-3.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=f6071011ca3f3245dd7cf35c8659440e) To send email communications, you'll need to have the email field on your form. * **(1)** Here you can give your prize communication an **Internal name**. * **(2)** Select which **Communication Subscription Group** your email should be sent to. > [!NOTE] > > This will ensure your email is only sent to users who have opted in to the selected subscription communications.\ > \ > For more information on setting up Communication Subscriptions, read [this article](/crm/communications/communication-subscriptions) * **(3)** Select a **sender name**. If you don't have one listed, **(4)** click **Manage** to add a new name. * **(5)** Enter your **email subject line** here. * **(6)** You have the option to use **HTML code** for your email. If using HTML code, follow the process outlined in [**Step 3**](#step-3-set-up-your-prize-communications). * **(7) Build** out your email here. * **(8)** Utilize the **toolbar** to construct your email body. * **(9)** Here you can add **additional features** to your email body. You will need to insert the **unsubscribe URL code** in the email to provide users with the option to unsubscribe from communications. It is recommended that you hyperlink the to the **unsubscribe text**. Follow [**Step 3**](#step-3-set-up-your-prize-communications) to continue building your email. > **Example of unsubscribe URL code** > > The below screenshot is an example of how to include an **unsubscribe URL code** in your email body. > > ![Prizes and Communications: step 3 — Step 5: Set up Marketing Email Communications](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/prizes-and-comms-step-5-set-up-step-3-2.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=38d9b7f87ff0026345b230e0e477fa08) * **(10)** Edit the **body** and **container colors.** If editing the body and container colors, follow the process outline in [**Step 3**](#step-3-set-up-your-prize-communications)**.** * **(11)** Here you can attach a **coupon** to the prize. If attaching a coupon, follow the process outlined in [**Step 3**](#step-3-set-up-your-prize-communications)**.** * **(12) Test** the communication here. > **[Communication Design Guidelines](https://docs.google.com/presentation/d/1wh3pJWPjcQ1xYKakWwkxqwohQQ705sfWDn_TCQ7XIRw/edit?usp=sharing)** > > Learn different communication materials sent to players and users ## FAQ **What is the difference between a marketing and transactional email?** A marketing email is any email that is intended to promote your brand and push recipients to perform an action you want them to take. A transactional email differs in that it provides necessary information that the recipient requires in order for you to adequately complete a transaction or deliver your service. Transactional emails tend to be initiated off the back of an action taken by the recipient. **What happens when a user unsubscribes?** If a user clicks through and unsubscribes from communications, they will automatically be removed from the communication subscription they opted out of and will no longer receive the emails sent to that list. **How do I add images to an HTML email?** When **Use HTML for email** is turned on, you paste your own HTML, and the **Insert** panel (where you'd normally add an **Image**) isn't available. Every image in your HTML needs a full public URL in its `src`. Images you've uploaded to Komo already have a public URL on Komo's CDN (for example `https://cdn..komo.site/media/image/...`). There isn't a copy-link button for it yet, so to get the URL: 1. Open a page in Komo where the image is shown, such as your Hub or a card preview. 2. Right-click the image and choose **Copy image address** (or find the image's `src` in your browser's developer tools). 3. Paste that URL into the `src` of the `` tag in your HTML. You can also host the image anywhere else that gives you a public URL. Use **Test** to send yourself a copy and check that the images load. # Vault Digital Mastercards Source: https://knowledge.komo.tech/competitions-promotions/vault-mastercard/vault-digital-mastercards/index Easily distribute Vault Digital Mastercards to prize winners using automated workflows. ## What is it? Vault Mastercards are digital prepaid cards that can be instantly issued to prize winners via automated workflows. These digital cards can be accessed on recipients' phones and used wherever traditional Mastercards are accepted. Continue reading to learn how you can effortlessly distribute Vault Mastercards to your prize winners. ## How do I do it? ### Step 1: Provide Vault Campaign IDs * Ensure you have a **Campaign** set up with **Vault**. Once everything is approved, you will need to provide your Customer Success Manager with access and share your credentials. Please forward this request to Vault with your CSM's details. When granted access, your CSM will then complete the backend connection on your behalf. If you have any issues or require further assistance, please reach out to your Customer Success Manager directly. ### Step 2: Create your prize * Prior to creating your distribution workflows, you will need to ensure you have created your prize. You will not be able to link your workflow until this prize is created. For detailed information on how to create prizes, please read [this article](/competitions-promotions/setup-management/prizes-and-comms). ### Step 3: Build your workflow ![Vault Digital Mastercards: step 3 — Step 3: Build your workflow](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vault-digital-mastercards-step-3-build-your-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=b2aedd3232c1c95726e3c07881bb8faf) * Navigate to your **Card** and go into the **Card Settings.** * **(1)** Click on **Workflows**. * **(2)** Click on **Definitions**. * **(3)** Select **+ Create workflow**. ![Vault Digital Mastercards: option a — Step 3: Build your workflow](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vault-digital-mastercards-step-3-build-your-option-a.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=1d280d6e0dc1c47d8c9681f1c5958225) * **(A)** Give your workflow a meaningful **Name.** * **Note:** This is internal only but we recommend that the naming aligns with the prize on offer for clarity. * **(B)** Click **Create**. ![Vault Digital Mastercards: option a — Step 3: Build your workflow](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vault-digital-mastercards-step-3-build-your-option-a.gif?s=4208c46426b4c6ac1428bb972e933920) * You can now start building out your workflow. * Select the **pencil icon** next to Trigger. * Select **Prize Awarded** from the **Execute flow on** dropdown. * Click **+ Add filter**, select **Prize is** and then select the appropriate **Prize** from the dropdown (you created this prize in [**Step 2**](#step-1-provide-vault-campaign-ids)). * Click **Save** and exit the modal by clicking **X**. * Drag the **Issue Vault Card** workflow module and drop it below the **Trigger module**. * Click on the **circle** at the bottom of the **Trigger module, drag** and **drop** on the **circle** of the **Contact Vault Card Issue module**. * Select the **pencil icon** next to **Contact Vault Card Issue**. * Select your **Campaign ID** from the dropdown (this is the ID you provided in [**Step 1**](#step-1-provide-vault-campaign-ids)). * Type the appropriate **Gift Card value** in the **Amount** field. * Set you **Limit per contact** as per your game rules (we recommend leaving blank for unlimited). * Click **Save** and then exit the modal by clicking **X**. * Finish building your workflow by clicking **Save**. ### Step 4: Activate your workflow ![Vault Digital Mastercards: step 4 — Step 4: Activate your workflow](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vault-digital-mastercards-step-4-activate-your-step-4.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=ff4b40710a4de76e42c40b672e2c77de) * You will now have to **Run** your workflow for it to begin working. * **(1)** Click the **three dots** to access the additional actions. ![Vault Digital Mastercards: option a — Step 4: Activate your workflow](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vault-digital-mastercards-step-4-activate-your-option-a.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=af3ea6bc8ae3c086e5b11f254eb7ff3f) * **(A) Run** - Click this to **run** your workflow. * **(B) Edit** - Here you can make **edits** to the workflow you set up. * **(C) Rename** - Select this if you would like to **rename** your workflow. * **(D) Delete** - Click this if you would like to **delete** your workflow. * Once you have selected **Run**, your workflow will be live and you can move onto testing! ### Step 5: Test your workflow * Repeat [**Step 2**](#step-1-provide-vault-campaign-ids)**,** [**Step 3**](#step-1-provide-vault-campaign-ids) and [**Step 4**](#step-1-provide-vault-campaign-ids) to create a test prize and workflow. > [!TIP] > > * We recommend clearly naming your prize and workflow with **Test** or **Testing** for easy identification. > * When setting your prize, ensure that the **Awarding Prize Rule** is set to manually selected. This will be the default selection. > * When setting up your test workflow, we recommend setting the Vault Gift Card **Amount** to **\$1.00** and the **Limit per contact** to **1**. * Once you have set up your test prize and workflow, you will then need to test the Card. For information on how to test your card, [please read this article.](/getting-started/hub-setup/card-testing) * Once you've tested the card and entered your details, you can then test the workflow. * Navigate to the **Card Settings** and select **Prizes** under the **Data Capture** dropdown. * Select the **three dots (actions)** next to your **Test Prize**. * Click **Select recipients to award**. * You should now see the **contact details** you submitted when working through the Card experience. * **Check the box** next to your **contact details** and click **Review**. * You can now review the details of the **contact** and click **Award Prize**. * A pop-up should appear confirming that **Awarding prizes** have been **completed**. Confirm that the **Status** box next to your test prize also displays **Awarded**. * When you are satisfied that your test workflow is operating as expected, it is best to ensure the workflow is paused by navigating to your test workflow under **Definitions**, clicking the **three dots (actions)** next to your test workflow (as detailed in [**Step 4**](#step-1-provide-vault-campaign-ids)) and selecting **Pause**. > [!TIP] > > Once your test workflow is paused, we also recommend canceling the **Test Card** directly in the Vault portal. ### Step 6: Monitor your workflow ![Vault Digital Mastercards: step 6 — Step 6: Monitor your workflow](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vault-digital-mastercards-step-6-monitor-your-step-6.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=4ff9ee67f5a182ed87191e303f4d6dac) * It is important to **monitor** your test workflow to ensure it is running as expected. * **(1)** Navigate to the **Workflows** dropdown. * **(2)** Select **Usage**. * **(3)** View the **STATUS** and **INFO**. If the status displays an error, we recommend hovering your mouse over the error icon under **INFO**. * You will then be provided with a summary of the error (you can also click for more detailed information that will enable you to troubleshoot). ## FAQ **I'm experiencing errors when testing my workflow, what is causing this?** The most common error we see customers experience when setting up their workflows is a misalignment between the form fields included on their Komo Card and the fields required by Vault to fulfill the Card issuance. Vault usually require both a mobile number and email address, so it's best to include both on your forms. If you experience any other issues, the error message displayed next to the workflow in the **Usage** section should give you the context you require to diagnose the issue. If you are still having issues, please reach out to your Customer Success Manager. **Who should I contact if I have any questions or issues?** For any enquiries about the **Vault Mastercards/Vault Portal**, please reach out directly to [info@vaultps.com.au](mailto:info@vaultps.com.au). For any questions or issues relating to the setup within Komo or issues with the Komo portal, please contact your Customer Success Manager. **Do you have any resources that can be shared with our consumers?** Yes! Feel free to send [this Help Centre link](https://vaultps.zendesk.com/hc/en-au?_gl=1) directly to your consumers. # Amondo Card Source: https://knowledge.komo.tech/content-types/embeds/amondo-card/index Instructions on how to embed Amondo imprints in your Engagement Hub ## Watch it come to life [Loom video player](https://www.loom.com/embed/2313df9054ac4988adb60646f1148f42) ## What is it? The Amondo Card allows you to embed curated content from across all your business's social media platforms and display them in one, easy to manage, card. ## Things to note * You will need to create an imprint through the [Amondo platform.](https://www.amondo.com/) * Once you have created your Imprint through Amondo you will then need to copy and paste the embed link into the card in your Engagement Hub. ## How do I build one? * [Step 1: Add an Amondo Card to your Engagement Hub](#step-1-add-an-amondo-card-to-your-engagement-hub) * [Step 2: Paste in the Imprint ID](#step-2-paste-in-the-imprint-id) * [Step 3: Publish your Card](#step-3-publish-your-card) ### Step 1: Add an Amondo card to your Hub ![Amondo Card: step 2 — Step 1: Add an Amondo card to your Hub](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-1-add-an-step-2.gif?s=d9c24e1d9424a8c95dbd33ea5346415f) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Amondo.** * You will then see your new card has been added to your Engagement Hub. ### Step 2: Paste in the Imprint ID ![Amondo Card: step 2 — Step 2: Paste in the Imprint ID](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-2-paste-in-step-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=0424b43a60a44f90dcb10b0ac0cbaf59) * **(1)** Get the **Imprint ID** and paste it in here and a preview will appear on the left. > **Finding the Imprint ID** > > To find the Amondo's Imprint ID simply copy the number from the Amondo Imprint URL, otherwise you can find it in the Imprint SDK Generator. > > **1. Start by going to your Imprints list and click on the imprint to open it up** > > ![Amondo Card: step 2: Paste in the Imprint ID](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-2-paste-in-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=541958e74407e737cd44185be319a4a1) > > **2. Copy the Imprint ID which is the 4 digits located in the URL bar** > > ![Amondo Card: step 2: Paste in the Imprint ID](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-2-paste-in-screenshot-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=f49e72a07182c15ff8608100c0f29e66) > > **3. Paste the Imprint ID in the box** > > ![Amondo Card: step 2: Paste in the Imprint ID](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-2-paste-in-screenshot-3.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=8f15b389aa3c4672fbc8ee4b1130150a) * **(2)** Toggling this option on allows you to restrict the **height** of your Amondo. If you do decide to use this feature a "See More" CTA bar will appear at the bottom of card * **(3)** Under **advanced options** you can further customize your Amondo. Click [here](https://dash.amondo.com/developers/web-sdk/options) for an in-depth breakdown of these options > [!TIP] > > In the Advanced options, placing a comma at the end of the title option and entering "poweredBy": false below it will hide the powered by Amondo at the bottom of the card > > ![Amondo Card: step 3 — Step 2: Paste in the Imprint ID](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-2-paste-in-step-3.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=759b70471259e7f8f171016108a2be73) ### Step 3: Publish your card ![Amondo Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=665776c561b8c417b779d5c16639de88) Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live! * **(1)Publish** your card manually and instantly for the world to see * **(2)Schedule** your card to be published and unpublished at set dates and times * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it > [!WARNING] > > All competition entries will be recorded and will impact the card analytics. ![Amondo Card: step 3: Publish your card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/amondo-card-step-3-publish-your-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=44c9ee9ced29ad482bc4773b90bad935) # Apple Music Card Source: https://knowledge.komo.tech/content-types/embeds/apple-music-card/index Embed Apple Music playlists or songs into your Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/b4843b7f586e45e98ae37e218140a928) ## How do I build one? * [Step 1: Add an Apple Music card to your Hub](#step-1-add-an-apple-music-card-to-your-hub) * [Step 2: Set up your card link](#step-2-set-up-your-card-link) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add an Apple Music card to your Hub ![Apple Music Card: step 2 — Step 1: Add an Apple Music card to your Hub](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/apple-music-card-step-1-add-an-step-2.gif?s=f40716a5ddd6ab86a709c65b259db4c8) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Apple Music**. * You will then see your new card has been added to your Engagement Hub. ### Step 2: Set up your card link ![Apple Music Card: step 2 — Step 2: Set up your card link](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/apple-music-card-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=324c54cd40696bd54b73eea8b6b9bfbb) * Clicking on **Apple Music** will open the editing module. * **(1)** Get the **embed code** and paste it here and a preview will appear below. * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Apple Music Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/apple-music-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=92f08b164be4d684eb370b7cd2041db7) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. ## FAQ **Where can I find the share link/URL?** Click on the playlist or song you wish to share. Click on the three dots located at the top of the playlist on the right, click on 'Share', then 'Copy Link' and paste that link to the share link bar in the card. # Embed Cards Source: https://knowledge.komo.tech/content-types/embeds/embed-cards/index Embed any card from your Engagement Hub within your third-party site! ## What is it? Take content from your Engagement Hub and integrate it into your website, blog or app. ## How do I use it? * [Step 1: Navigate to the card](#step-1-navigate-to-the-card) * [Step 2: Configure your card settings](#step-2-configure-your-card-settings) * [Step 3: Embed the content](#step-3-embed-the-content) ### Step 1: Navigate to the card ![Embed Cards: step 2 — Step 1: Navigate to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/embed-cards-step-1-navigate-to-step-2.gif?s=355e0b717ff6f3dde18d6e1d66da87a6) * Navigate to your **Engagement Hub.** * Once there, **scroll and click on the card** you wish to embed to access the **card editor**. * Click on the **Embed** tab. ### Step 2: Configure your card settings ![Embed Cards: step 2 — Step 2: Configure your card settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/embed-cards-step-2-configure-your-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=77b9f7326ef5ac94ee34164bf4302864) * **(1)** Here you can edit the **card cover** style. * **(2)** Edit the **cover image** you wish to have on the embed. * **(3)** Alter the **color** of the **text** and **call-to-action bar**. * **(4)** Change the **copy** of the call-to-action bar. * **(5) Restore** the style to the default settings. > [!NOTE] > > This is an embed preview. Any entries submitted or games played in the preview will count as real entries and gameplay and will be reflected as such in the analytics. ### Step 3: Embed the content ![Embed Cards: step 3 — Step 3: Embed the content](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/embed-cards-step-3-embed-the-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=4dbdf9190af5f08f889609a94c05f109) * **(1)** If you would like to make use of the embed code to paste within your desired location, click on **Get embed code.** > **Getting the Embed Code** > > ![Embed Cards: option a — Step 3: Embed the content](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/embed-cards-step-3-embed-the-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=ea8ed50e271ba1924df48850c2457bae) > > * **(A)** Click here if you would like to embed the card with **fixed** size. > * **(B)** Here you can adjust the **size of the embed** if using the fixed option. > * **(C)** Click the **copy icon** to copy the embed code if using the fixed option. > * **(D)** Click here if you would like to embed a card that is **responsive** in size. > > ![Embed Cards: option a — Step 3: Embed the content](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/embed-cards-step-3-embed-the-option-a-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=5293a8ecd5a7852bd0ab4d4a6c901e7d) > > * **(a)** Click the **copy icon** to copy the embed code if using the responsive option. > * Once you've copied your desired embed code, **paste it** into the **embed destination**. > **Advanced** > > Open the card → **Embed** → **Get embed code** → **Advanced**. > > * **UTM Parameters** — set campaign UTMs for the embed. Use **Edit UTM parameters** to change values. See also [UTM Parameters](/getting-started/promotion/utm-parameters). > > * **Forward query parameters from host page** — when checked, query params from the host page URL are forwarded into the embed. > > > [!TIP] > > > > Embed SDK options and host-page integration: [Browser embedding (developers.komo.tech)](https://developers.komo.tech/embedding/browser). * **(2)** If you would like to embed the card in a React Native application, click **Native embed URL,** install `@komo-tech/react-native` from NPM, and pass the URL to the `KomoCard` component. > [!NOTE] > > If you would like to explore additional ways to surface and trigger embedded cards on your website or app or prefill forms in the embed experience, please refer to our [**Embed SDK Developer docs**](https://developers.komo.tech/embedding/browser). ## FAQ **If I change the cover image under the Embed tab, will it change the cover image on the Hub?**\ No, the cover image you add/change under the Embed tab will apply to just the embed and will not affect the designs on the Hub. **Can users go to the Hub from the embed?**\ Users will only be able to access your Hub through the embed if you include a link out to the Hub within the competition card. # Facebook Card Source: https://knowledge.komo.tech/content-types/embeds/facebook-card/index Instructions on how to embed Facebook posts in your Engagement Hub. ## What is it? Share Facebook content on your Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/4939a7e8209240f899c2268f53b01769) ## Things to note * Only **Public** Facebook content can be embedded. * Only individual posts can be embedded - not entire timelines. ### How do I build one? * [Step 1: Add a Facebook Embed card to your Hub](#watch-it-come-to-life) * [Step 2: Paste the link to the card](#watch-it-come-to-life) * [Step 3: Publish your card](#what-is-it) ### Step 1: Add a Facebook Embed card to your Hub ![Facebook Card: step 2 — Step 1: Add a Facebook Embed card to your Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-card-step-1-add-a-step-2.gif?s=aa9de0e65ddcd10e1b165c964207c358) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Facebook.** * You will then see your new card has been added to your Hub. ### Step 2: Paste the link to the card ![Facebook Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=796f8f790cebfd8aff26692217694559) * Clicking on **Facebook** will open the editing module. * **(1)** Get the **embed code** and paste it here and a preview will appear below. > **Getting the Facebook embed code** > > **1. Start by visiting the Facebook account with the post you want to embed. Click on the ... button at the top right of the post.** > > ![Facebook Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=8895c18d769764bdefc498bd7a0558d2) > > **2. Click the Embed \ button** > > ![Facebook Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-card-step-2-paste-the-step-1-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=d1f3ca29f3780bed1b88cf2835a3eb1e) > > **3. Copy the code** > > ![Facebook Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-card-step-2-paste-the-step-2-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=40b86da299ccab970c34c370c7a297c6) > > **4. Paste the code in your Facebook embed card on your Komo Hub.** > > ![Facebook Card: step 3 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-card-step-2-paste-the-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=ec5e09b1ada254e96976718d8a4f41a3) * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Facebook Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=954471f3fcfdbb062dc31eda6a4a5509) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. # Facebook Watch Card Source: https://knowledge.komo.tech/content-types/embeds/facebook-watch-card/index Share Facebook Watch videos in your Engagement Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/6d507bb7c0d547a5ae29ce561d4cf055) ## Things to note * Only **Public** Facebook videos can be embedded. * Facebook **live** videos cannot be embedded. * Videos will be embedded without any of the other post details. To embed entire Facebook posts, use the **Facebook Embed** card. ## How do I build one? * [Step 1: Add a Facebook Watch card to your Hub](#step-1-add-a-facebook-watch-card-to-your-hub) * [Step 2: Paste the link to the card](#step-2-paste-the-link-to-the-card) * [Step 3: Publish the card](#step-3-publish-the-card) ### Step 1: Add a Facebook Watch card to your Hub ![Facebook Watch Card: step 2 — Step 1: Add a Facebook Watch card to your Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-watch-card-step-1-add-a-step-2.gif?s=600a06c9ccc077165a346f357193e5ba) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Facebook Watch**. * You will then see your new card has been added to your Hub. ### Step 2: Paste the link to the card ![Facebook Watch Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-watch-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=e3ba10a53d4de372a48d2b2c08e7ac90) * Clicking on **Facebook Watch** will open the editing module. * **(1)** Get the **Facebook Watch link** and paste it here. > **Getting the Facebook Watch link** > > **1. Visit the Facebook account with the video post you want to embed** > > Click on the **...** button at the top right of the post. > > ![Facebook Watch Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-watch-card-step-2-paste-the-step-1-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=4d3f35fa9b399003bd20afc046ba63f0) > > **2. Click the Copy Link button.** > > ![Facebook Watch Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-watch-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=15adf39fe053b04c7f7cdedded1d99d8) > > **3. Paste the code in your Facebook Watch Video card settings on your Komo Hub.** > > ![Facebook Watch Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-watch-card-step-2-paste-the-step-2-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=7d0181bc2a587dc0aa47619950def989) * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Facebook Watch Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/facebook-watch-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=3d429e031820a8e647a00d82c864651c) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. ## FAQ **Why is my video not working?** Make sure the video is public as private videos cannot be shared. Some users don't allow their videos to be embedded and shared on other web pages. # Google Maps Card Source: https://knowledge.komo.tech/content-types/embeds/google-maps-card/index Instructions on how to embed Google Maps in your Engagement Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/397c4f3fddb54575a76a0fc0c3cf6e01) ## What is it? Share locations and addresses on your Hub. ## How do I build one? * [Step 1: Add a Google Maps Embed card to your Hub](#step-1-add-a-google-maps-embed-card-to-your-hub) * [Step 2: Paste the link to the card](#step-2-paste-the-link-to-the-card) * [Step 3: Publish the card](#step-3-publish-the-card) ### Step 1: Add a Google Maps embed card to your Hub ![Google Maps Card: step 2 — Step 1: Add a Google Maps embed card to your Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/google-maps-card-step-1-add-a-step-2.gif?s=6be33d99ed2e4a1ab275dba63ce05942) * Navigate to your **Engagement Hub**. * Once there, click **Add content,** from here select **Embeds** and then **Google Maps.** * You will then see your new card has been added to your Hub. ### Step 2: Paste the link to the card ![Google Maps Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/google-maps-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=0beb3c3c747a0d30024d93f606c1c28a) * Clicking on **Google Maps** will open the editing module. * **(1)** Get the **embed code** and paste it here and a preview will appear below. > **Getting Google Maps embed code** > > **1. Find the address or place you want to embed on Google Maps.** > > Click on the **Share** button > > ![Google Maps Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/google-maps-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=8d294b9feff24fd25a0c868e1163dace) > > **2. Choose Embed a map** > > ![Google Maps Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/google-maps-card-step-2-paste-the-step-1-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=68560ee810c28d69e1d9a0dfaa3f978e) > > **3. Choose the size and click COPY HTML.** > > ![Google Maps Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/google-maps-card-step-2-paste-the-step-2-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=2f3287ade6058e66c8b961a4390d15af) > > > [!TIP] > > > > The embedded Google Maps card will always try to stretch the map to fit the *width* of the card. Picking a different size here will just result in map cards with different *heights*. > > **Step 4** > > ![Google Maps Card: step 4 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/google-maps-card-step-2-paste-the-step-4.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=6f4f52d60e85ac81d45446c6166dc171) * **(2)** You can optionally override the **card height** after pasting in the embed code. * **(3)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(4)** Add a **description** to the card. ### Step 3: Publish your card ![Google Maps Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/google-maps-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=8156a69fcb08e9033714cc12afd14481) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. # HTML Card Source: https://knowledge.komo.tech/content-types/embeds/html-card/index Create interactive HTML-based content cards. ## What is it? An HTML Card is like a mini web page that requires multiple file types to create the ad feature and ad display. ## How do I build one? * [Step 1: Add an HTML card to your Hub](#step-1-add-an-html-card-to-your-hub) * [Step 2: Add your HTML code to your card](#step-2-add-your-html-code-to-your-card) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add an HTML card to your Hub ![HTML Card: step 2 — Step 1: Add an HTML card to your Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/html-card-step-1-add-an-step-2.gif?s=16015a0729dc41ea580b8e5940670f8f) * Navigate to your **Engagement Hub**. * Once there, click **Add content,** from here select **Embeds** and then **HTML.** * You will then see your new card has been added to your Hub. ### Step 2: Add your HTML code to your card ![HTML Card: step 2 — Step 2: Add your HTML code to your card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/html-card-step-2-add-your-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=0a72aeed60f87a331974d7958aec637e) * Clicking on the **HTML** will open the editing module. * **(1)** Paste your **HTML code** here and a preview will appear below. Anything placed in your HTML code is hosted in your iFrame. * **(2)** Enter the **HTML height** of how you want to display it on the card. * **(3)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(4)** Add a **description** to the card. ### Step 3: Publish your card ![HTML Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/html-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=cd35cc42f9b822f814f3ee92a2409507) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. See how to test your card [here](/getting-started/hub-setup/card-testing/index). # iFrame Card Source: https://knowledge.komo.tech/content-types/embeds/iframe-card/index Embed specific content from your webpage. ## What is it The iFrame card is used to seamlessly embed and load content from your webpage such as forms, documents and videos. ## Watch it come to life [Loom video player](https://www.loom.com/embed/dcd9c51491be4d9895d10a51202ae6dc) ## How do I build one? * [Step 1: Add an iFrame card to your Hub](#step-1-add-an-iframe-card-to-your-hub) * [Step 2: Add a link to your card](#step-2-add-a-link-to-your-card) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add an iFrame card to your Hub ![iFrame Card: step 2 — Step 1: Add an iFrame card to your Hub](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/iframe-card-step-1-add-an-step-2.gif?s=e4a400b4559e6027edf9e2d692a17dce) * Navigate to your **Engagement Hub**. * Once there, click **Add content,** from here select **Embeds** and then **iFrame.** * You will then see your new card has been added to your Hub. ### Step 2: Add a link to your card ![iFrame Card: step 2 — Step 2: Add a link to your card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/iframe-card-step-2-add-a-step-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=93827d4c86a895525959df2283de4c8b) * Clicking on the **iFrame** will open the editing module. * **(1)** Paste the **embed code** here and a preview will appear below. * **(2)** Enter the **iFrame height** of how you want to display it on the card * **(3)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(4)** Add a **description** to the card. ### Step 3: Publish your card ![iFrame Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/iframe-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=38803377eac0b906cb9d9d87ebd6e92a) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. ## **FAQ** **Where can I find the URL?** You can copy the link that is located in the search bar at the top of the page and paste that link into the **Paste link** setting in the card. **Why does my URL link look funny in the iFrame card?** Some websites aren't mobile phone supported. This means that the website will keep its format and dimensions when in the iFrame and you will need to scroll left and right to view the full URL. # Instagram Card Source: https://knowledge.komo.tech/content-types/embeds/instagram-card/index Instructions on how to embed Instagram content in your Engagement Hub. ## What is it? Share Instagram content on your Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/568269f93fbc4bae880ff2d815fcb675) ### **Things to note:** * Only **Public** Instagram content can be embedded. * Only individual posts can be embedded - not entire accounts. ### How do I build one? * [Step 1: Add an Instagram Embed card to your Hub](#step-1-add-an-instagram-embed-card-to-your-hub) * [Step 2: Paste the link to the card](#step-2-paste-the-link-to-the-card) * [Step 3: Publish your card](#step-3-publish-your-card) Step 1: Add an Instagram Embed card to your Hub ![Instagram Card: step 2 — How do I build one?](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-how-do-i-build-step-2.gif?s=493d07ffea612845816b1ab48d2fbe96) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Instagram.** * You will then see your new card has been added to your Hub. ### Step 2: Paste the link to the card ![Instagram Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=001dc508e3ee39537860b89d830d70a3) * Clicking on **Instagram** will open the editing module. * **(1)** Get the **embed code** and paste it here. A preview will appear below. > **Getting the Instragram embed code** > > **1. Start by visiting the Instagram account with the post you want to embed.** > > Click on the post you want to open it up. ![Instagram Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-step-2-paste-the-step-1-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=8f382d3c8e276d787c729ea5c6cdbe94) > > **2. Click on the ... button at the top right.** > > ![Instagram Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=cce736904c036231f532dd1da2507c2c) > > **3. Click on Embed** > > ![Instagram Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-step-2-paste-the-step-2-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=288ee9cecee6ee471e3b5376c14ac113) > > **4. Copy the code.** > > ![Instagram Card: step 3 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-step-2-paste-the-step-3.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=83e67642f75bf9c4698df05c6972c913) > > **Step 5** > > ![Instagram Card: step 4 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-step-2-paste-the-step-4.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=edff198707affab25713c27bab992e5a) > > > [!TIP] > > > > You can choose to include the caption before copying the code by toggling the appropriate checkbox. * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Instagram Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/instagram-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=7c7528acb98a3af91655c43fc9b99f8b) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **..** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. # Issuu Card Source: https://knowledge.komo.tech/content-types/embeds/issuu-card/index Instructions on how to embed Issuu publications in your Engagement Hub. ## What is it? Share content from Issuu directly on your Hub. ## Things to note * Only **Published** Issuu content can be embedded. * Embedding is not available for Issuu users on the **Basic** plan - only the paid plans support it. * [Don't have an Issuu account? Click here to check it out.](https://issuu.com/features/embed?issuu_product=header\&issuu_subproduct=anon_home\&issuu_context=link\&issuu_cta=embed) ## How do I build one? * [Step 1: Add an Issuu Embed card to your Hub](#watch-it-come-to-life) * [Step 2: Paste the embed code to the card](#watch-it-come-to-life) * [Step 3: Publish your card](#what-is-it) #### **Step 1: Add an Issuu Embed card to your Hub** ![Issuu Card: step 2 — Step 1: Add an Issuu Embed card to your Hub](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/issuu-card-step-1-add-an-step-2.gif?s=c312870dfec3d62104c49e65587a1bc7) * Navigate to your **Engagement Hub**. * Once there, click **Add content,** from here select **Embeds** and then **Issuu.** * You will then see your new card has been added to your Hub. ### Step 2: Paste the embed code to the card ![Issuu Card: step 2 — Step 2: Paste the embed code to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/issuu-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=982bf89ad6ee52f6bb3be8c910e203cd) * Clicking on **Issuu** will open the editing module. * **(1)** Get the **embed code** and paste it here and a preview will appear below. > **Getting your Issuu Embed Code** > > ![Issuu Card: step 1 — Step 2: Paste the embed code to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/issuu-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=080242be3f163a762c75dbb878dee38a) > > **1. Go to Publications from the side Navigation Menu and select the publication you want to embed.** > > **2. Under Share, select Embed on Website and it will open an embed widget.** > > **3. Adjust styling options.** > > **4. Click GET EMBED CODE.** > > **5. Paste the embed code into your Issuu embed card settings on your Hub.** > > ![Issuu Card: step 2 — Step 2: Paste the embed code to the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/issuu-card-step-2-paste-the-step-2-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=b90fc464bddec5f8b4cfe815729cd6ae) * **(2)** You can also adjust the **height** of the embedded card here. * **(3)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(4)** Add a **description** to the card. ### Step 3: Publish your card ![Issuu Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/issuu-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=d650605e173ece5412c39ce86b235b9a) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. # Matterport Card Source: https://knowledge.komo.tech/content-types/embeds/matterport-card/index Instructions on how to embed Matterport 3D walkthroughs in your Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/bfca785399bf4b47be52028967d0f3ab) ## What is it? Matterport allows you to share 3D virtual tours on your Hub. ## **Things to note** * Only **Public** Matterport models can be embedded. * You'll need to copy the embed code following clicking the play button * The Matterport experience is different between desktop and mobile devices. * On desktop browsers, visitors to your Hub will be able to interact with Matterport without leaving the Hub. They can interact with the 3D space directly in the Matterport embed card. * On mobile browsers, visitors to your hub will be taken to the dedicated Matterport viewer page for the embedded space. * This limitation is applied by Matterport and cannot currently be changed. * [Don't have a Matterport account? Click here to check it out. ](https://matterport.com/) ## How do I build one? * [Step 1: Add a Matterport Embed card to your Hub](#step-1-add-a-matterport-embed-card-to-your-hub) * [Step 2: Paste the link to the card](#step-2-paste-the-link-to-the-card) * [Step 3: Publish your card](#what-is-it) ### Step 1: Add a Matterport Embed card to your Hub ![Matterport Card: step 2 — Step 1: Add a Matterport Embed card to your Hub](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/matterport-card-step-1-add-a-step-2.gif?s=34cdafdf07702ea7b10a966482fea9e4) * Navigate to your **Engagement Hub**. * Once there click **Add Content,** from here select **Embeds** and then **Matterport.** * You will then see your new card has been added to your Hub. ### Step 2: Paste the link to the card ![Matterport Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/matterport-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=4da1747e2d3a4a0fbecb9a88e0791357) * Clicking on **Matterport** will open the editing module. * **(1)** Get the **embed code** and paste it here and a preview will appear below. > **Getting the Matterport Embed Code** > > **1. Visit the Matterport space you want to embed.** > > Once you start the 3D experience, by clicking the large play button icon, you can then click on the **"Share this Space"** button at the bottom right. > > ![Matterport Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/matterport-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=b8ea3fb8c6d2367775ef748a59dc7a3d) > > **2. Copy the URL** > > The link should be in the format [**https://my.matterport.com/show/?m=xxxxxxxxxxx**](https://my.matterport.com/show/?m=xxxxxxxxxxx) > > ![Matterport Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/matterport-card-step-2-paste-the-step-1-2.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=5140e819680aceb0d0b0a5730bdfc09a) > > **3. Paste the URL in the Matterport embed card settings on your Hub.** > > ![Matterport Card: step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/matterport-card-step-2-paste-the-screenshot.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=de2561631511ed501fa3b14c4711c17a) > > > [!TIP] > > > > You may get a different sharing screen, depending on how you are viewing the Matterport space. In either case, you should be able to choose a "copy link to clipboard" option that will give you a link with the required format. * **(2)** You can also adjust the **height** of the embedded card here. Keep in mind the different experiences between desktop and mobile as called out at the start of this article. * **(3)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(4)** Add a **description** to the card. ### Step 3: Publish your card ![Matterport Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/matterport-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=16a1adedde75216f515ab45a957ebce2) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. # Spotify Card Source: https://knowledge.komo.tech/content-types/embeds/spotify-card/index Soundtrack your Engagement Hub with a Spotify playlist embed. ## Watch it come to life [Loom video player](https://www.loom.com/embed/4957028130a243a9a0c275e30c73f7ae) i ## How do I build one? * [Step 1: Add a Spotify Card to your Engagement Hub](#step-1-add-a-spotify-card-to-your-engagement-hub) * [Step 2: Set up your card link](#step-2-set-up-your-card-link) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add a Spotify Card to your Engagement Hub ![Spotify Card: step 2 — Step 1: Add a Spotify Card to your Engagement Hub](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spotify-card-step-1-add-a-step-2.gif?s=a88f9be23ef9e7d1d38cd5b78559cbe1) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, then select **Embeds** and then **Spotify**. * You will then see your new card has been added to your Engagement Hub. ### Step 2: Set up your card link ![Spotify Card: step 2 — Step 2: Set up your card link](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spotify-card-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=b9caf9e72f97c1f622c1f906be87547e) * Clicking on **Spotify** will open the editing module. * **(1)** Paste the **link** of your playlist, album or song here and a preview will appear below. * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Spotify Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spotify-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=65ce7baa7a19991cf76c882c9784c20f) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. ## FAQ **Where can I find the share link/URL?** Click on the playlist you wish to share. Click on the three dots located at the top of the playlist, at the bottom of the list click share and 'Copy link to playlist', and paste that link to the share link bar in the card. # TikTok Card Source: https://knowledge.komo.tech/content-types/embeds/tiktok-card/index Instructions on how to embed TikTok videos in your Engagement Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/ef09057daacc455380500b17c4240c80) ## What is it? Share TikTok videos on your Hub. ## Things to note * Only **Public** TikTok videos can be embedded. * Only individual videos can be embedded - not entire accounts. ## How do I build one? * [Step 1: Add a TikTok Embed card to your hub](#step-1-add-a-tiktok-embed-card-to-your-hub) * [Step 2: Paste the link to the card](#step-2-paste-the-link-to-the-card) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add a TikTok Embed card to your Hub ![TikTok Card: step 2 — Step 1: Add a TikTok Embed card to your Hub](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/tiktok-card-step-1-add-a-step-2.gif?s=cd2fe4d0a1971bcc309c532c58dfcb51) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **TikTok**. * You will then see your new card has been added to your Hub. ### Step 2: Paste the link to the card ![TikTok Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/tiktok-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=77315e77815fe5bbc391118bd3d2cca3) * Clicking on **TikTok** will open the editing module. * **(1) Get the embed code** and paste it here and a preview will appear below. > **Getting the Tiktok embed code** > > \*\*1. Visit the TikTok account with the video you want to embed. \*\* > > Click on the video you want to open it up. ![TikTok Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/tiktok-card-step-2-paste-the-step-1-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=6d46ff58e229173e15cf25c44c11ca0b) > > **2. Click on the Embed (\) button in the "share to" section** > > ![TikTok Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/tiktok-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=ea71d114e54ea59f04769910d8a4195e) > > **3. Click on the Copy code to copy the embed code** > > ![TikTok Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/tiktok-card-step-2-paste-the-step-2-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=dfd3eb436a3a69f32749969e60909175) > > **4. Paste the copied code in the box.** > > ![TikTok Card: step 3 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/tiktok-card-step-2-paste-the-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=96c016d01d571591263c21386340631c) * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![TikTok Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/tiktok-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=25e53776925ec977c17cfa297b904364) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. # Twitch TV Card Source: https://knowledge.komo.tech/content-types/embeds/twitch-tv-card/index Share Twitch videos directly in your Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/7a9c950d96ad4853bde83a3b673c97bf) ## How do I build one? * [Step 1: Add a Twitch TV card to your Hub](#step-1-add-a-twitch-tv-card-to-your-hub) * [Step 2: Set up your card link](#step-2-set-up-your-card-link) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add a Twitch TV Card to your Engagement Hub ![Twitch TV Card: step 2 — Step 1: Add a Twitch TV Card to your Engagement Hub](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitch-tv-card-step-1-add-a-step-2.gif?s=ce61f280f6b57f9bf1d719b111ee46c2) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Twitch TV**. * You will then see your new card has been added to your Hub. ### Step 2: Set up your card link ![Twitch TV Card: step 2 — Step 2: Set up your card link](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitch-tv-card-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=b7b57ff70586d257fb222c8b4ae8bd01) * Clicking on **Twitch TV** will open the editing module. * **(1)** By clicking the placeholder cover image, paste your **video URL**. Learn more on how to get a video URL [here](/interactive-features/polls-surveys/video-url-link/index). * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Twitch TV Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitch-tv-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=1189ce2e939dc67f34c209c201f2ec4c) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **..** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. ## FAQ **Where can I find the share link/URL?** For Twitch videos, you copy the URL that is in the search bar at the top of the page and paste it into the share link bar on the card. # Twitter Card Source: https://knowledge.komo.tech/content-types/embeds/twitter-card/index Instructions on how to embed Twitter tweets and timelines in your Engagement Hub. ## What is it? Share Twitter content on your Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/f2e74065855245f4a648c2fb7f8bac46) ## Things to note * Only **Public** content can be embedded. * Embedding timelines and lists will automatically pull through the 20 latest tweets. ## How do I build one? * [**Step 1:** Add a Twitter Embed card to your Hub](#step-1-add-a-twitter-embed-card-to-your-hub) * [**Step 2:** Paste the link to your card](#step-2-paste-the-link-to-your-card) * [**Step 3:** Publish your card](#step-3-publish-your-card) ### Step 1: Add a Twitter Embed card to your Hub ![Twitter Card: step 2 — Step 1: Add a Twitter Embed card to your Hub](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-1-add-a-step-2.gif?s=cdfbc64a71c80c2545596af42a73247e) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Twitter.** * You will then see your new card has been added to your Hub. ### Step 2: Paste the link to the card ![Twitter Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=6257770933baf22cb2093b40f793d4dc) * Clicking on **Twitter** will open the editing module. * **(1)** Get the **embed code** and paste it here and a preview will appear below. > **Embedding single tweets** > > **1. On the tweet you want to embed, click the More (...) button.** > > ![Twitter Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-1.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=755195a510c6420e7760d52187abf08f) > > **2. Click the Embed (\) button.** > > ![Twitter Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-1-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=c7d8856d32174eb703aa08aeff5e4a55) > > **3. Click on "Copy Code"** > > ![Twitter Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-2-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=efffcd51ffd825d309cf91503cd6e163) > > **4. Paste the embed code in the Twitter embed card.** > > ![Twitter Card: step 3 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=6c78c0b66a49428f4bcb4d73ebc54c92) > **Embedding timelines and lists** > > **1. Visit publish.twitter.com to start the guided journey for getting twitter embed code** > > ![Twitter Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-1-4.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=467560067f2cdcf1f9f9461f538dbc8e) From here you can choose to embed individual tweets, user timelines, and custom lists. > > **2. In this example, we will be embedding the @choosekomo Twitter timeline. Enter the Twitter handle in the box and hit enter.** > > ![Twitter Card: step 1 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-1-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=cc163e8587c1c267d45843d395e28d0b) > > **3. "Embedded Timeline" as the display option.** > > ![Twitter Card: step 2 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-2-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=7b4550444302f6ccd1ff2f4785c5b61a) > > **4. Copy the code!** > > > [!TIP] > > > > You may wish to **set customization options** before copying the embed code. > > ![Twitter Card: step 4 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-4.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=a2832925b71913a2bc9ab2e7dccdfcbe) > > > [!NOTE] > > > > Setting a height on the embedded timeline will introduce an additional scrollbar inside the embedded timeline content. We do not recommend setting a width - the content will automatically try to scale to the best width. > > **5. Paste the embed code in the Twitter embed card in your Hub.** > > ![Twitter Card: step 3 — Step 2: Paste the link to the card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-2-paste-the-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=6c78c0b66a49428f4bcb4d73ebc54c92) * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Twitter Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/twitter-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=3c1036d8d05b0255b3134f108cc6ff37) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. # Vimeo Card Source: https://knowledge.komo.tech/content-types/embeds/vimeo-card/index Share video content from Vimeo in your Engagement Hub. ## Watch it come to life [Loom video player](https://www.loom.com/embed/61aeb5909cab49b8b4b2a1dd0366c626) ## How do I build one? * [Step 1: Add a Vimeo card to your Hub](#step-1-add-a-vimeo-card-to-your-hub) * [Step 2: Set up your card link](#step-2-set-up-your-card-link) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add a Vimeo card to your Hub ![Vimeo Card: step 2 — Step 1: Add a Vimeo card to your Hub](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vimeo-card-step-1-add-a-step-2.gif?s=a9a778925c3c13eb0a0e743c2a8785b8) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **Vimeo**. * You will then see your new card has been added to your Hub. ### Step 2: Set up your card link ![Vimeo Card: step 2 — Step 2: Set up your card link](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vimeo-card-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=db36c979067c095acdf97231fd3a4fdd) * Clicking on **Vimeo** will open the editing module. * **(1)** By clicking the placeholder cover image, paste your **video URL**. Learn more on how to get a video URL [here](/interactive-features/polls-surveys/video-url-link). * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![Vimeo Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/vimeo-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=21a75408db514becea0ea0d7ee90b7ef) Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live * **(1) Publish** your card manually and instantly for the world to see. * **(2) Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. ## FAQ **Where can I find the share link/URL?** For Vimeo videos, you copy the URL that is in the search bar at the top of the page and paste it into the share link bar on the card. # YouTube Card Source: https://knowledge.komo.tech/content-types/embeds/youtube-card/index Embed YouTube videos directly into your Engagement Hub. ## What is it? The YouTube card makes it easy for you to share video content with your community, grow brand awareness, and boost conversion rates. The Komo Engagement Engine works seamlessly with YouTube to link videos directly in your Engagement Hub, supporting your brand and/or your sponsor family. ## Watch it come to life [Loom video player](https://www.loom.com/embed/8111d4f00be249848b096567e7a23ad2) ## How do I build one? * [Step 1: Add a YouTube card to your Hub](#step-1-add-a-youtube-card-to-your-hub) * [Step 2: Set up your card link](#step-2-set-up-your-card-link) * [Step 3: Publish your card](#step-3-publish-your-card) ### Step 1: Add a YouTube card to your Hub ![YouTube Card: step 2 — Step 1: Add a YouTube card to your Hub](https://mintcdn.com/komotechnologies/0KPauDYFWqavK1TV/images/youtube-card-step-1-add-a-step-2.gif?s=08a1a2f86c8763d3bd10b314b2938164) * Navigate to your **Engagement Hub**. * Once there, click **Add content**, from here select **Embeds** and then **YouTube**. * You will then see your new card has been added to your Hub. ### Step 2: Set up your card link ![YouTube Card: step 2 — Step 2: Set up your card link](https://mintcdn.com/komotechnologies/0KPauDYFWqavK1TV/images/youtube-card-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=0KPauDYFWqavK1TV\&q=85\&s=b390b01cad7126d2803be70206eea556) * Clicking on **YouTube** will open the editing module. * **(1)** By clicking the placeholder cover image, paste your **video URL**. Learn more on how to get a video URL [here](/interactive-features/polls-surveys/video-url-link). * **(2)** You can add an **author** tag by displaying the brand or person who's responsible for the card content. * **(3)** Add a **description** to the card. ### Step 3: Publish your card ![YouTube Card: step 3 — Step 3: Publish your card](https://mintcdn.com/komotechnologies/0KPauDYFWqavK1TV/images/youtube-card-step-3-publish-your-step-3.webp?fit=max\&auto=format\&n=0KPauDYFWqavK1TV\&q=85\&s=cfbdcb04ea44ea9cfe32954a0dbf1911) **Once you've completed all of these steps and are happy with all the aspects, it's time to get your card live!** * **(1)** **Publish** your card manually and instantly for the world to see. * **(2)** **Schedule** your card to be published and unpublished at set dates and times. * **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. > [!NOTE] > > All competition entries will be recorded and will impact the card analytics. ## FAQ **Where can I find the share link/URL on YouTube?** There are two options. First, simply copy the URL on the browser (youtube.com/) and paste it into the share link bar on the Card. Second, you can also select Share a video on YouTube and then copy the link provided. You do not need to Embed the video. **Why is my video URL not working?** Some users don't allow their videos to be shared on other web pages. # Communication Subscriptions Source: https://knowledge.komo.tech/crm/communications/communication-subscriptions/index Easily create custom subscription consent fields for use across your customer communications. ## What is it? Communication Subscriptions allow for granular opt-in and consent control at the Contact and Workspace levels, ensuring privacy compliance, enhancing opt-in management for integrations, and streamlining opt-ins before marketing communications. Ultimately you are able to simplify consent while providing better data protection. ## Watch it come to life [Loom video player](https://www.loom.com/embed/222ab85bbd8a4b1795b3e93e6c722af7) ## How do I do it? * [Step 1: Create your subscription](#step-1-create-your-subscription) * [Step 2: Add subscription consent field to forms](#step-2-add-subscription-consent-field-to-forms) * [Step 3: Send communications to subscribed groups](#step-3-send-communications-to-subscribed-groups) ### Step 1: Create your subscription ![Communication Subscriptions: step 2 — Step 1: Create your subscription](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/communication-subscriptions-step-1-create-your-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=0cfe02a55a85fcd56c4947c875de317a) * Navigate to your **Workspace**. * **(1)** Click on **CRM**. * **(2)** Click on **Subscriptions**. * **(3)** Select **+ Create subscription**. > [!NOTE] > > You will see a default subscription titled 'Email Consent'. This can be edited or deleted by clicking the 3 dots on the right-hand side of the subscription. > **Creating a Subscription** > > ![Communication Subscriptions: option a — Step 1: Create your subscription](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/communication-subscriptions-step-1-create-your-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=4b73da7054526bf52be6b03fef2aa55d) > > * **(A)** Give your subscription a meaningful **Name**. This name will help with searching for the consent group when adding to forms. > * **(B)** Provide a relevant **Description** for your subscription. This is automatically added to the Communications preference page and will be viewable by users when managing subscription preferences. > * **(C)** Type in a **Unique Subscription ID**. This will be referenced when syncing with integrations. Make sure you are satisfied with the ID as it can't be edited once the subscription is created. > * **(D)** Review the **Communication preference preview**. This is auto-filled based on the information you inputted above and will be what users see when managing their subscriptions. > * **(E)** Type in your **Default Consent Field Label**. This is the label that will appear alongside the form checkbox when users provide consent. > * **(F)** Click **Create** to finalize the creation of the subscription. ### Step 2: Add subscription consent field to forms ![Communication Subscriptions: step 2 — Step 2: Add subscription consent field to forms](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/communication-subscriptions-step-2-add-subscription-step-2.gif?s=30980e3fc34b2399d2141969a986dbbd) * Once you have set up your subscriptions, you can now add it to the relevant card forms. * Navigate to the relevant **Card** and access the **Card Settings**. * Click on the **Data capture** dropdown, select **Form** from the options, and select **Form** in the middle of the screen. * Click the **+ sign** at the bottom of the form. * Scroll down your existing **contact properties column** and select the **Subscription** you created in [**Step 1**](#step-1-create-your-subscription). * You will then be able to **edit** the **Consent Field settings**, including **marking the checkbox as required** and editing the **field label**. * You will now see that the **Subscription Consent Checkbox** has been added to the form. ### Step 3: Send communications to subscribed groups Once your subscription has been created and tested, you are then able to send relevant communications to your subscribed groups. When creating communications, you will only have the ability to send marketing emails to users who have subscribed to those communications and explicitly opted in. For more detailed information on how to do this, please read [this article](/competitions-promotions/setup-management/prizes-and-comms). ### Check your audience before sending a marketing email to a list When you send a marketing email to a contact list (**CRM** → **Lists** → open a list → **Communications**), choose **Send** from the draft email's actions. The confirmation shows a live preview of who will get it, based on the email's Communication Subscription. This preview is for marketing emails only. SMS sends to a list are unchanged. ![Communication Subscriptions: the Send Email confirmation showing list size, recipients and skipped members](https://mintcdn.com/komotechnologies/8rnj75knjJaa193v/images/communication-subscriptions-list-email-audience-preview.webp?fit=max\&auto=format\&n=8rnj75knjJaa193v\&q=85\&s=e515c43434ef32dafea0417ff9d22f84) The preview shows: * **List size**: how many members the list has. * **Recipients**: how many members have an email and are subscribed to the email's Communication Subscription (for example, **Email consent**). Only these members receive the email. * **Skipped**: how many members won't receive it, broken down into: * **Missing an email**: the contact has no email address. * **No subscription**: the contact has no record for that Communication Subscription, for example because they never opted in. * **Unsubscribed**: the contact was subscribed but has since unsubscribed. **Send** stays disabled until the counts have loaded. If they can't load, close the dialog and try again. > [!NOTE] > > For a scheduled email, the counts are correct when you open the dialog. Komo checks the list again at send time, so the final numbers can change if members join, leave or update their subscriptions in the meantime. Once the email has been sent, the **Recipients** column on the list's **Communications** tab shows how many were sent and how many were skipped. Hover over it to see the skip reasons. Emails sent before this update (October 21, 2026) show the recipient count only. ## FAQ **How many subscriptions can I create?** You have the flexibility to create as many subscriptions as you require! **How is this different from existing opt-in fields?** Opt-in fields in their current form are set at the Card/competition level. With Communication Subscription Consent, you can create the subscriptions at the workspace level and add them directly to your Cards, removing the need to recreate consent fields on every Card or Competition. **How does this impact marketing communications?** With this new approach, instead of sending emails and then allowing customers to opt out, customers must now opt in first to receive marketing communications. This ensures an added layer of compliance across your communications. **Has this been rolled out for all communications?** Currently, Communication Subscription Consent has only been implemented on marketing email communications. Communication Subscription Communications will be implemented across transactional emails and SMS communications as an optional feature in a future release. # Reference Tables Source: https://knowledge.komo.tech/crm/communications/reference-tables/index Import a reference table to validate unique entries. ## What is it? This feature allows you to upload a file that can consist of client account/membership numbers, first and last name, email and more, and connect this to your competitions to validate unique entries. This feature gives you the ability to gate access to exclusive competitions based on user membership details. ## How do I use it? * [Step 1: Go to the Reference Tables setting](#step-1-go-to-the-reference-tables-setting) * [Step 2: Create a Reference Table](#step-2-create-a-reference-table) * [Step 3: Upload your Reference Table file](#step-3-upload-your-reference-table-file) * [Step 4: Update the Data capture form](#step-4-update-the-data-capture-form) * [Step 5: Link the Reference Table to your competition](#step-5-link-the-reference-table-to-your-competition) * [Step 6: Update mapping fields](#step-6-update-mapping-fields) ### Step 1: Go to the Reference Tables setting ![Reference Tables: step 5 — Step 1: Go to the Reference Tables setting](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-1-go-to-step-5.gif?s=46e6c3e0855de7c33cef3df75ccb033a) * Head to the **Workspace settings** followed by **Reference Tables.** ### Step 2: Create a Reference Table ![Reference Tables: step 2 — Step 2: Create a Reference Table](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-2-create-a-step-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=c55174375896402eea4a377f20deaeb4) * **(1)** Click on **Create table.** > **Creating a Reference Table** > > ![Reference Tables: option a — Step 2: Create a Reference Table](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-2-create-a-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=d544de84b2a8a01236d1815b81e469db) > > * **(A)** Give your reference table a **name.** > * **(B)** Add a **column** you have included in your file. > > ![Reference Tables: option a — Step 2: Create a Reference Table](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-2-create-a-option-a-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=5cf0d5803e92c376fd972cacfd78d696) > > * **(a)** Add your column **name** e.g. Membership Number. > * **(b)** You can mark this column as a **key column**. The key column refers to the column that will be scanned first against the reference table on the data capture.\ > **Note:** We recommend marking the unique field as the key column e.g. membership numbers, account numbers etc. ### Step 3: Upload your Reference Table file ![Reference Tables: step 3 — Step 3: Upload your Reference Table file](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-3-upload-your-step-3.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=47253aea03ec881bebf9373793ac7880) * **(1) Upload** your file here as a .CSV or .XLSX format. * **(2)** After you have uploaded your file, you will need to **update mapping** for each column created. > **Update Mapping** > > ![Reference Tables: option a — Step 3: Upload your Reference Table file](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-3-upload-your-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=12be0f85611153d88c7dead7d43830a3) > > * **(A)** Enter the **CSV column name** of the data you want to be located in each column of the reference table.\ > E.g. the Membership Number reference table column is to pull all the data under the Account Numbers column and complete all columns created > > ![Reference Tables: option a — Step 3: Upload your Reference Table file](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-3-upload-your-option-a-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=b05376bd6e504fda1d2d62b299712e37) > > ![Reference Tables: option a — Step 3: Upload your Reference Table file](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-3-upload-your-option-a-3.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=6eb4cc3ef408d33e3b241f87cba03508) ### Step 4: Update the Data capture form ![Reference Tables: step 4 — Step 4: Update the Data capture form](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-4-update-the-step-4.gif?s=f3f4682abf0482f4d3320d664d13a776) * Go back to your Hub and select the **Settings** cog on the relevant card. * Select **Data Capture** on the left menu. * Click on **Form** and then **Entry form**. * Then click on the **plus icon** and add a **text field.** > [!NOTE] > > The text field is relevant if you are requesting a unique field e.g. membership numbers. > **Adding Text** > > ![Reference Tables: option a — Step 4: Update the Data capture form](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-4-update-the-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=20045584b17b9649c5954924a48827e1) > > * **(A)** You can make this field **required.** > * **(B)** Give the field a **Label** on the form. > * **(C)** You can give this a **Unique ID** for analytic purposes. > * **(D)** Add a **placeholder text** in the field. ### Step 5: Link the Reference Table to your competition ![Reference Tables: option d — Step 5: Link the Reference Table to your competition](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-5-link-the-option-d.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=7dcd29e29c41362586faf338f8d1bfca) * **(1)** On the right sidebar, click on the **edit** icon next to Validation lookup. * **(2)** Using the drop down, select the **reference table** to connect to the data capture. ### Step 6: Update mapping fields ![Reference Tables: step 6 — Step 6: Update mapping fields](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-6-update-mapping-step-6.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=4e870b3b47af8b751b7f476a58b30a72) * **(1) Map** the relevant form field against the reference table column. > ![Reference Tables: option a — Step 6: Update mapping fields](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/reference-tables-step-6-update-mapping-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=98a66fa4fed64f8e88e480b93d438618) > > * **(A)** Using the drop-down menu, select the **form field** you want to validate against the reference table column. > * **(B)** Here you can edit the **message** that appears when a value entered is not found in the reference table file. * **(2)** Once you have mapped the columns you wish to validate, click on **Update rules** to save the validation settings. ## FAQ **What files can I import my Reference table from?** You can only import your Reference table from a **CSV** or **XLSX** file. **What can I use a Reference Table for?** You can use a reference table to qualify your users in order to enter a competition. If you want to run a competition for your members only, you can validate entries based on membership numbers, emails, first name and/or last name. This is to ensure only account owners can enter a competition, not another user using the account number to enter. # Contact Properties Source: https://knowledge.komo.tech/crm/contacts/contact-properties/index ## What is it? A Contact Property is a persistent value that lives on the Contact. An example is their email, their name, their date of birth, or even anything custom—say their favorite flavor of Coke. ## How do I use it? * [Step 1: Navigate to the Properties](#step-1-navigate-to-the-properties) * [Step 2: Create a Property](#step-2-create-a-property) * [Step 3: Add the Property to your Card](#step-3-add-the-property-to-your-card) * [Step 4: View the Property on Contacts](#step-4-view-the-property-on-contacts) ### Step 1: Navigate to the Properties ![Contact Properties: step 3 — Step 1: Navigate to the Properties](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-step-1-navigate-to-step-3.gif?s=9727f0833c98fb8fbf92ce58ab624b70) * Click on **CRM** on the left side-bar. * Head to the **Properties** tab to create your contact properties. ### Step 2: Create a Property ![Contact Properties: step 2 — Step 2: Create a Property](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-step-2-create-a-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=a623fcc3878998f4a537b0c2e142db30) * **(1)** Click on **Create property**. * **(2)** Give your new Contact Property a **Label**. This will be the label that appears on any forms with this property, as well as the label of this property on your Contacts table. * **(3)** Give the Contact Property a **unique identifier.** > [!WARNING] > > This cannot be edited after this step. * **(4)** Give your Contact Property an **internal description**. * **(5)** Choose if you would like this property to be available to add to your **Data Capture forms.** * **(6)** You have the option to **not display** this property on a contact profile * **(7)** Enabling the property as **PII** means all information collected from this property will be removed when a contact is deleted. > **Contact Property Field Type** > > ![Contact Properties: option a — Step 2: Create a Property](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-step-2-create-a-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=8a767a9fdd91c27fe2147f984d455512) > > * **(A)** Select your **field type** from the dropdown menu. This can be text input, option, dropdown, country, number, date, birthday, etc., then click **Create**. > > ![Contact Properties: option a — Step 2: Create a Property](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-step-2-create-a-option-a-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=b3e7dbfb34c8b24664f13cb80f090a09) > > * **(A)** You can update the **field type** here. > * **(B)** Depending on your selection, fill in the relevant **details** if applicable. > * **(C)** Choose your **default option** - This is either the default placeholder text or a default option based on your field type. ### Step 3: Add the Property to your Card ![Contact Properties: option c — Step 3: Add the Property to your Card](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-step-3-add-the-option-c.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=db10f0ae10e12a35e74b50e6d350ecbf) * Navigate to your **Engagement Hub.** * Go to the card you want to apply the property to. * **(1)** Click on **Data capture.** * **(2)** Then go to **Form.** > [!NOTE] > > Follow the steps in [this article](/competitions-promotions/setup-management/prizes-and-comms) to learn how to set up Data Capture. * **(3)** Add the property by clicking on the **plus icon** on the form. > **Adding Form Elements** > > ![Contact Properties: adding form elements in the card editor](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-adding-form-elements-screenshot.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=54831fcbd1425379ba2d6b1c4b1f889c) > > * **(A)** Here you will find the Contact Property you created in [Step 2](#step-2-create-a-property). Click on any property to continue. > > ![Contact Properties: step 2 — Step 3: Add the Property to your Card](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-step-3-add-the-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=99938afa4eebbf21f735b2a896cc8eee) > > * **(A)** Choose whether you wish for this field to be **required**. > * **(B)** Here you can update the **label name** for the property. > * **(C)** Select what is **presented** on the field - placeholder text or a default option then click **Add**. ### Step 4: View the Property on Contacts ![Contact Properties: option c — Step 4: View the Property on Contacts](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-properties-step-4-view-the-option-c.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=9d6ff4dc3cd6bc999325c8dd467abc9d) * **(1)** Navigate to contacts by clicking on **CRM.** * **(2)** Click on **Contacts** and click on a contact to view their profile. * **(3)** Under the **About this contact** section, you can see the responses to all the contact properties created. ## FAQ **When should I create a contact property?** We recommend creating a property for all the information you will consistently request from your audience as this will save time when creating competitions and allows you to collect the most recent response, updating the contacts profile each time. **Can I delete properties?** You can only delete properties if they have not been added to any cards or have any data associated with it. **I want to include additional options in my already created property, can I update it?** Yes, you can update existing properties under the Properties section. Click on the property, make your changes and then hit save. We highly recommend only making changes if you are adding more options. If you remove or make changes to existing options with data collected, this will not be accurate information stored against your users. # Contact Verification Source: https://knowledge.komo.tech/crm/contacts/contact-verification/index ## What is it? A Contact in Komo is the representation of a customer or your end-user. Contact Verification is a way of verifying that a person is who they say they are so we can keep all customer data secure (our first priority) and provide a smooth experience for returning contacts. ## How does it work? When Contact Verification is turned on, when a user enters their email into a form, we check to see if we have seen it before, in other words, whether a Contact exists with that email yet or not. If a Contact exists, we will make sure that we merge any new information with the existing Contact, help them to prefill form values that they have already provided and slow down any potential spammers by forcing users to verify their email if they change their email. ## When does a user need to verify their email? A user only needs to verify their email if they change it. This increases the amount of effort required for a user to 'spam' a competition and ensures that contact profiles aren’t “dirtied” with invalid information. To retrieve an on-going gameplay in the case of: Live Predictor, Live Trivia, Q\&A & Treasure Hunt. For these games, we will look up the email they entered and if there is an existing and on-going gameplay found we will force the user to verify themselves (if they haven’t already) before giving them access to the existing gameplay. This ensures we never allow people to “hijack” someone's gameplay. If the *sign-in button* is turned on or the *Verify on first submission* is turned on, verification will also be required. ## Why do we automatically merge two Contacts? Automatic merging of Contacts takes place to reflect updates that have been made to Contact details when a user fills out a form multiple times. The key scenario where this takes place is when you have a user fill out a form, only to enter an additional email in a new form within the same session (ie. on the same device and using the same browser). This typically takes place when you have two different people fill out a form on the same device. When this occurs, those two Contacts will be automatically merged and the email that was provided most recently will be reflected in the Contact. It’s important to note that entries will still be reflected as separate entries, however they will share the same Contact email address. ## How do I set it up? * [Step 1: Set up your verification form](#when-does-a-user-need-to-verify-their-emaila-user-only-needs-to-verify-their-email-if-they-change-it-this-increases-the-amount-of-effort-required-for-a-user-to-spam-a-competition-and-ensures-that-contact-profiles-arent-dirtied-with-invalid-informationto-retrieve-an-on-going-gameplay-in-the-case-of-live-predictor-live-trivia-qa-treasure-hunt-for-these-games-we-will-look-up-the-email-they-entered-and-if-there-is-an-existing-and-on-going-gameplay-found-we-will-force-the-user-to-verify-themselves-if-they-havent-already-before-giving-them-access-to-the-existing-gameplay-this-ensures-we-never-allow-people-to-hijack-someones-gameplayif-the-sign-in-button-is-turned-on-or-the-verify-on-first-submission-is-turned-on-verification-will-also-be-required) * [Step 2: Adjust Verification display settings](#what-is-it) * [Step 3: Design Verification Email](#when-does-a-user-need-to-verify-their-emaila-user-only-needs-to-verify-their-email-if-they-change-it-this-increases-the-amount-of-effort-required-for-a-user-to-spam-a-competition-and-ensures-that-contact-profiles-arent-dirtied-with-invalid-informationto-retrieve-an-on-going-gameplay-in-the-case-of-live-predictor-live-trivia-qa-treasure-hunt-for-these-games-we-will-look-up-the-email-they-entered-and-if-there-is-an-existing-and-on-going-gameplay-found-we-will-force-the-user-to-verify-themselves-if-they-havent-already-before-giving-them-access-to-the-existing-gameplay-this-ensures-we-never-allow-people-to-hijack-someones-gameplayif-the-sign-in-button-is-turned-on-or-the-verify-on-first-submission-is-turned-on-verification-will-also-be-required) * [Step 4: Add a Sign-In button (Optional)](#what-is-it) ### Step 1: Access Form Verification Configuration ![Contact Verification: step 3 — Step 1: Access Form Verification Configuration](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-1-access-form-step-3.gif?s=d0b183e9e34b13579dc1bbfe09f18633) * Open your Hub, then go to **Contacts** in the sidebar. * Under the **Form verification** panel, click **Manage forms and emails**. > [!NOTE] > > Form verification lives under **Contacts**, not Hub settings. ### Step 2: Adjust Verification display settings ![Contact Verification: step 2 — Step 2: Adjust Verification display settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-2-adjust-verification-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=1001b1355e1f7942bc49d0c5f28fc6f0) * **(1) + (2)** Click here to edit the **text and CTA colours**. * **(3)** This option is whether you want to show the user **all the form fields upfront**. > [!NOTE] > > If this is disabled, users will enter their email first and then see the rest of the fields once their email has been verified. > \ > Below is an example of when **no settings are enabled.** > > ![Contact Verification: step 2: Adjust Verification display settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-2-adjust-verification-screenshot.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=6558d059e4ffa35755a40a58f91f2fb6) > > Below is an example of when **always show all fields is enabled**. > > ![Contact Verification: step 2: Adjust Verification display settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-2-adjust-verification-screenshot-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=e27dd5563b063072d887594ab8eda86a) * **(4)** The second setting forces all users to **verify their email** the first time they enter. > [!NOTE] > > Below is an example of when **verify on first submission is enabled.** > > ![Contact Verification: step 3 — Step 2: Adjust Verification display settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-2-adjust-verification-step-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=0d21b707e4649acae4d167cbc2262c80) ### **Step 3: Design Verification Email** ![Contact Verification: step 3 — Step 3: Design Verification Email](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-3-design-verification-step-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=d3321f16c231388efd2392696077e878) * **(1)** Navigate to the **Email** tab. * **(2)** You can configure and design the email sent to the user with their verification code. [Learn more about email communications here.](/competitions-promotions/setup-management/prizes-and-comms#step-3-set-up-your-prize-communications) > [!TIP] > > **We highly recommend setting up a custom sender-domain for your email verification email, e.g. “[no-reply@mybigbusiness.com.au](mailto:no-reply@mybigbusiness.com.au)”.** > [You can see how to set up a custom sender email here.](/getting-started/hub-setup/custom-email-sender-names) > [!NOTE] > > Below is an example of when users **update or change their email from an existing entry.** > > ![Contact Verification: step 4 — Step 3: Design Verification Email](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-3-design-verification-step-4.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=95b320f69bc233b6a97f7883dcb7df50) ### Step 4: Add a Sign-In button (Optional) ![Contact Verification: step 4 — Step 4: Add a Sign-In button (Optional)](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-4-add-a-step-4.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=b749f35862faf1c4e88f6dc32dbc7d0c) * **(1)** Head to the **Sign in** tab. * **(2) Enable** the feature for the **sign in button** to appear on your Hub. > [!NOTE] > > The sign-in button will help the contact verify with the hub outside of a form, which means they can see any previously [**earned badges**](/interactive-features/features/badges-and-workflows) or [**configured profiles**](/crm/contacts) on the site.\\ > > ![Contact Verification: step 4: Add a Sign-In button (Optional)](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contact-verification-step-4-add-a-screenshot.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=66d6cbcd5b9afcf70a2f969a43c37925) * **(3) + (4)** Update the message on the sign-in form. * **(5) + (6)** Click here to edit the **text and CTA colours.** # Creating Contact Lists with Filters Source: https://knowledge.komo.tech/crm/contacts/creating-contact-lists-with-filters/index Filter CRM contacts, then bulk-add them to a static list. Build a list from a filtered contact set — or automate membership with workflows. ## Create a list from filters 1. Create a **static** list under **CRM** → **Lists** (if you do not already have one) 2. **CRM** → **Contacts** — apply filters (hubs visited, subscription groups, contact properties such as achievements, and other available fields) 3. Select the filtered contacts 4. Use the bulk **Add selected contacts to list** action (row action label: **Add To List**) 5. In the **Add To List** modal, choose **List name** and confirm Only selected contacts that are not already in the list are added. > [!TIP] > > You can also open a list under **CRM** → **Lists**, then use that list’s bulk-add flow to pick contacts. ## Automate with Workflows (optional) Use the **Add to List** workflow action to add contacts when triggers fire (e.g. data captured, badge awarded). Full setup: [Workflows for Contact Lists](/integrations-automation/workflows/tips/workflows-for-contact-lists). ## Send a marketing email to a list Open the list under **CRM** → **Lists**, go to the **Communications** tab and click **Create email**. Before the email goes out, the send confirmation shows how many members will receive it and how many will be skipped (missing an email, not subscribed, or unsubscribed). See [Check your audience before sending](/crm/communications/communication-subscriptions#check-your-audience-before-sending-a-marketing-email-to-a-list). ## Related * [Contacts](/crm/contacts) * [Workflows for Contact Lists](/integrations-automation/workflows/tips/workflows-for-contact-lists) * [Workflows actions](/integrations-automation/workflows/actions) * [Communication Subscriptions](/crm/communications/communication-subscriptions) # Edit Entrant Details and Resend Communications Source: https://knowledge.komo.tech/crm/contacts/edit-entrant-details-and-resend-communications/index Want to know how to edit a user's details if they have incorrectly filled out the data capture form and how to resend communications? Read on... ## What is it? If a user has incorrectly filled out a Data capture form for a competition, you have the ability to edit and update an entrant's details. Once you have updated an entrant's details, you are able to resend any communications associated with the entry to the updated information. ## How do I do this? * [Step 1: Select the relevant competition card](#step-1-select-the-relevant-competition-card) * [Step 2: Edit an entrant's details](#step-2-edit-an-entrants-details) * [Step 3: Resend communications](#step-3-resend-communications) ### Step 1: Select the relevant competition card ![Edit Entrant Details and Resend Communications: step 2 — Step 1: Select the relevant competition card](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/edit-entrant-details-and-resend-communications-step-1-select-the-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=c1ee337b0e8075b25d8b02e1907bf765) * Head to your Engagement Hub and then the card you wish to edit a user's details. * Click on the **Settings** cog. * **(1)** Select **Entries** (this is occasionally listed under the **Data Capture** dropdown). ### Step 2: Edit an entrant's details ![Edit Entrant Details and Resend Communications: step 2 — Step 2: Edit an entrant's details](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/edit-entrant-details-and-resend-communications-step-2-edit-an-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=9de529de7724f75b7907f8a4481f6792) * Find the **entrant** with the incorrect details. * **(1)** Click the **...** icon next to the entry. * **(2)** Select **Edit data** to update the user's information. > **Update User's Information** > > ![Edit Entrant Details and Resend Communications: option a — Step 2: Edit an entrant's details](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/edit-entrant-details-and-resend-communications-step-2-edit-an-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=80a0ce202081958ffc90030d1c05a965) > > > [!NOTE] > > > > The information you can edit here will correspond to your Data capture form. > > * **(A)** Here you can edit an entrant's **email**. > * **(B)** Here you can edit an entrant's **first name**. > * **(C)** You can edit an entrant's **last name**. > * **(D)** Here you can edit an entrant's **mobile**. > * **(E)** You can adjust any **opt-ins**. > * **(F)** Click **Update.** You will then get a pop-up requesting to view and resend any associated communications to this user. > > ![Edit Entrant Details and Resend Communications: option b — Step 2: Edit an entrant's details](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/edit-entrant-details-and-resend-communications-step-2-edit-an-option-b.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=bc93c6840256b8762611c0499ceb41c5) > > * **(a)** Select **Review communications** > > ![Edit Entrant Details and Resend Communications: option d — Step 2: Edit an entrant's details](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/edit-entrant-details-and-resend-communications-step-2-edit-an-option-d.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=f592d56fe2b5f7a32c27fea1b7753db3) > > * **(I) Select the communication** you wish to resend. > * **(II)** Click **Resend.** ### Step 3: Resend communications ![Edit Entrant Details and Resend Communications: step 3 — Step 3: Resend communications](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/edit-entrant-details-and-resend-communications-step-3-resend-communications-step.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=492518a761a1bb59b534a3e9bfbfba57) * If you wish to just **resend communications** to an entrant, * **(1)** Click on the **...** icon next to the entry. * **(2)** Select **Resend communications.** > **Resending Communications** > > ![Edit Entrant Details and Resend Communications: option a — Step 3: Resend communications](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/edit-entrant-details-and-resend-communications-step-3-resend-communications-opti.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=1bf66b2531fe220d5746432af8f58162) > > * You can select the **communications** that are associated with the entry. > * **(A)** Select the **communication** you wish to resend then click **(B) Resend.** ## FAQ What details can I edit in this process? It is possible to edit all user inputs that were presented to them at the time of data capture. Examples of inputs include but are not limited to: First name, last name, mobile number, email address, etc. **If I update an entrant's details, will this impact my excel export?** Yes, when you change an entrant's information, it will update in the card and in the CSV file when you export all the data for the competition. **Can I send more than one type of communication to the user?** You can only re-send communications that have been previously sent to this user. **Can I do this for all competitions?** You can do this with any competition that has a Data capture form attached. However, you are unable to change any entrant details for the Live Trivia Card. # Contacts Source: https://knowledge.komo.tech/crm/contacts/index Learn how to collect and store rich customer data within the Komo Engagement Engine! ## What is it? Use our Contacts feature to store the rich zero and first-party data you collect using the Komo Engagement Engine! Contacts will allow you to view and gain knowledge from various contact properties like achievements ([**Badges**](/interactive-features/features/badges-and-workflows)), contact type, the creation date of the contact, as well as your own unique properties collected via data capture. These are the rich insights that will allow you to personalize your content and *truly* connect with your customers. The Komo Engagement Engine is fully integrated, allowing you to seamlessly share your customer data captured via Komo with your external CRM, or you can choose to manage all of your data directly within the Komo ecosystem. Contacts also support our Badges and Profiles features, allowing you to assign achievements to users based on their activity within your Engagement Hub and enabling users to identify themselves with an avatar while they engage with the games across your Engagement Hub. Learn more about setting up Badges and Profiles [**here**](/interactive-features/features/badges-and-workflows). ## How do I use it? ### Step 1: Using the Contacts features ![Contacts: step 1 — Step 1: Using the Contacts features](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-1-using-the-step-1.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=200368f881dcb6281faca03db1a00015) * **(1)** Navigate to the **CRM** tab. * **(2)** Click **Contacts** to view the full list of user data collected across your Engagement Hubs. * **(3)** Here you can **search** for users by name, mobile or email. * **(4)** The **columns** button will allow you to mark certain properties you wish for the contacts table to show to improve the visibility of the information. ![Contacts: option a — Step 1: Using the Contacts features](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-1-using-the-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=0b3f718cdfe0673312c6d4d19621d851) * **(A)** The list of column items includes all **contact properties** created. Disable and enable any information you wish to display on the contacts table. * **(5)** The **filter option** allows you to further segment and filter the contacts table. You can filter the table by Engagement Hubs visited, subscription groups, contact properties and more! * **(6)** If any columns are altered and filters applied, the table will update accordingly. These fields show the **first-party data** collected from your Contacts. * **(7)** This column shows the **contact type**. > [!NOTE] > > Contact type definitions are as follows: > > * **Anonymous:** Any user who has visited your Engagement Hub but has no identifying information. > * **Identified:** Any user who has visited your Engagement Hub and has provided some identifying information via a data capture form. > * **Authenticated:** Any user who has created an account within your Engagement Hub, and has provided all the necessary data to do so. ### Step 2: Viewing Contact profiles ![Contacts: step 2 — Step 2: Viewing Contact profiles](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-2-viewing-contact-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=ccc973b88a080a8db6d7e452ce69e344) * **(1)** Under the **About this contact section** is all the first-party data collected from competitions and responses to the contact properties you've created. > [!NOTE] > > You have the ability to view history of each contact property, edit any existing data collected and update any blank properties with details if known. * **(2)** Here displays information on when the contact was **created**, the **last updated** information under the about this contact section and the **latest competition entry**. * **(3)** View all the **competitions** this contact has entered, where (Engagement Hub) and when. ![Contacts: option a — Step 2: Viewing Contact profiles](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-2-viewing-contact-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=19c210b5437e7c4b67e0f8441c7be51f) * Clicking on the **...** next to the entry, you can view additional actions. * **(A)** Directly **go to the card**. * **(B)** View the contact **entry submission** for that competition. * **(4)** The **list memberships** shows which list the contact is apart of. * **(5)** The **subscriptions** display the communication and subscription group the contact has opted-in to. * **(6)** Scrolling down, you can see the full list of **communications** the contact has received. ![Contacts: option b — Step 2: Viewing Contact profiles](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-2-viewing-contact-option-b.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=07e77a35306de46e9d31c60d2e1a7bc3) * Clicking on the **...** you can access additional actions. * **(A)** Here you can **resend** the specific communication sent to the contact. * **(B)** This allows you to see **the timeline** of the communication from where it was sent from (card and Engagement Hub), when it was sent, delivered and the communication body content. * **(7)** Here you can view all the **prizes** this contact has received. * **(8)** The **coupons earned** section shows all the coupons the contact has received, the status of the coupon (redeemed and redeemable), when the coupon was redeemed and the redemption location (if applicable). ### Step 3: Import a list of Contacts ![Contacts: step 3 — Step 3: Import a list of Contacts](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-3-import-a-step-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=b36fc2ee3f080bc9593d1f27d0655432) * **(1)** Click on the **+ plus icon** to add contacts. * **(2)** Here you can manually **create a contact**. ![Contacts: option a — Step 3: Import a list of Contacts](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-3-import-a-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=1af321970424692f6cd6310bc761eb9f) * **(A)** Input the contact's **email address**. * **(B)** Enter the contact's **first name**. * **(C)** Enter the contact's **last name**. * **(D)** Then include the contact's **mobile**. * **(3)** Click **Import from CSV** to bulk upload contacts. ![Contacts: option b — Step 3: Import a list of Contacts](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-3-import-a-option-b.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=5547d60322422f470484ed91c994ea6b) * **(A)** Upload your **CSV, XLSX, or XLS file** here. * **(B)** Here you have the option to add your imported contacts to one of your **lists**. See [Creating Contact Lists with Filters](/crm/contacts/creating-contact-lists-with-filters). ### Step 4: Export a Contact list ![Contacts: option a — Step 4: Export a Contact list](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-4-export-a-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=2edeb3f105bb05c1007d8dceb38eef82) * **(1)** The **export** button will allow you to export your contacts as a .CSV file. This can be used to upload contacts to your external CRM! * **(2)** You can export the **full contact list** and columns applied. * **(3)** This option will export the contact list and **adhere to any filters or columns** set from Step 1 (4) + (5) which will appear in your inbox. ### Step 5: Delete a Contact ![Contacts: step 1 — Step 5: Delete a Contact](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-5-delete-a-step-1.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=e55a9344fc4663a5db62e27db39dd1e8) * **(1)** Select the **checkbox** next to the contact you wish to delete. * **(2)** Click the **three dots** next to the selected contact. * **(3)** Click **Delete**. ![Contacts: option a — Step 5: Delete a Contact](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-step-5-delete-a-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=fe213476a627f72a445f086203ade082) * **(A)** Type the word **Delete** into the text box. * **(B)** Click the **Delete** button to confirm the contact deletion. > [!NOTE] > > It is important to read the warning message prior to proceeding with contact deletion. Once a contact is deleted, it **cannot be undone**. ## FAQ **What is a contact?** A Contact in the Komo Engagement Engine is the representation of a customer or your end-user. **What is a unique contact?** A unique contact is identified by a user's email address. If a user has entered multiple competitions using a singular email, they will be classified as one unique contact. **A user detail is incorrect, can I update their profile in the Komo Engagement Engine?** Yes, you can. If you go to the contact and to the section you need to update on the contact profile e.g. mobile, hover over the field and then click on the pencil icon to edit and update. ![Contacts: fAQ](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/contacts-faq-screenshot.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=35f130c7c605f1f6d880a44d20574198) **If I delete a contact by mistake, can it be restored?** No, once a contact is deleted, it cannot be undone. It is important to proceed with caution when deleting contacts. **Will my analytics be affected if I delete a contact?** When a contact is deleted, the Komo Engagement Engine creates a tombstone. This means that while all PII (Personally Identifiable Information) is removed from the database, a record of that contact is retained but replaced with placeholder information ie. 56shdu475ihr. This ensures that your analytics remain unaffected and all PII is redacted. ## Data quality > **Why are some emails in my CRM shown as `****` or similar junk?** > > Values like `****`, `xxxx@xxxx.com`, or repeated single characters are the **literal input** an end user typed into the form. Komo does not mask email addresses in the CRM — what you see is what was submitted. > > This is almost always spam, bot traffic, or a user trying to bypass a required-field validation. To keep these out of your contact list: > > * Add a workspace-level [entry rule](/interactive-features/features/entry-rules) that disqualifies entries where **Email contains `*`**. Use the **contains** operator, not equals. > * Enable [Cloudflare Turnstile](/account-settings/settings/cloudflare-turnstile) on your form for automated bot detection. > * Filter the Contacts table by the same condition (email contains `*`) and bulk-delete existing junk records. > > Note that entry rules disqualify entries *after* submission — the entrant will still see the confirmation screen, but the entry is marked Disqualified and does not fire qualified-only workflows. > **Some emails are missing from my contact export** > > If specific contacts show as blank in an export but have entries in the platform, contact [support@komo.tech](mailto:support@komo.tech) with a couple of example contact IDs. The team can restore the affected records so the missing email addresses appear on your next export. > **Where does the "source" of a contact come from?** > > Komo does not have a built-in **Source** property on contacts. If you need to track which campaign, integration, or import produced a given contact: > > * Create a custom [contact property](/crm/contacts/contact-properties/index) called `source` (or similar). > * Populate it from the Contact Sync API or a Workflow when contacts are created via an integration. > * For manual imports, set the property as a column in the CSV. > > The `entries` history on a contact profile already tells you which cards a contact engaged with, which is often enough for attribution without a dedicated source property. # Loyalty Source: https://knowledge.komo.tech/crm/contacts/loyalty/index Create and manage engagement-first loyalty programs with automated workflows to reward, tier, and engage your contacts directly within Komo. ## What is it? Using Komo Loyalty, you can build complete loyalty programs with points, tiers, and campaigns, then automate how users earn, redeem, and progress based on their engagement within the Komo Engagement Engine. Read on to learn how to set yours up. ## How do I do it? ### Step 1: Create your loyalty program ![Loyalty: step 1 — Step 1: Create your loyalty program](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/loyalty-step-1-create-your-step-1.gif?s=d859f3a50dae3342589864ca881e0d15) * Navigate to your **Workspace** and click **Loyalty** in the left-hand menu. * Click the **+ Create Loyalty Program** button. * Give your loyalty program an appropriate **name** and **description** (the name will be visible to end users within their profile, however, the description is internal only). * If you would like your Loyalty program to have points, ensure you tick the **Has points** checkbox. > [!NOTE] > > If **Has points** is deselected, you will still be able to award and manage user points, however the points balance will not be visible to end users. * Click **Create**. * Your loyalty program has now been created! ### Step 2: Set up your campaigns (optional) ![Loyalty: step 2 — Step 2: Set up your campaigns (optional)](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/loyalty-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=f5bac78907a44e04b0080f96e6192d9c) > [!NOTE] > > When you create your loyalty program, a master campaign will be set up by default (you will see this campaign as soon as your program is created). You have the ability to set up additional campaigns and run multiple under one program if you desire. This is particularly useful if you would like to run specific loyalty campaigns for different segments or seasonal campaigns. Points are always stored at the program level. However, any points earned through individual campaigns will contribute to the overall program points balance. * **(1)** If you would like to set up an additional campaign, click **+ Create campaign**. * **(2)** Give your campaign an appropriate **name** (this name is internal only). * **(3)** Here you can set how points expire after they are rewarded. The three options are: * **No expiry** - Points awarded to users will not expire. * **Relative Date** - Here you can set the points awarded to expire within a set timeframe relative to the awarded date. * **Fixed Date** - Here you can set the points awarded to expire at a fixed date, regardless of when they were awarded. * **(4)** Once you're happy with your settings, click **Create**. * You'll now see that your campaign has been created. ### Step 3: Set up your loyalty tiers (optional) ![Loyalty: step 3 — Step 3: Set up your loyalty tiers (optional)](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/loyalty-step-3-set-up-step-3.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=cc4f83cd270ecb2749775cce1e9d307c) * You have the ability to add as many tiers as required to your loyalty programs. * **(1)** Click **+ Create tier**. * **(2)** Give your tier an appropriate **name** (this name will be visible to users in their profile). * **(3)** Give your tier an appropriate **description** (this is internal only). * **(4)** Give your tier a **rank** relative to its position in your desired loyalty tiers. > [!NOTE] > > The highest ranked tier will be that with the lowest number (i.e. 1). If contacts sit in multiple tiers, they will only ever be shown the highest ranked tier that they are a member of. * **(5)** Input the **points threshold** users will need to meet to be included in the tier. * **(6)** Here you can **check the box** to ensure that users are automatically **removed from other tiers** when they move into this tier. * **(7)** Here you can give your tier an appropriate **color**. This will be visible both internally and publicly when viewing the various tiers. * **(8)** Click **Create**. > **Note:** > > ![Loyalty: option a — Step 3: Set up your loyalty tiers (optional)](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/loyalty-step-3-set-up-option-a.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=cdafe79babc112a62c58337ca4eeecd7) > > **(A)** Once you have clicked Create, you also have the ability to add an image to the tier banner by clicking the **add image** button. * Your tier has now been created! Repeat **(1)-(8**) for each tier you need to create. ### Step 4: Publish your loyalty program ![Loyalty: step 4 — Step 4: Publish your loyalty program](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/loyalty-step-4-publish-your-step-4.gif?s=57ea4b7cb02e316ac4a1716c1e930a2b) * You'll now need to publish your loyalty program. * Click the **three dots** next to each of your campaigns and click **Publish**, followed by **Yes, Publish**. * Click the **three dots** next to each of your tiers and click **Publish**, followed by **Yes, Publish**. * Click **Loyalty** in the left-hand menu. * Click the **three dots** next to your loyalty program and select **Publish**, followed by **Yes, Publish**. * Your loyalty program is now live! You'll now need to enable Loyalty in the contacts' profile to make the program visible to them. ### Step 5: Enable loyalty in contact profiles ![Loyalty: step 5 — Step 5: Enable loyalty in contact profiles](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/loyalty-step-5-enable-loyalty-step-5.gif?s=bb96305b920a90efc9425e7462c6a72f) > [!NOTE] > > While loyalty programs are set up at the workspace level, users can view their status at the hub level. For this reason, you will need to enable loyalty in contact profiles at the hub level. * Navigate to your desired hub by selecting **Hubs** in the left-hand menu and then choosing the relevant **Hub** you would like to enable loyalty for. * Once inside the hub, click **Contacts** in the left-hand menu. * **Toggle on** the **Loyalty** toggle. * Click **Select a program** and choose the appropriate program from the **Loyalty program** dropdown. A hub uses **one** loyalty program. Profile, form redemption, and site leaderboards all use this program. Choosing a different program on a site leaderboard updates the hub's program. * If you click on the **Profile Drawer** tab in the left-hand menu you will now see that Loyalty has been enabled for contact profiles and are presented with a preview of what users will see. * **Exit** the modal. ### Step 6: Awarding loyalty points * To award points within your loyalty program, you will need to set up workflows. Points can be awarded based on a number of triggers, but for simplicity, this example will walk you through how to award loyalty points when a user has completed a data capture form. > [!NOTE] > > Workflows for awarding loyalty points can be created at the workspace or hub level and it is recommended that you use whichever method makes the most sense for the context of your workflow. Because this example is awarding points for interacting with a single card, the workflow has been set up at the hub level. * Navigate to **Workflows** which can be found under Automations in the left-hand menu. * Click **+ Create workflow**. * Within the **Card** dropdown, set the **card you would like your workflow to award points** off the back of. * Give your workflow an appropriate **internal name** and click **Create**. * Click the **pencil icon** to **edit** the trigger module. * Under **Execute flow on**, select the **trigger** that will initiate the points awarding. In this instance we have chosen data captured on the Secret Code Card. * Click **Save** and **exit** the modal. * Drag and drop the **Award Points** module below the trigger module. * Connect the **Output node** of the Trigger module to the **Input node** of the Award Points module. * Click the **pencil icon** to edit the **Award Points** module. * From the dropdown select the appropriate **Loyalty program** the points should be awarded towards. * Input the **number of points** you would like to be awarded. > [!NOTE] > > In the example that you are awarding points off the back of a receipt validation you have the ability to set the points awarded to be a multiple of the amount spent using the `{{event.total_amount | times: 100}}` token where `100` can be replaced with your desired multiple. * Click **Save** and **exit** the modal. * Click **Save** in the top right-hand corner and **exit** the workflow editor. * Click the **three dots** next to the workflow you just set up and select **Run**, followed by **Yes, start it**. * You can now test the workflow by accessing the Engagement Hub and card you set the workflow on, clicking **Visit single card** and proceeding to play through the game. * Once finished, access your profile by clicking your **initial** or **avatar** in the top right-hand corner and you should see the **loyalty points** have been awarded and the appropriate tier displayed. > [!NOTE] > > If the points or tier do not show immediately, try refreshing your page. If the tier still does not show, check that enough points have been awarded to trigger the threshold for movement to the appropriate tier. ### Step 7: Redeeming loyalty points through data capture ![Loyalty: step 7 — Step 7: Redeeming loyalty points through data capture](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/loyalty-step-7-redeeming-loyalty-step-7.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=428e504cb40753590bc022e711b40f02) > [!NOTE] > > When creating offers for users to redeem points, we recommend using a separate card to the card used for awarding points (i.e. do not connect a point awarding flow and point redemption flow to the same card). * You have the ability to allow users to redeem points in order to access cards and games. This can be set on any card where you have a data capture form set up. * **(1)** Within the card you would like to add points redemption to, click on the **Form** tab under the Data Capture dropdown. * **(2)** Toggle on the **Redeem points on submission** toggle. * **(3)** The **pencil icon** edits the hub's loyalty program (one program per hub). Changing it here updates the hub — it does not attach a different program to this form only. * **(4)** Here you can type in how many **points** should be redeemed and deducted from the contact's points balance. * You have now set up point redemption via data capture! In this instance, the redeem points will act as a gate for card access and the points will automatically be deducted from the contact's loyalty points balance. If they don't have enough points, they will not be able to submit the form. ### Step 8: Redeeming loyalty points through workflows > [!NOTE] > > When creating offers for users to redeem points, we recommend using a separate card to the card used for awarding points (i.e. do not connect a point awarding flow and point redemption flow to the same card). * In the event that you require more flexibility around points redemption and have specific criteria or advanced logic that can't be covered by the form level points redemption, you are able to create a dedicated workflow. This can be set at the workspace or hub level depending on your use case. For the purpose of this example, we will set the workflow at the hub level. * Start by navigating to **Workflows** under the Automations tab. * Click **+ Create workflow**. * Within the **Card** dropdown, set the **card you would like your workflow to redeem points** off the back of. * Give your workflow an appropriate **internal name** and click **Create**. * Click the **pencil icon** to **edit** the trigger module. * Under **Execute flow on**, select the **trigger** that will initiate the points redemption. In this instance we have chosen data captured. * Click **Save** and **exit** the modal. * Drag and drop the **Redeem Points** module below the trigger module. * Connect the **Output node** of the Trigger module to the **Input node** of the Redeem Points module. * Click the **pencil icon** to edit the **Redeem Points** module. * From the dropdown select the appropriate **Loyalty program** the points should be redeemed from. * Input the **number of points** you would like to redeem. * Click **Save** and **exit** the modal. * Click **Save** in the top right-hand corner and **exit** the workflow editor. * Click the **three dots** next to the workflow you just set up and select **Run**, followed by **Yes, start it**. * Your points redemption workflow is now running! ## FAQ **Why would I use a campaign within my loyalty program?** Within your overall loyalty program, setting up a campaign can be an effective way to run shorter loyalty offerings or experiences. You may use campaigns to set up seasonal loyalty programs under the banner of your master loyalty program or even offer 'double points' periods. This is entirely up to you and dependent on your use case! **The points awarding and redemption examples shared in this article are basic in nature. I have more complex requirements. Can Komo Loyalty support this?** Komo Loyalty has been built around the Komo Engagement Engine's robust workflow engine to ensure that you have the greatest flexibility when building out your Loyalty programs. If you have advanced logic or complex workflows, these can absolutely be set up via the workflows tool. **How can contacts make use of their points?** This is entirely up to you. Whether you want to use points as a mechanism to gate content, offer sweepstakes or redeem prizes, this is entirely possible with Loyalty Builder. **Can a hub or site leaderboard use more than one loyalty program?** No. A hub has one loyalty program. Site leaderboards use that same program. Choosing a program on a leaderboard updates the hub's program; it does not give that leaderboard a different program. # Braze Contact Sync Source: https://knowledge.komo.tech/crm/syncs/braze-contact-sync/index Sync first- and zero-party data captured through Komo to Braze in real time using workflows. ## What is it? The Braze integration lets you gather first- and zero-party data through Komo and push it into Braze in real time. Data collected from data capture forms and interactive content (polls, quizzes, personality tests, swipers, and more) is sent to Braze via the `/users/track/` API, so you can progressively build richer user profiles as contacts continue to engage with your Hub. Use this integration to: * Ingest first- and zero-party user data captured in Komo into Braze in real time. * Ingest market research and preference data when users answer surveys, polls, and quiz questions. * Progressively build user profiles in Braze as contacts continue to engage and share more data about themselves. * Standardise the look and feel of transactional emails sent through Braze. ## Prerequisites Before setting up the integration, make sure you have: | Requirement | Description | | - | - | | **Komo account** | An active Komo account with permission to manage Connected Apps and Workflows. | | **Braze REST API key** | A Braze REST API key with `users.track` permissions. This can be created in the Braze dashboard from **Settings** > **API Keys**. | | **Braze REST endpoint** | [Your REST endpoint URL](https://www.braze.com/docs/api/basics/#endpoints) — for example, `https://rest.iad-03.braze.com`. Your endpoint depends on the Braze instance your workspace is provisioned on. | ## Use cases When a user submits a data capture form in Komo, the fields mapped in the Braze integration are passed to Braze via the `/users/track/` API call. Data capture forms typically appear at the start or end of a Card. Komo can also pass through market research data captured when a user answers a quiz question, poll, personality test, swiper, and similar content — allowing you to enhance a user's Braze profile beyond what's collected in form submissions. ## How do I set it up? ### Step 1: Publish a Komo Engagement Hub and Card Publish a Komo Hub with at least one Card that contains a data capture form. Once published, you'll be able to test the user experience end-to-end and verify that data is flowing through to Braze. ![Braze integration: step 1 — publish an Engagement Hub and Card with a data capture form](https://mintcdn.com/komotechnologies/iLMTe6YN2jOfc6b1/images/braze-step-1-publish-hub.png?fit=max\&auto=format\&n=iLMTe6YN2jOfc6b1\&q=85\&s=f6c88e2e649905eb81eb997b536a1aad) For guidance on building your first Hub and adding a data capture form, see: * [Building Your First Hub](/getting-started/hub-setup/hub-settings) * [Data Capture](/getting-started/hub-setup/data-capture) ### Step 2: Add the Braze Connected App Connect Braze to your Komo workspace via Connected Apps. * Navigate to **Company Settings** by clicking the **Workspace initials** in the top right corner and clicking **Company Settings**. * Click **Connected Apps** in the left-hand menu. * Find the **Braze** integration in the list and click **Connect**. ![Braze integration: step 2a — locate Braze in the Connected Apps list and click Connect](https://mintcdn.com/komotechnologies/iLMTe6YN2jOfc6b1/images/braze-step-2a-connected-apps.png?fit=max\&auto=format\&n=iLMTe6YN2jOfc6b1\&q=85\&s=96dedd5f6b0cb7cfd27d30dddd0bd052) * Enter your **Braze REST API key** and **REST endpoint URL** from the prerequisites. * Click **Connect** to save. ![Braze integration: step 2b — enter your Braze REST API key and endpoint URL](https://mintcdn.com/komotechnologies/iLMTe6YN2jOfc6b1/images/braze-step-2b-connect-braze.png?fit=max\&auto=format\&n=iLMTe6YN2jOfc6b1\&q=85\&s=b7331c87e3f0c334f15b2bd636b4cc91) Your Braze account is now connected to Komo and ready to use inside Workflows. ### Step 3: Configure the integration via a Workflow To start syncing data, create a Workflow that includes the Braze **Track User** action. Workflows can live at the **Workspace**, **Site (Hub)**, or **Card** level — the right scope depends on how broadly you want the workflow to trigger. * **Workspace-level** workflows trigger across every Hub and Card in the workspace. * **Hub-level** workflows trigger across the Cards in a single Hub. * **Card-level** workflows only trigger for that one Card. For a full overview of the Workflow builder, see [Workflows](/integrations-automation/workflows). Once you've created a Workflow: * Define a **trigger** (for example, **Data captured**). * Add any **filters** you need (for example, only run when the **Email consent subscription** is Active). * Search for **Braze** in the step menu and add the **Track User** step. ![Braze integration: step 3a — add the Braze Track User step to your workflow](https://mintcdn.com/komotechnologies/iLMTe6YN2jOfc6b1/images/braze-step-3a-track-user.png?fit=max\&auto=format\&n=iLMTe6YN2jOfc6b1\&q=85\&s=75fe2889b0a5674c1bc7b4486c7be4a6) Configure the events, attributes, and subscriptions you want to sync from Komo to Braze. Map each Komo field to the corresponding Braze user attribute or event property. ![Braze integration: step 3b — configure the events, attributes, and subscriptions to sync to Braze](https://mintcdn.com/komotechnologies/iLMTe6YN2jOfc6b1/images/braze-step-3b-configure-events.png?fit=max\&auto=format\&n=iLMTe6YN2jOfc6b1\&q=85\&s=7bf36d6d374dcd53e6739080056f17b7) Save the Workflow and switch it to **Running** to start syncing data. ## Using the integration With your Workflow live, every matching event in Komo will trigger a call to Braze. You can monitor each execution — including request and response payloads — from the **Workflow Runs** tab. For more detail on interpreting runs, see [Workflow Runs](/integrations-automation/workflows/workflow-runs). ## FAQ **Which Braze actions can I use in a Workflow?** The Braze **Track User** action is available today. It sends user attributes, events, and subscription updates to Braze via the `/users/track/` endpoint. **Is this a two-way sync?** No. The Braze integration is a one-way sync (push) from Komo to Braze. Updates made directly in Braze aren't pulled back into Komo. **When does the workflow run?** Workflows run in real time as soon as their trigger conditions are met — for example, immediately after a user submits a data capture form. **How many Braze workflows can I create?** You can create as many workflows as you need across your Workspace, Hubs, and Cards. **Do I need a separate Braze API key per workspace?** Each Komo Workspace stores its own Braze credentials in **Connected Apps**. If you manage multiple Braze instances (for example, staging and production), connect the correct API key and REST endpoint for the workspace you're working in. # Mailchimp Contact Sync Source: https://knowledge.komo.tech/crm/syncs/mailchimp-contact-sync/index Create an automated data sync to push and sync contacts from Komo to your Mailchimp CRM. ## What is it? Using workflows, you can remove the hassle from ensuring contact lists are synced between the Komo Engagement Engine and Mailchimp by automating the addition and removal of contacts when your pre-determined conditions are met. Read on to discover how to build out a workflow for yourself. ## How do I do it? ### Step 1: Connect the Mailchimp Connected App ![Mailchimp Contact Sync: step 1 — Step 1: Connect the Mailchimp Connected App](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/mailchimp-contact-sync-step-1-connect-the-step-1.gif?s=a0d79c5e66c6fca4bbd99d9f27c5226e) > [!NOTE] > > Prior to connecting Mailchimp to the Komo Engagement Engine, you will need to have a Mailchimp account created. For more information on setting up a Mailchimp account, read [this article](https://mailchimp.com/help/create-an-account/). * Navigate to **Company Settings** by clicking the **Workspace initials** in the top right corner and clicking **Company Settings**. * Click **Connected Apps** in the left-hand menu. * Select **Connect** next to the Mailchimp Connected App. * Click **Sign in** and continue to **log in** to Mailchimp using your Mailchimp credentials. * Click **Allow** to authorize the connection. * Your Mailchimp account has now been connected to the Komo Engagement Engine! ### Step 2: Build your workflow ![Mailchimp Contact Sync: step 2 — Step 2: Build your workflow](https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/mailchimp-contact-sync-step-2-build-your-step-2.webp?fit=max\&auto=format\&n=gslKLBOHswpMZg4u\&q=85\&s=933ecb05580f69f72be7f07c107d0105) * Workflows can be accessed at the workspace, hub and card level. This article will cover creating the Mailchimp workflow from the card level. The process is the same if creating at the workspace or hub level, although you will need to access workflows within the lefthand toolbar within the workspace or hub view. For more information on creating workflows at the workspace level, [read this article.](/integrations-automation/workflows/tips/workflows-for-contact-lists) > [!NOTE] > > Before setting up a workflow, you will need to ensure there is a data capture set up with your desired contact property fields and necessary consent fields added. For more information on adding data capture forms, [read this article](/getting-started/hub-setup/data-capture). For more information on adding consent fields, read [this article](/crm/communications/communication-subscriptions). * **Navigate** to your Engagement Hub and **access** the card containing the data capture form you would like to sync your contacts from. * **(1)** Click **Definitions** under the Workflows dropdown. * **(2)** Select **+ Create Workflow**. * **(3)** Give your workflow a meaningful **Name**. > [!NOTE] > > This is internal only but we recommend that the naming aligns with the workflow for clarity. * **(4)** Click **Create**. * You can now start building out your workflow. * Select the **pencil icon** next to Trigger. * Select the event that will trigger your workflow from the **Execute flow on** dropdown. In this case, we will select **Data captured**. * Click **Save** and then select the **X** to exit the modal. * Drag the **Filter** module and drop it below the **Trigger module**. * Click on the **Output node** at the bottom of the **Trigger module, drag** and **drop** on the **Input node** of the **Filter module**. * Select the **pencil icon** at the top of the **Filter module**. * Set the **Filter conditions** that must be met for the action to take place. In this case we will set the workflow to only run when the **Email consent subscription** is **Active**. * Click **Save** and then exit the modal by clicking **X**. * Drag the desired **Mailchimp action module** and drop it below the **Filter module**. In this instance we are using **Add/Update Member**, however this will depend entirely on your use case. * Click on the **Success Output node** at the bottom of the **Filter module, drag** and **drop** on the **Input node** of the **Action module (Add/Update Member)**. * Click the **Pencil icon** at the top of the **Action module**. * Select the **Mailchimp audience** you would like the contact to be added to and proceed to map the **contact properties** you are collecting to the appropriate **Mailchimp audience fields** (you can copy and paste the merge fields from the right-hand column to the relevant fields). > [!NOTE] > > For more information on creating audiences in Mailchimp, read [this article](https://mailchimp.com/help/create-audience/). * Click **Save** and then exit the modal by clicking **X**. * Finish building your workflow by clicking **Save** in the top right-hand corner. * You will now see that your workflow has been created. * For your workflow to start running, you will need to **click the 3 dots** next to the workflow and select **Run**, followed by **Yes, start it**. * Your workflow is now running! ### Step 3: Test your workflow * To test the workflow, **exit** the **Card settings**, click the **3 dots** at the top righthand corner of the card and select **Visit single card**. * Proceed to interact with the card and **fill out the data capture form** ensuring that the **consent field** checkboxes are ticked. * Once you have filled out the data capture form, you can exit the card by clicking the **X**. * Navigate back to your **Engagement Hub**, access the **Card settings** and select **Usage** under the Workflows dropdown. * Here you should see a **Success** tag under the status field for the **contact details** you just entered. This indicates that the workflow was successfully executed. * You can now confirm that the contact has been successfully added to Mailchimp by accessing your **Mailchimp account** and navigating to **All Contacts** under the Audience dropdown. * You should now see that the contact has automatically been added. If you don't see the contact immediately, **refresh** your browser. * You can view the contact details that were added by **clicking on the contact** to access more information. ## FAQ **What actions can I currently perform in Mailchimp using this workflow sync?** Currently, the workflows offer the ability to add tags to audience members, add/update an audience member's data, archive an audience member, permanently delete a member, remove tags from an audience member and unsubscribe an audience member. **When setting up the actions, why can't I see the audience I'd like to add the contact to?** If you can't see the audience you're looking to add the contact to, it's likely that the audience hasn't been created in Mailchimp prior to setting up the workflow. Please ensure you create your required audience prior to building the workflow. You can read more on creating [audiences here](https://mailchimp.com/help/create-audience/). **Is the workflow sync a two-way sync (ie. push and pull)?** At this stage, the workflow sync is a one-way sync (push) from the Komo Engagement Engine to Mailchimp. This means that any updates to contacts within Komo will automatically be pushed to the CRM to ensure the CRM remains in sync with the changes made in Komo. In the instance where a contact is updated in Mailchimp initially, the change will not be reflected in Komo. We will be rolling out a true two-way (push and pull) sync in a future release. **How often will the workflow sync run?** The sync is completely determined by when the trigger conditions (set in [Step 2](#step-1-connect-the-mailchimp-connected-app)) are met. If a condition is met, the workflow will run immediately. **How many workflow syncs can I create?** You can create as many different syncs as you require! **Can I send contacts from specific cards to a different Mailchimp audience or tag, as well as my workspace-wide sync?** Yes. Keep your Workspace-level workflow for the overall sync, and add a Card-level workflow on the cards you want to segment (for example themed competitions) that adds the contact to another audience or applies tags. Both workflows run for that card's data captures, so the contact is synced twice (once per workflow) and can end up in more than one Mailchimp audience or with extra tags. Plan your Mailchimp audiences and tags with that in mind. See [Workflows](/integrations-automation/workflows) for how scopes work. The Mailchimp actions you can use (including add tags and add/update member) are listed in the first FAQ above. # Salesforce — CRM Contact Sync Source: https://knowledge.komo.tech/crm/syncs/salesforce-crm-contact-sync/index Set up a Salesforce CRM contact sync with manual or scheduled runs. ## What is it? You can now have confidence that the contact data within your Salesforce CRM is up-to-date with CRM Contact Sync. Through direct integration with your Salesforce instance, Komo can push new contacts and contact updates directly to Salesforce. Run a sync manually with **Sync now**, or set a **Sync frequency** so it runs on a schedule. > [!NOTE] > > If you are using Salesforce Marketing Cloud, you'll want to refer to another article [here](/crm/syncs/salesforce-marketing-cloud-crm-contact-sync). ## How do I set it up? * Step 1: Connect the Salesforce Connected App * Step 2: Create CRM Sync * Step 3: Complete Sync configuration * Step 4: Run the CRM Sync * Step 5: Review the CRM Sync ### Step 1: Connect the Salesforce Connected App ![Salesforce — CRM Contact Sync: step 4 — Step 1: Connect the Salesforce Connected App](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-1-connect-the-step-4.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=a5286c7c1cdfe6a517bfdd49e3c0b740) In order to connect to Salesforce, you need to create a connected app in Salesforce. Make sure you use the **OAuth 2.0 Client Credentials Flow**. For info on how to set this up visit [Salesforce help](https://help.salesforce.com/s/articleView?id=sf.connected_app_client_credentials_setup.htm) or contact your customer success manager. * Navigate to **Account Settings** by clicking the **Workspace initials** in the top right corner and clicking **Account Settings.** * **(1)** Click **Connected Apps.** * **(2)** Select **Connect** next to the Salesforce Connected App. > **Connect Salesforce** > > ![Salesforce — CRM Contact Sync: option a — Step 1: Connect the Salesforce Connected App](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-1-connect-the-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=692f32e4dce187573ef232d75031a03e) > > * **(A)** Here you can insert the **CRM Domain Name** from your CRM instance. > * **(B)** Insert the **Client ID/consumer key** from the connected CRM. > * **(C)** Here you can paste in the **Client Secret** of the connected CRM. > * **(D)** Click **Test** under Test Connection. If the connection is successful, you will see a green **Connection Successful** message. > * **(E)** Click **Connect.** ### Step 2: Create CRM Sync ![Salesforce — CRM Contact Sync: step 2 — Step 2: Create CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-2-create-crm-step-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=26f7978baa299055a1765dcb2a937c47) * **(1)** Navigate back to your workspace and click on **CRM.** * **(2)** Click **Syncs.** * **(3)** Click the **+ Create Sync** button. * **(4)** Select the **CRM** you would like to sync with. ### Step 3: Complete Sync configuration ![Salesforce — CRM Contact Sync: step 3 — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-3-complete-sync-step-3.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=77ab58764de0392963dd0616e422bb8a) * **(1)** Here you can configure the CRM Sync **Setup.** * **(2)** Select whether the **Data source** to sync should be **Contact** or **Lead.** * **(3)** Select the field within **Komo** and your **CRM** which will be used to match contacts between the two platforms. * **(4)** Set the desired **Sync Actions** to be performed when there is a **match** and when there is **no match.** * **(5)** Click on **Filter (optional)** if you would like to add filters to your sync. > **Add Filters** > > ![Salesforce — CRM Contact Sync: option a — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-3-complete-sync-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=64d5bd0a3d251ebb4562a228edf0255c) > > * **(A)** Click **+ Add Filter.** > > ![Salesforce — CRM Contact Sync: option a — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-3-complete-sync-option-a-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=fab7bd5e5978dd725f6f5bd9f42480e2) > > * **(a)** Here you can configure your **Filters** as required. > * **(b)** Click the bin to **delete** any filters you have created. * **(6)** Click on **Field Mapping** to ensure contact fields in Komo are properly mapped to the fields in your CRM. > **Map Fields** > > ![Salesforce — CRM Contact Sync: option a — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-3-complete-sync-option-a-3.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=25aeabf6ccceb52d60c047e9240f4cec) > > * **(A)** Click **+ Add Field.** > > ![Salesforce — CRM Contact Sync: option a — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-3-complete-sync-option-a-4.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=a67f17970a35862049f20d6fadaf7a2e) > > * **(a)** Select the desired **Komo field** to be mapped. > * **(b)** Select the corresponding **CRM field** that the Komo field should be mapped to. > * **(c)** Click **Add.** ### Step 4: Run the CRM Sync ![Salesforce — CRM Contact Sync: step 4 — Step 4: Run the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-4-run-the-step-4.gif?s=874a37f035508fba666780e6f3b7f2e8) * Once your CRM Sync settings are configured, open the sync control panel. * Use **Enable** to set the sync status to **Enabled** (or **Disable Sync** to set it to **Stopped**). **Sync now** and scheduled runs only execute while the sync is enabled. **Edit schedule** is available whether or not the sync is enabled. * Click **Sync now** for an immediate run. You will see details of the sync that has just been initiated. You can also schedule the sync so you do not need to click **Sync now** every time: 1. On the sync control panel, click **Edit schedule**. The modal title is **Update schedule**. 2. Set **Sync frequency** to **Manual**, **Daily**, **Weekly**, or **Monthly**. 3. For **Daily**, **Weekly** or **Monthly**, set **Run time** (shown as Reporting time zone: your workspace reporting time zone). Fields by frequency: * **Manual** — no timing fields * **Daily** — **Run time** * **Weekly** — **Run time** and **Weekday** * **Monthly** — **Run time** and **Day of month** (1–31). Short months automatically use their last day when the chosen date does not exist. Selecting **Run on the last day of every month** disables **Day of month**. 4. Click **Save changes**. Scheduled runs and **Sync now** only execute while the sync is **Enabled**. You can open **Edit schedule** whether or not the sync is enabled. > [!NOTE] > > Use **Sync now** any time you want an immediate run while the sync is enabled, even when a schedule is configured. ### Step 5: Review the CRM Sync ![Salesforce — CRM Contact Sync: step 5 — Step 5: Review the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-5-review-the-step-5.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=90fb80017c037e75b4418e3f94bbc9f1) * You can now review the sync to ensure it's performing as expected. * **(1)** Here you can view all details relating to the sync including **ID,** when it was **Created** and **Last Updated,** the **Run duration** and **Status.** * **(2)** Click on the **Green tick** to view more detailed information on the **Sync Run.** > **Sync Run Information** > > ![Salesforce — CRM Contact Sync: option a — Step 5: Review the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-5-review-the-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=45f3abfc1a8c87a0ba15579f9050176a) > > * **(A)** Here you will be able to see a **Summary** of the key **Sync Run details.** > * **(B) Totals** displays the total number of contacts within your Komo and CRM instances. > * **(C) CRM Inserts** displays how many contacts the sync successfully imported into the CRM and how many errors were encountered. > * **(D) CRM Updates** displays how many contacts the sync successfully updated in the CRM and how many errors were encountered. > * **(E)** Click **Logs** to view in depth logs of the executed sync. > > ![Salesforce — CRM Contact Sync: option a — Step 5: Review the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-5-review-the-option-a-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=6a7628569b377911d13065a1c78bb998) > > * **(a)** Here you can view a log of the various actions that took place within the sync. > * **(b)** Click **Download results** to export a CSV of the syng logs. ## FAQ **Is the CRM Contact Sync a two-way sync (ie. push and pull)?** At this stage, the CRM Contact sync is a one way sync (push) from Komo to the CRM. This means that any any updates to contacts within Komo will automatically be pushed to the CRM to ensure the CRM remains in sync with the changes made in Komo. In the instance where a contact is updated in the CRM initially, the change will not be reflected in Komo. We will be rolling out a true two-way (push and pull) sync in a future release. **How often will the CRM Contact Sync run?** You choose. On the sync control panel, click **Edit schedule** (modal title **Update schedule**). Set **Sync frequency** to **Manual**, **Daily**, **Weekly**, or **Monthly**. For **Daily**, **Weekly** or **Monthly**, set **Run time** (workspace reporting time zone). **Weekly** also shows **Weekday**. **Monthly** shows **Day of month** (1–31; short months use their last day when the chosen date does not exist) or **Run on the last day of every month**. Click **Save changes**. Scheduled runs and **Sync now** only execute while the sync is **Enabled**. See [Step 4](#step-4-run-the-crm-sync). **Is this available for all CRMs?** At this stage, the CRM Contact Sync has only been rolled out for Salesforce and Salesforce Marketing Cloud. We will be rolling out this functionality for additional CRMs in the near future. **Can this be managed by all users?** Any admin whose role includes access to **CRM Syncs** can create and manage the CRM Contact Sync. If you don't see **CRM Syncs** in the **CRM** menu, ask your workspace administrator to check your role. **How many CRM Contact Syncs can I create?** You can create as many different syncs as you require! # Salesforce Marketing Cloud — CRM Contact Sync Source: https://knowledge.komo.tech/crm/syncs/salesforce-marketing-cloud-crm-contact-sync/index Set up a Salesforce Marketing Cloud contact sync with manual or scheduled runs. ## What is it? You can now have confidence that the contact data within your Salesforce Marketing Cloud CRM is up-to-date with CRM Contact Sync. Through direct integration with your Salesforce Marketing Cloud instance, the Komo Engagement Engine can push new contacts and contact updates directly to Salesforce Marketing Cloud. Run a sync manually with **Sync now**, or set a **Sync frequency** so it runs on a schedule. > [!NOTE] > > If you are using Salesforce (and not Salesforce Marketing Cloud), you'll want to refer to [this article](/crm/syncs/salesforce-crm-contact-sync). ## How do I set it up? ### Step 1: Connect to Marketing Cloud and Create a Data Extension ![Salesforce Marketing Cloud — CRM Contact Sync: step 1 — Step 1: Connect to Marketing Cloud and Create a Data Extension](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-1-connect-to-step-1.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=586441b62bc49ebebe4c9b8d7134e465) * Navigate to **Account Settings** by clicking the **Workspace initials** in the top right corner and clicking **Account Settings**. * **(1)** Click **Connected Apps**. * **(2)** Select **Connect** next to the Salesforce Marketing Cloud Connected App. ![Salesforce Marketing Cloud — CRM Contact Sync: option a — Step 1: Connect to Marketing Cloud and Create a Data Extension](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-1-connect-to-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=345143cc85739243a9712eff0a8be2c0) * **(A)** Here you can insert the **CRM Domain Name** from your CRM instance. * **(B)** Insert the **Client ID/consumer key** from the connected CRM. * **(C)** Here you can paste in the **Client Secret** of the connected CRM. * **(D)** Click **Test** under Test Connection. If the connection is successful, you will see a green **Connection Successful** message. * **(E)** Click **Connect**. Now, you'll want to create a Data Extension in Marketing Cloud. This is where the Komo Engagement Engine will push Contacts. [Follow these instructions](https://help.salesforce.com/s/articleView?id=sf.mc_cab_create_a_new_data_extension.htm\&language=en_US\&type=5) to create your Data Extension. > [!NOTE] > > In order to connect to Salesforce Marketing, you need to create an Installed Package in Salesforce Marketing Cloud. Then add a Component of type API Integration. Make sure you use the Server-to-Server type. For information on how to set this up visit [Salesforce help](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_api_integration.htm\&type=5) or contact your Customer Success Manager. ### Step 2: Create CRM Sync ![Salesforce Marketing Cloud — CRM Contact Sync: step 2 — Step 2: Create CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-2-create-crm-step-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=f42443bef8de5af8f28418da41e1dffd) * Navigate back to your workspace. * **(1)** Click on **CRM**. * **(2)** Click **Syncs**. * **(3)** Click the **+ Create Sync** button. * **(4)** Select the **CRM** you would like to sync with. ![Salesforce Marketing Cloud — CRM Contact Sync: step 1 — Step 2: Create CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-2-create-crm-step-1.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=bbcc70a530285985d22bf9156cf8cdc3) * **(A)** Select which Data Extension you are using as the **Data source** to sync into. You can search by typing the name of the Data Extension. This should be the Data Extension you created in [Step 1](#step-1-connect-to-marketing-cloud-and-create-a-data-extension). * **(B)** Click **Search**. * **(C)Select** the appropriate data source. ### Step 3: Complete Sync configuration ![Salesforce Marketing Cloud — CRM Contact Sync: option b — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-3-complete-sync-option-b.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=1794727686a401f80b54db47f1d6557b) * **(1)** Here you can configure the CRM Sync **Setup**. * **(2)** Here you will see the **Data source** you just linked. * **(3)** Select the field within **Komo** and your **CRM** which will be used to match contacts between the two platforms. * **(4)** Set the desired **Sync Actions** to be performed when there is a **match** and when there is **no match**. * **(5)** Click on **Create Property Filter (optional)** if you would like to add filters to your sync. ![Salesforce Marketing Cloud CRM sync: configuring sync setup and field matching](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-sync-setup-screenshot.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=3cdbb35f57f69c7049b11171df2517df) * **(A)** Click **+ Add Filter**. ![Salesforce Marketing Cloud — CRM Contact Sync: option a — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-3-complete-sync-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=993629a03492f892b558733e0f523dcb) * **(a)** Here you can configure your **Filters** as required. * **(b)** Click the bin to **delete** any filters you have created. * **(6)** Click on **Field Mapping** to ensure contact fields in Komo are properly mapped to the fields in your CRM. ![Salesforce Marketing Cloud — CRM Contact Sync: step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-3-complete-sync-screenshot.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=27adea747f9b980a09533865f97a8d97) * **(A)** Click **+ Add Field**. ![Salesforce Marketing Cloud — CRM Contact Sync: option a — Step 3: Complete Sync configuration](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-3-complete-sync-option-a-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=8780afd7574ad1933ec75c58c3b20afd) * **(a)** Select the desired **Komo field** to be mapped. * **(b)** Select the corresponding **CRM field** that the Komo field should be mapped to. * **(c)** Click **Add**. * **(7)** Here you can edit and manage any of the **CRM connection settings** you configured in [**Step 1**](#step-1-connect-to-marketing-cloud-and-create-a-data-extension). * **(8)** Once you're satisfied with the CRM sync settings and have mapped all required fields, click **Save**. ### Step 4: Run the CRM Sync ![Salesforce — CRM Contact Sync: step 4 — Step 4: Run the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-4-run-the-step-4.gif?s=874a37f035508fba666780e6f3b7f2e8) * Once your CRM Sync settings are configured, open the sync control panel. * Use **Enable** to set the sync status to **Enabled** (or **Disable Sync** to set it to **Stopped**). **Sync now** and scheduled runs only execute while the sync is enabled. **Edit schedule** is available whether or not the sync is enabled. * Click **Sync now** for an immediate run. You will see details of the sync that has just been initiated. You can also schedule the sync so you do not need to click **Sync now** every time: 1. On the sync control panel, click **Edit schedule**. The modal title is **Update schedule**. 2. Set **Sync frequency** to **Manual**, **Daily**, **Weekly**, or **Monthly**. 3. For **Daily**, **Weekly** or **Monthly**, set **Run time** (shown as Reporting time zone: your workspace reporting time zone). Fields by frequency: * **Manual** — no timing fields * **Daily** — **Run time** * **Weekly** — **Run time** and **Weekday** * **Monthly** — **Run time** and **Day of month** (1–31). Short months automatically use their last day when the chosen date does not exist. Selecting **Run on the last day of every month** disables **Day of month**. 4. Click **Save changes**. Scheduled runs and **Sync now** only execute while the sync is **Enabled**. You can open **Edit schedule** whether or not the sync is enabled. > [!NOTE] > > Use **Sync now** any time you want an immediate run while the sync is enabled, even when a schedule is configured. ### Step 5: Review the CRM Sync ![Salesforce — CRM Contact Sync: step 5 — Step 5: Review the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-crm-contact-sync-step-5-review-the-step-5.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=90fb80017c037e75b4418e3f94bbc9f1) * You can now review the sync to ensure it's performing as expected. * **(1)** Here you can view all details relating to the sync including **ID**, when it was **Created** and **Last Updated**, the **Run duration** and **Status**. * **(2)** Click on the **Green tick** to view more detailed information on the **Sync Run**. ![Salesforce Marketing Cloud — CRM Contact Sync: step 5: Review the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-5-review-the-screenshot.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=1558fc934232576e52f40ba64e07f536) * **(A)** Here you will be able to see a **Summary** of the key **Sync Run details**. * **(B)Totals** displays the total number of contacts within your Komo and CRM instances. * **(C)CRM Inserts** displays how many contacts the sync successfully imported into the CRM and how many errors were encountered. * **(D)CRM Updates** displays how many contacts the sync successfully updated in the CRM and how many errors were encountered. * **(E)** Click **Logs** to view in depth logs of the executed sync. ![Salesforce Marketing Cloud — CRM Contact Sync: option b — Step 5: Review the CRM Sync](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/salesforce-marketing-cloud-crm-contact-sync-step-5-review-the-option-b.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=408e4c4d7bc6c0fdc2e751eda8c1664e) * **(a)** Here you can view a log of the various actions that took place within the sync. * **(b)** Click **Download results** to export a CSV of the sync logs. ## FAQ **Is the CRM Contact Sync a two-way sync (ie. push and pull)?** At this stage, the CRM Contact sync is a one way sync (push) from the Komo Engagement Engine to the CRM. This means that any updates to contacts within the Komo Engagement Engine will automatically be pushed to the CRM to ensure the CRM remains in sync with the changes made in Komo. In the instance where a contact is updated in the CRM initially, the change will not be reflected in the Komo Engagement Engine. We will be rolling out a true two-way (push and pull) sync in a future release. **How often will the CRM Contact Sync run?** You choose. On the sync control panel, click **Edit schedule** (modal title **Update schedule**). Set **Sync frequency** to **Manual**, **Daily**, **Weekly**, or **Monthly**. For **Daily**, **Weekly** or **Monthly**, set **Run time** (workspace reporting time zone). **Weekly** also shows **Weekday**. **Monthly** shows **Day of month** (1–31; short months use their last day when the chosen date does not exist) or **Run on the last day of every month**. Click **Save changes**. Scheduled runs and **Sync now** only execute while the sync is **Enabled**. See [Step 4](#step-4-run-the-crm-sync). **Is this available for all CRMs?** At this stage, the CRM Contact Sync has only been rolled out for Salesforce and Salesforce Marketing Cloud. We will be rolling out this functionality for additional CRMs in the near future. **Can this be managed by all users?** Any admin whose role includes access to **CRM Syncs** can create and manage the CRM Contact Sync. If you don't see **CRM Syncs** in the **CRM** menu, ask your workspace administrator to check your role. **How many CRM Contact Syncs can I create?** You can create as many different syncs as you require! # Activation Ideas: FMCG Source: https://knowledge.komo.tech/getting-started/best-practices/activation-ideas-fmcg/index Get inspired for your FMCG Engagement Hub! ## Test Your Knowledge Use either the Live Trivia Card or Quiz Card to test your community's knowledge on any topic. This is an excellent opportunity to learn more about your community through market research questions and reward your audience. > [!TIP] > > Utilise the Komo Digital Coupons to maximise your return. Provide all entrants with the opportunity to try your products for free or at a discounted price, and encourage them to return to your brick-and-mortar stores. ## Secret Codes With the Secret Code Card, you can drive people to a destination of your choice. Users will find and submit a secret code in return for a special offer or an exclusive product. > [!TIP] > > Utilise the Secret Code Card to promote your social media platforms by posting the secret code on socials then sending Engagement Hub visitors to your social media to receive the exclusive deal. > [!NOTE] > > Example > > Put up promotional material in-store with the secret code printed on it to drive traffic to your Engagement Hub. Users can submit the secret code on the Engagement Hub to receive an exclusive deal on your products! ## Personality Quiz Use a Personality Quiz Card to engage your community and send out personalised rewards based on the outcome of the quiz. These can be based on specific dates and events, or any topic that you can think of! This is also a prime spot to include market research questions that allow you to drill down and get a greater understanding of that individual consumer's persona. > [!TIP] > > The "What type of X are you?" questions are very effective prompts for this type of card. > [!NOTE] > > Example > > Push your brand by recommending certain products based on the user's outcome, e.g.: "What Type of Beer Drinker Are You?" The quiz results can lead to different brand products and corresponding Digital Coupons. ## Caption Contest Use the 20 Words or Less Card to run a caption contest competition. This is an easy-to-set-up competition that allows you to gather user-generated content to repurpose for your social media platforms. > [!TIP] > > Show off your creative community by publishing the winning entries on your Engagement Hub, social channels, and EDM. > [!NOTE] > > Example > > Use this competition as an opportunity to increase brand awareness and integrate your products into the image prompt. With this competition, you can also offer Digital Coupons to all entrants as an incentive to participate. ## Sports Predictor Encourage your community to predict unknown events for special occasions and reward those who get their predictions correct. This works great for big events such as AFL, BBL, and A-League games, but also provides a great opportunity to tie into local teams and support your community. > [!NOTE] > > Example > > Working with local sports teams, build a live predictor game that allows your community to directly engage and make predictions on the game, e.g.: Which team will win? Over or Under 2.5 goals? Who will score? You can then reward members of your community that made correct selections with larger prizes and provide Digital Coupons to all entrants as an "everybody wins" prize. ## Photo Contest Use the upload file feature in the Receipt Uploader Card to host a photo contest. Here, users can upload photos of themselves enjoying your products and prizes can be awarded accordingly. This idea is a great way to engage your community and promote user-generated content. > [!TIP] > > To make this competition go even further, add the top entrants' photos into a Poll Card and have your community vote on a winner. > [!NOTE] > > Example > > Celebrate creativity with a competition such as "Send in a photo of the coolest place you've had one of our products!" Add on a great prize to encourage participation and fun user-generated content. # Activation Ideas: Shopping Centres Source: https://knowledge.komo.tech/getting-started/best-practices/activation-ideas-shopping-centres/index Get inspired for your shopping centre Engagement Hub! ## Treasure Hunt Take your community on a treasure hunt around your centre! Start by having users enter a Content Card (either the Secret Code Card or Image Card with data capture) to receive a clue directing them to a physical or digital location to find the 'secret code'. Once this code is submitted, this can then reveal another clue and so on. Turn this into a more extensive campaign by doing 'Treasure Hunt Thursdays' or on special occasions. > [!NOTE] > > **Example** > > Drive families in-centre by offering a free coffee to mums on Mother's Day. When they enter their details on the Engagement Hub, they will be sent a Digital Coupon for a free coffee as well as the first clue for the treasure hunt. This could lead them to various retailers with an accompanying Digital Coupon, ultimately leading them to the end of the treasure hunt at a florist, where they receive a free bunch of flowers! > [!TIP] > > The Secret Code Card is only the name given to this card type. Get creative and use this card to run competitions such as "Complete the Sentence" or "Enter the Number". ## Sports Predictor Encourage your community to predict unknown events for special occasions and reward those who get their predictions correct. This works great for big events such as AFL, BBL, and A-League games, but also provides a great opportunity to tie into local teams and support your community. > [!NOTE] > > Example > > Working with local sports teams, build a live predictor game that allows your community to directly engage and make predictions on the game, e.g.: Which team will win? Over or Under 2.5 goals? Who will score? Encourage your community to get involved and watch the game, and then reward correct selections with in-centre vouchers. ## Jelly Bean Guess Use the physical space in-centre and work with retailers to hold a good old-fashioned guessing game! Fill a container with X amount of an object then use the Number Guess Card to allow your community to take a guess. > [!TIP] > > Utilising a Secret Code Card hidden by the container, you can interchange this daily and have users come back to guess multiple times throughout the campaign. > [!NOTE] > > Example > > Partner with a sporting goods retailer to fill a large container with footy balls, place it somewhere central in your shopping centre, and include visible posters with QR codes to the Engagement Hub. In-centre customers can then scan the QR codes to easily guess the number. You can build on this by adding a Secret Code Card that is changed daily to drive people in-centre to submit a guess. ## Story Time Create great user-generated content with the 20 Words or Less Card and the Media Uploader Card. Encourage families to write creative content, upload, and share! > [!TIP] > > '20 Words or Less' is just the name for this card - with the form settings you can alter this to accept as few or as many words as you like. > [!NOTE] > > Example > > Host a competition to find the most creative kids in your community. With a fun prompt such as "The Big Gloomy Castle...", encourage kids (and their parents) to upload their best action story. You can then publish the best ones and announce a winner. Bonus idea: this could be made into a real book and given as a prize! ## Test Your Knowledge Use either the Live Trivia Card or Quiz Card to test your community's knowledge on any topic. This is an excellent opportunity to learn more about your community through market research questions and reward your audience. > [!NOTE] > > Example > > Create a trivia focused on your community and the retailers within your centre with topics such as: "What is Mr Gelato's Favourite Flavour?" or "How Long Does It Take to Smoke Mr. BBQ's Famous Brisket?" These moments spark conversation, drive people into retailers and add value to the whole centre. As a bonus, you can award the top (or all!) participants with a Digital Coupon for a particular store or centre-wide. ## What Type Are You? Use a Personality Quiz Card to engage your community and send out personalised rewards based on the outcome of the quiz. These can be based on specific dates and events, or any topic that you can think of! This is also a prime spot to include market research questions that allow you to drill down and get a greater understanding of that individual consumer's persona. > [!TIP] > > There's no limit to how many stages you can add to this type of quiz; the more questions you add the more you will be able to find out about your community. > [!NOTE] > > Example > > Ask your community, "What Type of Pizza Are You?" By asking several questions such as 'Sweet or Salty?' or 'What's your favourite sport?' will lead them to be crowned the Hawaiian King. They are then ultimately sent a Digital Coupon for a Hawaiian pizza from the local pizzeria. ## Colouring-In Competition Take an old classic and reinvent it through your Engagement Hub. Colouring-In competitions are a great way to engage young families, and on the Engagement Hub, you can both host the competition and showcase the entrants' masterpieces. > [!NOTE] > > Example > > Engage young families by distributing a blank black-and-white image on the Engagement Hub. Users can then download the image, colour it in and then upload the creation through the Engagement Hub. To incentivise future players, upload the winning images onto your Engagement Hub and offer up a fun, child-friendly prize or experience. # Best of the Best: FMCG Activations Source: https://knowledge.komo.tech/getting-started/best-practices/best-of-the-best-fmcg-activations/index Handpicked FMCG Engagement Hub activations to inspire your next campaign. We've handpicked some of our favourite fast-moving consumer goods (FMCG) activations to help get your creative juices flowing. Each example uses the Komo Engagement Engine to drive foot traffic, reward customers, and collect first-party data. For card ideas you can adapt to your brand, see [Activation Ideas: FMCG](/getting-started/best-practices/activation-ideas-fmcg). To set up offers like these, start with [Digital Coupons](/competitions-promotions/digital-coupons/digital-coupons). ## Pirate Life Brewing: #GoToTown with South Coast Pale Ale Pirate Life Brewing joined the South Australian Tourism Commission's **#GoToTown** campaign to drive foot traffic into SA hospitality venues after COVID-19 lockdowns. The campaign used Komo **Digital Coupons** to offer Adelaidians a free pint of Pirate Life's South Coast Pale Ale each day of the promotion. Coupons were personalised based on the user's geolocation, making redemption easy at nearby venues. Partnering with SA Tourism Commission gave Pirate Life greater promotional reach, which led to higher coupon redemption rates and more foot traffic to local venues. The sleek, simple **Engagement Hub** design resonated strongly with participants. > [!TIP] > > Geolocation-based coupon personalisation works well for FMCG activations where redemption happens at physical venues. Pair in-venue signage and staff prompts with QR codes on your Hub to maximise uptake. ## Carlton & United Breweries: Siren Sessions Carlton & United Breweries (CUB) used Komo **Digital Coupons** to offer complimentary pints to **Engagement Hub** visitors during Derby Day **Siren Sessions** in the Perth CBD. The Hub ran alongside the live event and gave patrons a clear reason to participate digitally while onsite. This simple FMCG activation: * Increased brand awareness among event attendees * Drove participation through an instant, redeemable offer * Collected first-party data for future marketing > [!NOTE] > > Event-based FMCG activations work best when the Hub is promoted at the venue—via QR codes, stage screens, or staff—and when the offer is easy to redeem before patrons leave the event. # Best of the Best: Shopping Centre Activations Source: https://knowledge.komo.tech/getting-started/best-practices/best-of-the-best-shopping-centre-activations/index We've handpicked some of our favourite activations to help get your creative juices flowing! ### Pacific Square Maroubra - Winter Rewards Hub ![Best of the Best: Shopping Centre Activations: pacific Square Maroubra - Winter Rewards Hub](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/best-of-the-best-shopping-centre-activations-pacific-square-maroubra-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=1416e8d2c361209a4e7cd8a2efc8df2c)Pacific Square Maroubra turned their event space into a 'Winter Wonderland' for their community featuring live bands and giveaways.This was complemented by their Hub, which was promoted via QR codes around the centre and at POS within retailers.This enabled them to reward their community and furthermore support their restaurants during the colder months. **Check out the video below.** Pacific Square - Winter Rewards ### Scan, Play, Win! * **Secret Harbour Square & Wanneroo Central** ![Best of the Best: Shopping Centre Activations: scan, Play, Win!](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/best-of-the-best-shopping-centre-activations-scan-play-win-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=1dc51c5b4509fa263badf48b6de3e95f) Scan, Play, Win! took classic games and brought them to life in-centre with a digital spin.Utilising in-centre floor decals and displays, Secret Harbour gave their Hub a physical presence and encouraged their community to get involved with fun and rewards.Check out some of the photos below of how this was brought to life! ![Best of the Best: Shopping Centre Activations: scan, Play, Win!](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/best-of-the-best-shopping-centre-activations-scan-play-win-screenshot-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=6b2c6e3989d4bd40d9375221b62ef66b) * Secret Harbour Square ![Best of the Best: Shopping Centre Activations: scan, Play, Win!](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/unknown.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=0b1768f4634980c29f60760e37bfa1cb) # Competition Permits Source: https://knowledge.komo.tech/getting-started/best-practices/competition-permits/index Australian State and Territory requirements for competitions. ## What are they? Each State and Territory in Australia has different legal requirements surrounding competitions and promotions. Nationwide promotions are subject to individual State and Territory laws. Typically, some form of submission is required for ACT, SA, NSW, WA, and NT; however, this depends on the prize pool. TAS, QLD, and VIC do not require permits, but they do have specific rules that have to be followed. These rules are similar (but not identical) between the locations, so it is a good idea to familiarise yourself with the rules within your jurisdiction/s. Read on for further details. > [!WARNING] > > Please note that the information and advice that Komo provides regarding permits, terms and conditions, privacy policies, or any other matter of this nature is of a general basis only, and we suggest you seek your own legal advice specific to your needs. > **[Access up-to-date information](https://www.tpal.com.au/competition-permits/)** > **[Access the T\&Cs templates](/getting-started/resources/terms-conditions/index)** ### **Game of Skill vs. Game of Chance** When planning a competition, there are two types of games you need to consider: Games of skill and games of chance. These competitions have different rules and regulations. **A game of skill is any competition that does not use a random draw for the winner.** On the Komo Platform, an example of a game of skill would be Live Trivia, Live Trivia, or a Quiz. A game of skill does not require a competition permit. **A game of chance is any competition where a prize winner is chosen at random.** On the Komo Platform, an example of a game of chance would be Spin to Win, Scratch and Win or Watch to Win. A game of chance will require a competition permit in some states and territories, depending on the value of prizes. ### **Regulations by State & Territory** #### **Queensland** * You do not require any permits for competitions (whether games of skill or chance) in Queensland. #### **New South Wales** * From 1 July 2020, NSW only requires a permit if the prize pool is greater than \$10,000. * The permit is now called an authority. The authority is issued to the promoter for 1, 3, or 5 years. The promoter can then run as many promotions as they like during the duration of the authority. * For each promotion that is run under the authority, you must apply for a "notification of trade promotion". * Read more about NSW permits [**here**](https://tponline.onegov.nsw.gov.au/). > [!NOTE] > > This involves submitting an application (including compliant T\&Cs) at least 3 business days before the promotion commences. There is no government fee for this submission. NSW requires that the prize draw occur using a system that is compliant with NSW regulations. If the prize draw is higher than \$10,000, an independent scrutineer must attend the prize draw. > > \_Note: Prize draw system \_[**www.randomdraws.com.au**](http://www.randomdraws.com.au) *is registered in NSW.* #### **Victoria** * You do not require any permits for competitions (whether games of skill or chance) in Victoria. #### **Western Australia** * Terms & Conditions are required to be submitted for review, regardless of the prize pool. * WA does not issue a permit, although they do reply with feedback if they see an issue with the terms and conditions. * Submission must occur prior to the competition being promoted. They do not charge a fee, simply email [**rgl@rgl.wa.gov.au**](mailto:rgl@rgl.wa.gov.au) your terms and conditions for a review. * Western Australia also has prescribed conditions for competitions, that you can read about [**here**](https://www.dlgsc.wa.gov.au/racing-gaming-and-liquor/racing-gaming-and-wagering/gaming-applications/how-to-conduct-a-trade-promotion-lottery). #### **South Australia** * A permit is required if the prize pool is higher than \$5,000. These are typically issued within 14 business days. * Read more about South Australia's prescribed conditions [**here**](https://www.sa.gov.au/topics/business-and-trade/running-a-business/trade-promotions). > [!NOTE] > > If the competition is an "instant win" promotion, a permit is required regardless of the prize pool. SA requires that the prize draw occurs using a system that is registered in SA. If the prize draw is \$20,000 or higher, an independent scrutineer must attend the prize draw. > > What is classified as an “instant win”? The entrant receives a message straight after entering to tell them whether they win or not. Like a scratch card or the equivalent online. > > Prize draw system [www.randomdraws.com.au](http://www.randomdraws.com.au) is registered in SA. #### **ACT** * A permit is required if the prize pool is greater than \$3,000. The ACT will normally issue the permit within 3 to 7 business days. * You can read more about ACT permits [**here**](https://www.gamblingandracing.act.gov.au/industry/lotteries/trade-promotions). > [!NOTE] > > *When the determination of the prize winner involves skill only (i.e. no element of chance is involved), approval is not required. In this context, "skill" means any competition that involves a decision or input by the participant, such as guessing a sound or number or weight.* #### **Northern Territory** * A permit is required if the prize pool is greater than \$5,000 and a permit has not been obtained via another state. For national promotions, a NT permit is never required. * Read more about permits in the Northern Territory [**here**](https://nt.gov.au/industry/gambling/gambling/lotteries-community-gambling/apply-to-run-a-trade-lottery). #### **Tasmania** * You do not require permits for competitions (whether games of skill or chance) in Tasmania when they comply with prescribed conditions. * You can read out about these conditions [**here**](https://www.treasury.tas.gov.au/liquor-and-gaming/gambling/licences-and-permits/minor-gaming-permit). ## **FAQ** **How much does a competition permit cost?** This varies per state, and can be checked at the various links provided above. **How do I apply for a permit?** Each state varies as to their permit application process, but all involve completing a form for review. **How long should I allow for a permit to be issued?** We recommend allowing 28 days for your permit to be issued, so this should be factored into your campaign prep time. **How long do permits last?** Usually 12 months, however, this does differ slightly from state to state. Please read the hyperlinked documentation relevant to your jurisdiction. # Promotion: Events Source: https://knowledge.komo.tech/getting-started/best-practices/promotion-events/index Learn how to promote your Engagement Hub for in-venue activations. When it comes to Engagement Hub performance, promotion is key. Below are our recommendations on how to drive people to your Engagement Hub and participate in your Live Trivia games for live events. ## In-Venue Promotion Advertising your Engagement Hub in-venue is the most important form of promotion to maximise foot traffic and audience engagement. Below are our recommendations for in-venue promotion: ### Posters Use posters in areas of heavy foot traffic, points of sale, and toilets to maximise their reach. Design with vibrant colours and bold fonts to attract customer attention, and be sure to add a QR code so consumers can simply scan your poster to access your Engagement Hub. ### Digital Screens Large, in-venue screens are also a great way to promote your Engagement Hub. These screens provide a digital medium for users to reach the Engagement Hub and can be animated to capture customers' attention. ### A5 Table Talkers Similar to posters, A5 table talkers allow you to effectively promote your Engagement Hub for seated events. Apply your QR code to the design to ensure people can easily access your Engagement Hub. ## Staff Promotion Face-to-face communication is an excellent opportunity to personalise the promotional experience for the customer. Train your staff on what the Engagement Hub is and its purpose to make it easier for them to showcase it and encourage customers to scan and visit. ### Greeters Upon patron arrival, greeters can encourage the attendees to scan into your Engagement Hub. Simply supply the greeter with the necessary promotional material and have them highlight the prizes you have on offer. ### MCs MCs are often the focus of the audience's attention and thus perfectly situated to promote your Engagement Hub. Encourage the MC to highlight the prizes on offer and discuss the Engagement Hub with enthusiasm! ## Digital Promotion In addition to in-venue promotion, we highly recommend using digital channels to drive traffic to your Engagement Hub. ### Social Posts & Stories Prior to the event, use social media channels to inform attendees about the upcoming competition and drum up hype. Be sure to include clear CTAs and links to your Engagement Hub in the copy. > [!TIP] > > Run a few pre-event competitions and allow people to pre-register for your Live Trivia. ### EDMs Include your Engagement Hub, its content, and its unique features in your EDMs. Newsletters are often overlooked, but have seen great success for many of our partners! # Promotion: Shopping Centres Source: https://knowledge.komo.tech/getting-started/best-practices/promotion-shopping-centres/index Ways to promote your Hub activation for your Shopping Centre. Promotion of your Hub is essential for success. Keep reading to discover our recommendations on how to promote and drive people to your Engagement Hub. ## **In-Venue Promotion** Advertising your Hub in-venue is the most important form of promotion to maximise foot traffic and audience engagement. Below are our recommendations for in-venue promotion: ### Posters Use posters in areas of heavy foot traffic, points of sale, and toilets to maximise their reach. Design with vibrant colours and bold fonts to attract customer attention, and be sure to add a QR code so consumers can simply scan your poster to access your Engagement Hub. ### Digital Screens Large, in-venue screens are also a great way to promote your Engagement Hub. These screens provide a digital medium for users to reach the Engagement Hub and can be animated to capture customers attention. ### Involve your Retailers Involve your stores to maximise Hub promotion by hanging posters within stores, having notices at the point of sale, or even including a Hub QR code on the store's receipts. ### Train Staff on How to Promote your Hub Face-to-face selling is an excellent opportunity to personalise the promotional experience for the customer. Train your staff on what the Hub is and its purpose to make it easier for them to showcase it. We recommend providing them with a "cheat sheet'" on how to sell the experience to customers! ## **Digital Promotion** In addition to in-venue promotion, we highly recommend using digital channels to drive traffic to your Engagement Hub. Below are a few methods on how this can be achieved. ### Social Posts & Stories Post regularly to social media about the Engagement Hub and its competitions. Use CTA's and focus on the available prizes to effectively drive people to your Hub. ### EDMs Include your Hub, its content, and its unique features in your EDMs. Newsletters are often overlooked, but have seen great success for many of our partners! ### **Need Inspiration?** We've handpicked some of our favourite campaigns to get your creative juices flowing. [Click here to check them out.](/getting-started/best-practices/best-of-the-best-shopping-centre-activations) # Tips & Tricks: Shopping Centres Source: https://knowledge.komo.tech/getting-started/best-practices/tips-tricks-shopping-centres/index All the tips and tricks to make your Engagement Hub work best for your Shopping Centre! The Komo Engagement Engine offers a suite of digital products that revolutionise the traditional shopping experience, elevating the digital connection between shops and consumers and driving customers back into brick-and-mortar stores. Here are our top tips for growing your customer base and encouraging repeat visitors to your shopping centre using the Komo Engagement Engine. ## Promotion, Promotion, Promotion! Regular promotion is critical to keeping your centre and retailers front of mind with your audience. **Physically:** Utilise posters, floor and/or window decals, POS table talkers etc., to ensure your shoppers are aware of your Engagement Hub and that it is your centre's one-stop-shop for exclusive content, games and competitions. **Digitally:** Share your Engagement Hub and its content across your socials, promote or boost posts highlighting the content you're adding to your Engagement Hub, and use user-generated content from your various Content Cards to drive new users to your Engagement Hub. ## Placement Utilise the reach of social media to link to your Engagement Hub from as many touchpoints as possible. > [!TIP] > > Replace any pre-existing links in your Instagram bio with your Engagement Hub link. You can add any current links to your Engagement Hub via [**Click Banners**](/interactive-features/features/click-banner-card). ### QR Codes Distribute QR codes around your shopping centre to provide shoppers with an easier way to reach your Engagement Hub. Encourage retailers to place QR codes at your point of sale to increase their exposure. ## Retailers are Key The way your community responds to your Engagement Hub will be impacted by the uptake from your retailers. Make sure you get all of your retailers across the Engagement Hub, its purpose, how it will affect them, and encourage them to promote your Engagement Hub. > [!TIP] > > A good way to get your retailers on-side is to demonstrate how the product works and the value it will bring them. Consider hosting a Live Trivia Card for all of your retailers to get a better understanding of the Komo Engagement Engine and Digital Coupons. ## Offer Prizes It's important to point out that prizes aren't required for many activations; however, the more value you can offer to your community, the higher engagement you are likely to see. ## Partnerships Work with your retail partners to elevate your Engagement Hub by offering promotional space as a value add or as a space for them to offer prizes/incentives. Your Engagement Hub is a business asset to drive traffic, engage and understand your audience, and that data is a benefit to your retail partners as well. ## Physical Activation Space Use physical space within your shopping centre to create IRL activations that connect with the digital strategy in your Engagement Hub. ## SMS Communications We highly recommend utilising SMS communications to distribute prizes from your Engagement Hub. With SMS, prizes are sent directly to your shoppers and are more readily actioned. ## Coupons & The FOMO Effect Everyone loves a deal! Tap into the FOMO effect by phrasing your coupon promotion in a way that highlights scarcity, e.g. "We have 100 Hot Chips to give away! Once they're gone, they're gone, so get down early." It is *highly* rare that a coupon program receives a 100% redemption rate. To increase your redemption rate, send the offer to way more people than you have coupons for. In the above example, send the offer for 100 coupons to your full database to drive people in-centre and raise redemption rates. # Analytics Source: https://knowledge.komo.tech/getting-started/hub-setup/analytics/index Learn how to understand and learn from your Card and Hub analytics in Komo Engagement Engine ## What is it? Our Analytics modal is designed to empower our customers with valuable insights into the performance of their Komo Engagement Engine campaigns. With a focus on user engagement, conversion rates, and detailed performance metrics, you can make data-driven decisions to optimize your campaigns. ## How do I use it? **Accessing Hub-Level Analytics:** * [Navigate to Hub-Level analytics](#navigate-to-hub-level-analytics) * [Hub term definitions & navigation](#hub-term-definitions-&-navigation) **Accessing Card-Level Analytics:** * [Navigate to Card analytics](#navigate-to-your-chosen-card) * [Card term definitions & navigation](#card-term-definitions-&-navigation) ## Accessing Hub-Level Analytics ### Navigate to Hub-Level Analytics ![Analytics: navigate to Hub-Level Analytics](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-navigate-to-hub-level-analytics-screenshot.gif?s=b678aef62b79caa43b66e2090116bc6c) From your company homepage, navigate to your Engagement Hub and click on **analytics** in the top navigation > [!NOTE] > > We've used our Knowledge Base Hub as an example here! This Hub is only used internally. ### Hub term definitions & navigation Let's go over the key navigation of this modal first up! * **(1)** Here you can set the **date and time range** you wish to apply to your analytics * **(2)** Here you can download a **.CSV file** of your Hub's users * **(3)** This **line graph** shows the number of unique impressions, engagements and entries across your Hub along the timeline you set in Step 1 * **(4)** Here, you can choose to **filter your analytics** by all users, signed-up users or non-signed-up users > [!NOTE] > > These options will only appear if you have User Accounts Enabled. This feature is available for Growth subscriptions and above. > **Hub Analytics** > > ![Analytics: option a — Hub term definitions & navigation](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-hub-term-definitions-navigation-option-a.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=8e2b2ae19c1c8941757e31ddae37eae2) > > * As you scroll down, you will begin to see your Hub's key live statistics, in line with the filtering you may have set above. **Note that hovering over a term will provide you with its definition!** (But we'll define them for you here too.) > > * **(A) Impressions:** The total number of times your Hub URL has been loaded > * **(B) Total Engagements:** The total number of times your users have engaged with your content. This tracks every click on your Hub, including gameplay clicks, like items picks on the Picker Card! > * **(C) Unique Engagements:** The number of unique users that have engaged with your content > > [!NOTE] > > > > In the context of analytics, the word 'unique' is used to describe a singular user who takes an action on your Hub in a given period (i.e. the time period you have set in Step 1). This is to say that if that same user completed that same action in the same 24-hour period, this would not be a 'unique' metric. > * **(D) Engagement Rate:** The number of times that users engaged with your content as a percentage of impressions. *Unique engagements / unique impressions.* > * **(E) Entries:** The total number of data capture entries > * **(F) Entry Rate:** The number of unique entries as a percentage of impressions. *Unique entries / unique impressions.* > * **(G) Engagement Time:** The total amount of time users spent engaged with all content across your Hub > * **(H) Average Engagement Time:** The average amount of time each user spent engaged with any content on your Hub. *Total engagement time / unique impressions.* > * **(I) Sign-Ups:** The total number of user accounts created during the reporting period > * **(J) Top Sources:** Where your Hub impressions come from. This stat uses referrer, UTM source and UTM medium parameters to determine sources > * **(K) Badges Awarded:** Where you can view the number of Badges awarded across your Hub, separated into individual Badges within Badge Variants. Please note that this will only appear if you are using Badges on your Hub > > ![Analytics: hub term definitions & navigation](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-hub-term-definitions-navigation-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=4e097b120898c772f3cd8d71917b7c79) > > * **(a) Coupons Statistics:** If you are using Digital Coupons on your Hub, here you will see a breakdown of the Coupons issued, viewed and redeemed across your Cards\\ > > ![Analytics: hub term definitions & navigation](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-hub-term-definitions-navigation-screenshot-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=32c8f09ac406667e860d100c0cefe85c) > > Within Hub-level analytics, you also have a **high-level overview of each Card** side-by-side. This a great way to determine which mechanics are working best for your Hub. > > * **(a)** Here you can **filter** your Cards by their status, i.e. All, draft, published or archived > * **(b)** Here you can **search** for particular Cards > * **(c)** Here you can set the **metric** for the bar chart below, which shows the performance of your Cards side-by-side > * **(d)** Here you can see a high-level overview of the statistics most relevant to each mechanic you have on your Hub. *Clicking on each statistic will open the analytics for that particular Card for the date range you set in Step 1.* ## Accessing Card-Level Analytics ### Navigate to your chosen Card ![Analytics: navigate to your chosen Card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-navigate-to-your-chosen-screenshot.gif?s=cf9081e81ebdc8eec17fb8f193873a3b) * From your company homepage, navigate to your Engagement Hub, find your chosen Card and open the editor * From here, click on the **analytics tab** in the left navigation > [!NOTE] > > We've used our Knowledge Base Hub as an example here! This Hub is only used internally. ### Card term definitions & navigation ![Analytics: card term definitions & navigation](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-card-term-definitions-navigation-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=049eb028c8723794ec08a9b5687ed2e0) Let's go over the key navigation of this modal first up! * **(1)** Here you can set the **date and time range** you wish to apply to your analytics * **(2)** Here you can download a **.CSV file** of your Hub's users * **(3)** This **line graph** shows the number of unique impressions, engagements and entries across your Hub along the timeline you set in Step 1 * **(4)** Here, you can choose to **filter your analytics** by all users, signed-up users or non-signed-up users > **Card Analytics** > > ![Analytics: step 1 — Card term definitions & navigation](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-card-term-definitions-navigation-step-1.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=0d1605ec7fe73bea9d4623831b838dc9) > > As you scroll down, you will begin to see your Hub's key live statistics, in line with the filtering you may have set above. **Note that hovering over a term will provide you with its definition!** (But we'll define them for you here too.) > > * **(A) Impressions:** The total number of times your Hub URL has been loaded > * **(B) Engagement Rate:** The number of times that users engaged with your content as a percentage of impressions. *Unique engagements / unique impressions.* > * **(C) Completion Rate:** The number of times that users completed this Card as a percentage of the number of users that started this Card. *Unique finished / unique started.* > * **(D) Entries:** The total number of data capture entries > * **(E) Entry Rate:** The number of unique entries as a percentage of impressions. *Unique entries / unique impressions.* > * **(F) Average Engagement Time:** The average amount of time each user spent engaged with this Card. *Total engagement time / unique impressions.* > * **(G) + (H) Social Shares and Total Shares:** Here you will see the number of times your Card has been shared, and the total and unique sharing statistics. Please note that these analytics will only appear if you have sharing toggled on for your Card > * **(I)** Note that often you will find analytics specific to a certain mechanic in card-level analytics. For example, here we can see the **Total Item Picks**, which is the total number of individual items picked on our Picker Card > > ![Analytics: card term definitions & navigation](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/analytics-card-term-definitions-navigation-screenshot-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=e1d2cfedc051df9b4298f314b0d93b09) > > With Card-level analytics, you also have this **siloed funnel view of some key Card metrics**. > > * **(a)** In the **conversions funnel**, you can see which impressions started the Card, which of those users finished the Card, and of those, who entered the attached competition by filling in a data capture form > > * **(b)** In the **email funnel**, you can see the number of emails delivered, the percentage of delivered emails that were opened, and the percentage of opened emails that were engaged with (clicked, which refers to any links or buttons you may have on your emails) > > > [!NOTE] > > > > The email funnel will only appear if you have attached communications to your Card and actioned these. > > With Card-level analytics, you will also find various Card-specific analytics, which will change depending on the Card you have chosen to use. > > * **(c)** Because this Card is a **Picker**, we can see some statistics on the most selected items, etc. ## FAQ **Why do my analytics look different for each different Card I use?** Our collection of content pieces are all vastly different, to allow you to create interactive, immersive campaigns that are engaging in different ways! For this reason, it's only fitting that different mechanics should have different analytics to assist you as you test and learn different Cards on the Platform. For example, item picks (made for the Picker Card) are not going to be relevant statistics for a Live Trivia Card. # Asset Manager Source: https://knowledge.komo.tech/getting-started/hub-setup/asset-manager/index Find, manage and share the images saved in your workspace, including copying a public link to an image. ## What is it? The Asset Manager is where the images saved in your workspace live. Images you upload through the image picker on a Hub or Card are saved here, so you can reuse them across the workspace without uploading them again. ## Where to find it You can open the Asset Manager in two places: * **From any image field**: when you upload or change an image on a Hub or Card, the image picker opens the Asset Manager. Choose **Select** on an image to use it. * **From your workspace settings**: go to **Brand Kit**, find the **Images** section and click **Manage Images**. Switch between the **Grid** and **Table** views, search your images, and organise them into folders. Choose **View** from an image's menu to open it full size in the asset viewer. ## Image actions Open an image's menu to work with it: * **Grid view**: click the **⋮** menu on the image, or right-click it. * **Table view**: use the actions menu at the end of the row. * **Asset viewer**: **Download** and **Copy public image link** are buttons in the toolbar. **Rename**, **Move** and **Delete** are in the **Actions** menu next to them. The available actions are **View**, **Download**, **Copy public image link**, **Rename**, **Move** and **Delete**. **Select** also appears when you've opened the Asset Manager from an image field. ### Copy a public image link ![Asset Manager: the image menu with Copy public image link highlighted](https://mintcdn.com/komotechnologies/C-aq-RFQs6l2bnQ2/images/asset-manager-copy-public-image-link.webp?fit=max\&auto=format\&n=C-aq-RFQs6l2bnQ2\&q=85\&s=d97222ad9d24945303db314ae515a66d) Use **Copy public image link** when you need the image somewhere outside Komo, such as an email, a social post or a partner's website. 1. Open the image's menu in the grid or table, or open the image in the asset viewer. 2. Click **Copy public image link**. In the asset viewer it's the copy icon next to **Download**. 3. You'll see **Public image link copied to clipboard**. Paste the link wherever you need it. The link points to the stored image on Komo's image CDN, not a portal thumbnail. Anyone with the link can open the image. The image is served at up to 1,000 px wide. Images narrower than that keep their original width. > [!NOTE] > > **Copy public image link** is available for images only. It doesn't appear for folders, videos or PDFs. ## Related * [Design Asset Guidelines](/getting-started/hub-setup/design-asset-guidelines) * [Hub Editor](/getting-started/hub-setup/hub-editor) # Before you Hit Publish! Source: https://knowledge.komo.tech/getting-started/hub-setup/before-you-hit-publish/index Want to know how to best launch your campaign? Read on... So it's time to bring your first campaign to life, but where to start? Stress less, grab your coffee, and read on. Before we start building, we need to start with your idea. ## What are your competition ideas? Get as creative as you can; what are your ideas? What mechanics are you looking to utilize? [Check out the full (and ever-growing) list of Komo cards.](https://www.komo.tech/game-concepts) > [!NOTE] > > With the Komo platform, there's very little you can't do, but if there's something you think can't > be done, let's have a chat. ## What are you trying to achieve? Having a clear understanding of what you're trying to achieve is key. You wouldn't build a house without a design. Why launch your Hub without a goal or goals in mind? > [!NOTE] > > Don't forget the 6Ps > > Proper Planning Prevents Piss Poor Performance. You might want to base these around; Data collected, Leads generated, Awareness, and Engagement rate, to name a few. A big part of these goals will be impacted by your marketing budget, the prizes on offer, timelines, and the barriers to entry. ## What prizes are on offer? What will be the main leavers to drive traffic to your Hub? Whilst large prize budgets can have a significant impact on competition entries, usage of the budget is just as important. Based on our experience, we have seen the most success with our clients when offering multiple minor prizes and one (smaller) major prize compared to one large major prize due to the higher probability of winning. [Check out how this worked for The Cheesecake Shop here. ](https://blog.komo.tech/case-studies/how-the-cheesecake-shop-increased-brand-awareness) ## What content/mechanics? It's important to remember that your Hub can have as many pages as you need. Each page holds a maximum of **50 cards**. On top of your game/competition mechanics, look at what other engaging content you can incorporate within your hub, such as video/image content, countdown clocks, UGC, etc. Ensuring your Hub is positioned as your community's one-stop-shop for exclusive content, competitions, and games, driving engagement and increasing your ROI. > [!TIP] > > We recommend having a maximum of 2/3 competitions running at once on your Hub (depending on the > specifics of your campaign). ## The legal stuff Once you have your prizing and competition mechanic locked in, it's time to look at the legal side of your competition. Each competition will require a set of terms and conditions. [You can access our T\&Cs templates here](/getting-started/resources/terms-conditions). Here you will need to enter all the relevant information to your competition inc. Prizing, start/finish times, privacy policy, etc. Certain competitions may require additional permits. [You can review the requirements here.](/getting-started/best-practices/competition-permits) > [!WARNING] > > *Komo is not liable for any incorrectly provided information in the terms and conditions > templates. Always seek independent legal advice.* ## Building your Hub Now that all the boring stuff is sorted, it's time to look at all the little bits that come together to give you the best campaign and your users the best possible experience. ### SEM/SEO Edit your SEO settings; add a title, favicon, and meta description (that will be visible when a card is shared). Enable SEO indexing so Google can crawl your site and allow it to start showing within search engines. [You can check out how to edit your SEM/SEO settings here.](/getting-started/hub-setup/hub-settings) ### Custom Domain As much as we love to see the **.[komo.site](http://komo.site)** domain everywhere, we highly recommend you set up a white-labeled URL for your Hub (this can be a custom domain or a sub-domain to an existing site). [You can check out how to white-label your hub here.](/getting-started/hub-setup/white-labeling-your-domain) ### The Data Make the most of the traffic you are driving by adding tag managers to your hub. [You can check out how to add Google Tag Manager here.](/integrations-automation/tag-management/connect-google-tag-manager-to-your-hub) [You can check out how to add Adobe Launch Tag Manager here.](/integrations-automation/tag-management/connect-adobe-launch-tag-manager-to-your-hub) > [!TIP] > > You can also set up Webhooks to pull any data collected via your Hub directly into your > CRM/Marketing platform. Reach out to your Customer Success Specialist for assistance with this. ### User Accounts The user accounts feature enables users to create an account on your Hub, removing the need to repeatedly enter the same information to enter competitions. [You can check out how to set up user accounts here.](/account-settings/account-management/add-new-members-to-your-company) ### Market Research Questions No matter what competition you are running, make the most of asking market research questions to learn more about your community and increase your ROI. Incorporate survey-style questions within quizzes, trivia games, and more, or have them embedded in your data capture form. ### Automated Communications Drive users back to continue engaging with your content with post-game personalized communications via email or SMS (Additional costs involved). [You can check out how to set up reminders and follow-up communications here.](/competitions-promotions/setup-management/prizes-and-comms) > [!NOTE] > > Whilst there are additional costs involved in sending out SMS communications, there is a > substantially better open rate. The average open rate for SMS campaigns is 98% compared to 20% for > email campaigns. ([*99firms*](https://99firms.com/blog/sms-marketing-stats/#gref)) ### Schedule Content Set and forget! Build all (or as much as you can) of your content in advance, then schedule this to be published and unpublished when you choose. [You can check out how to schedule all of your content here.](/getting-started/hub-setup/card-scheduling) ## It's time to start driving traffic! Your Hub's performance has a direct relationship with your promotion of it. There's almost no wrong answer or way to go about promoting your Hub. [Check out our top promotion tips (and even some great examples of influencer promotion) here.](/getting-started/promotion/promoting-your-engagement-hub) ## Award your prizes! The best part is here... you are just about to make someone's day! Once your competition has ended, it's time to go in and award your prizes! [You can check out how to award prizes here.](/getting-started/hub-setup/read-me-when-your-competition-ends) ## Pull data! Now, we can export all the data you were able to collect! Make use of these leads you were able to generate by keeping in touch through ongoing marketing or announcing new competitions! [Check out how to download your data here.](/getting-started/hub-setup/read-me-when-your-competition-ends) > [!TIP] > > Once you have completed all the above, it's time to launch your campaign! # Card Scheduling Source: https://knowledge.komo.tech/getting-started/hub-setup/card-scheduling/index Schedule the time and date to publish and unpublish your content cards, and choose whether unpublished cards return to draft or archived status. ## How do I do this? ### Step 1: Schedule the card ![Card Scheduling: step 1 — Step 1: Schedule the card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-scheduling-step-1-schedule-the-step-1.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=de7cc79bafda687a01891036084a983c) * **(1)** Click **Schedule** once you've completely built out your card and are ready to schedule it. ### Step 2: Set the dates and times ![Card Scheduling: step 2 — Step 2: Set the dates and times](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-scheduling-step-2-set-the-step-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=294b40a8ca7e65fdac50e72a19a22b0d) From here you can **schedule** the time the card goes live on your **Engagement Hub**. * **(1)** Here you can set the **timezone** to reflect when you wish to schedule your Card. * **(2)** Click **Schedule Publish** to set a date and time you want the card to publish on the Hub. > **Schedule Publish** > > ![Card Scheduling: option a — Step 2: Set the dates and times](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-scheduling-step-2-set-the-option-a.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=2e707f6df7fee419b8897953a06ddf1f) > > * **(A)** Click here to select the **date** the card will publish on. > * **(B)** Here you can set the **time** the card will publish at. * **(3)** Click **Schedule Expiry** to set a date and time you want the card to unpublish on the Hub. > **Schedule Expiry** > > ![Card Scheduling: option a — Step 2: Set the dates and times](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-scheduling-step-2-set-the-option-a-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=c3a6bcd28e4111320b2e447c37afd80f) > > * **(A)** Click here to select the **date** the card will unpublish. > * **(B)** Here you can set the **time** the card will unpublish. > * **(C)** Select a **Status after un-publish**: > * **Draft** (default) — the card returns to draft status so you can edit and republish it later. > * **Archived** — the card is archived, removed from any pages, and associated game state (for example trivia questions) is reset. Use this when the campaign is fully complete. * **(4)** Click Save once you're happy with the selected date and time. > [!NOTE] > > The **Status after un-publish** option only appears when you set an un-publish date. ### Step 3: Overview of the scheduled times ![Card Scheduling: step 3 — Step 3: Overview of the scheduled times](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-scheduling-step-3-overview-of-step-3.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=c372908c5d61532d3e50e3e98d3bcd61) * **(1)** If you change your mind and want to immediately publish the card, you can click **Publish** now. * **(2)** You can **edit** the dates and time of the schedule here. * **(3)** Here is an overview of the **scheduled times.** ### What happens when a scheduled unpublish runs When the scheduled unpublish time arrives: * The card is automatically taken off the Hub. * If the target status is **Draft**, the card returns to draft and can be edited or republished. * If the target status is **Archived**, the card is archived. Archiving also removes the card from all pages it appears on and resets any associated game data (such as trivia or predictive game questions). Restoring those elements later requires manual re-setup. # Card Testing Source: https://knowledge.komo.tech/getting-started/hub-setup/card-testing/index Want to know how to test your cards before publishing? Read on... Once you have built out your cards, it is always best to do a test run to ensure you have set up everything correctly. Below is a guide on how to test your cards. ## How do I do this? ### Step 1: Clone the Card ![Card Testing: step 1 — Step 1: Clone the Card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-testing-step-1-clone-the-step-1.gif?s=34573c4b1d92c72ebe068edbf63eb1ed) * Navigate to your **Engagement Hub**. * Scroll to the card you want to test. * Click on ... and then select **Clone**. * Add the copy **Testing** to the **internal name** to differentiate between the original and the cloned. > [!NOTE] > > We recommend cloning cards for testing as once you interact with the content, this will impact the card analytics. ### Step 2: Test the Content There are two ways to test your content prior to launching. * **Preview**: This allows you to view the journey and experience of just the card/content. The preview will appear as a pop-up over the editor. * **Single Card View** : You can preview the card on the Hub to see how this would potentially look with your Hub styling. > [!WARNING] > > As this is a testing process, do **not** publish the card. If the card is published on the Hub, users will be able to view the content. ## Preview the Card ![Card Testing: preview the Card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-testing-preview-the-card-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=b818e5bbc3068e28b1244a53b1d488dd) * (1) Clicking on **...** opens additional settings for the card. (2) Click on **Preview** to test the card. > [!NOTE] > > ![Card Testing: option a — Preview the Card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-testing-preview-the-card-option-a.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=e9959ccb522186a995603e38e7025c97) > > * **(A)** Here you can play through the experience as a potential end user. > * **(B) + (C)** You have the option to test the card in a mobile view or desktop. * **(3)** After you have finished testing your game, **archive the testing card** to avoid confusion with the original. ## Single Card View ![Card Testing: single Card View](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-testing-single-card-view-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=f78f4558f500e7dac8afc67d93a84399) * **(1)** Clicking on ... opens additional settings for the card. * **(2)** Click on **View single card** to test the card. > [!NOTE] > > ![Card Testing: option a — Single Card View](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-testing-single-card-view-option-a.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=13909a4ae7e9f02deefa659d68c8c2a7) > > * **(A)** When previewing a draft card, you will see the **draft banner** to make you aware the card is still in draft mode. > * **(B)** Click on the card and **preview the experience**. # Custom Email Sender Names Source: https://knowledge.komo.tech/getting-started/hub-setup/custom-email-sender-names/index Set up a custom sender name for your emails. ## What is it? Create a new sender email with your personalised domain to fully brand your emails. Here you can connect your marketing emails to your Komo communications and include a reply-to email to allow users to reach out to. ## How do I set it up? ### Step 1: Navigate to your Account Settings ![Custom Email Sender Names: step 1 — Step 1: Navigate to your Account Settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/custom-email-sender-names-step-1-navigate-to-step-1.gif?s=fb577b0445f161570bcc94b6adf5f73a) * Head to your **Hub** then select your **icon** on the top right of the Komo portal. * Click on **Account Settings** followed by **Custom sender domains**. ### **Step 2: Set up a new Domain** ![Custom Email Sender Names: step 2 — Step 2: Set up a new Domain](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/custom-email-sender-names-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=9bae921e806fcb4d88ab9c35ea8a07e8) * Click on **Set up a new Domain.** * **(1)** Add the **domain** you would like to send emails from. > [!NOTE] > > You must have access to this domain’s DNS records in order to verify it. ### Step 3: Verify your Domain * Head over to your DNS provider and add DKIM and Return-Path DNS records to verify your domain and ensure effective delivery. * Click on the **...** and then select **Verify**. > [!NOTE] > > Once verified, the DKIM Verified and Return-Path Verified columns will change to a tick. ### Step 4: Add your sender name ![Custom Email Sender Names: step 4 — Step 4: Add your sender name](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/custom-email-sender-names-step-4-add-your-step-4.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=50423d9b2180a0c72b6c964ba96afd4e) * Click on **Add** to set up your sender email. * **(1)** Here is where you'll enter an **internal name.** * **(2)** Using the drop-down, select the **domain** you wish to use. * **(3)** Enter the **email** you wish to use before the domain. * **(4)** Include a **from name** that will appear with the email. * **(5)** Add a **reply to** email here for users to email when they receive your communications and have any follow-up questions. ### Step 5: Mark the sender email as Default ![Custom Email Sender Names: step 5 — Step 5: Mark the sender email as Default](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/custom-email-sender-names-step-5-mark-the-step-5.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=9076a60c587e5e64e7f0d659019bf31c) * **(1)** Click on the **...** next to the sender email. * **(2)** Select **Mark as default**. > [!NOTE] > > Marking the sender email as default to automatically use this email for all communications created. ## FAQ **Can I have multiple sender emails?**\ Yes, you can have different sender emails set up. To select a different sender email when creating a communication, use the **Sender info** drop-down and select the email you wish to use. **Do I need to mark an email as default?** We do highly recommend marking one as default so this sender email will always be used when you set up a communication. This is to avoid using the incorrect email if you have multiple setups. **Can I edit already created sender emails?**\ Yes, if you click on the **...** next to the email, you have the option to edit, mark/remove as default or delete. **What if we require an SPF record to enable a 3rd party to send emails on behalf of our domain?** SPF records are not required, provided you have DKIM and Return Path set up, which Komo requires to set up a custom email domain. If you still wish to add the SPF record, [you can see how to do this here.](https://postmarkapp.com/support/article/1092-how-do-i-set-up-spf-for-postmark) # Data Capture Source: https://knowledge.komo.tech/getting-started/hub-setup/data-capture/index Want to know how to set up a data capture as well as prizing and communications for one of your cards? Read on... ## What is it? If you're wanting to run a competition on your card you'll need to add a data capture form. This form allows you to gather entrant information whilst also granting the ability to send communications and prizing. > [!TIP] > > Create a Default Form and save yourself time by not having to set this up each time you create a new competition. Learn how to do this here: [Default Data Capture Form](/getting-started/hub-setup/default-data-capture-form/index). ## How do I set it up? ### Step 1: Add a Data capture to your card ![Data Capture: step 1 — Step 1: Add a Data capture to your card](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-1-add-a-step-1.gif?s=ec0159990c85ce8f3322442977942ea6) * Once you have created your card's content and are ready to edit the data capture form, navigate to the **Data capture** tab of your Card's editing modal. * Click on Form > [!NOTE] > > If you're using a card where a data capture form is optional, you will need to click **+ Add Data Capture** which will appear when selecting the **Data capture dropdown**. * This will reveal **additional settings** on the right-hand side that you will use to set up your competition. ### Step 2: Configure your data capture settings ![Data Capture: step 2 — Step 2: Configure your data capture settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-2-configure-your-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=f943630459897c930e8f6d8757b0bac4) * **(1)** By clicking on the pencil icon here, you can configure **how many times you'd like users to be able to enter your competition**. The options are as follows: * ***Single*** — Users can only enter once. * ***Throttled using a rolling window*** — Entries are throttled based on a specified frequency from the current time (e.g. once per hour, once per day). * ***Throttled using a start time*** — Entries are throttled based on a specified frequency from a specified start time (e.g. if the start time was less than one hour ago but entries are throttled for every hour, users cannot enter again until the next hour). * ***Unlimited*** — Users can enter as many times as they like. * **(2)** Adding a **close time** will prevent people from entering the competition after a certain point. > [!NOTE] > > This is only relevant for content cards with an optional data capture element. Users will still be able to play through the card; the data capture will just not appear after completion. If you don't want users to play through after the close time has passed, you can **schedule** this card to expire at a set time. * **(3)** Here you can configure the **unique entry validation rule** that will detect if a user has already entered your competition. > [!NOTE] > > Email and mobile number will be applied by default depending on the fields included in the data capture. * **(4)** Here you can also attach a reference table that validates each data capture entry against a reference table entry. This is optional and can be set up following [this Knowledge Base Article](/crm/communications/reference-tables). * **(5)** Here you can choose the form fields to be updated when a reference table match is found. * **(6)** Here you can remove the data capture. > [!NOTE] > > This is only possible for content cards with an optional data capture element. This will delete the entire competition element attached to this card. * **(7)** Clicking here will allow you to **edit the call to action text**. ### Step 3: Set up your form ![Data Capture: step 3 — Step 3: Set up your form](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-3-set-up-step-3.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=1326f2dcd0682d8f0536c272fea61ec2) * **(1)** By clicking **Form** you are able to alter the journey your users will take when entering your competition. * **(2)** This section allows you to customize your **form**. * **(3)** Click here to **upload a header image**. * **(4)** Here you can **customize the copy** within the header of your form, e.g. "Enter to win". * **(5)** Here you can also add a **description** to go below the header of your form, e.g. "Fill in the form below to go in the draw to win x!" * **(6)** These are your **data fields** and comprise the information the user will need to supply in order to enter your competition. You can edit these fields by clicking on them. * **(7)** Scrolling down, there is a terms and conditions opt-in. By clicking on this field, you'll be able to [attach your competition's terms and conditions](/getting-started/resources/terms-conditions). * **(8)** You can add to these fields by clicking the + icon. > [!NOTE] > > ![Data Capture: step 2 — Step 2: Configure your data capture settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-2-configure-your-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=f943630459897c930e8f6d8757b0bac4) > > There's nothing that can't be asked in this form in some way or format. > > * **(A)** Firstly, you have the ability to select **existing properties** or **consent fields (marketing opt-ins)** to include in your form. Displayed here will be all the contact properties created for your company. > * (B) Click here to create a new **contact property.** [**Learn how to create contact properties here.**](/crm/contacts/contact-properties/index) * **(9)** Here you can edit the **color and copy of the call-to-action.** * **(10)** Here you can **edit** the **confirmation message banner content.** > [!NOTE] > > ![Data Capture: option a — Step 3: Set up your form](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-3-set-up-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=fef04dee93ddcec43c0c131eb391c4b1) > > * **(A)** Click here to **edit the confirmation banner image**. > * **(B)** Click here to **edit the copy** that appears when a user has completed the form. > * **(C)** Here you can **toggle on and off** whether you want the **confirmation message banner** to be displayed. > * **Confirmation banner colors** — with the form step selected in the sidebar, set colors for the confirmation banner (shown when **Show confirmation message banner** is on). * **(11)** Here you can **edit** the **closed message banner content**. > [!NOTE] > > ![Data Capture: option a — Step 3: Set up your form](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-3-set-up-option-a-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=956023fb8955062c01d03596805a765a) > > * **(A)** Click here to **edit the closed banner image**. > * **(B)** Click here to **edit the copy** that appears when the completion is closed (if you have a close time set to your card). > * **(C)** Here you can **toggle on and off** whether you want the **closed message banner** to be displayed. > * **Closed banner colors** — with the form step selected in the sidebar, set colors for the closed banner (shown when **Show closed message banner** is on). ### Prefill and auto-submit Prefill and auto-submit are separate form settings. **Prefill** fills matching fields from `komo_f:=` query parameters on a hub or single-card URL. Values are stored for the browser session, stripped from the URL, and applied when the form opens. Prefill does not submit the form. A field's **Pre-fill this field with data from the contact** setting only controls whether Komo fills it from the contact's saved details. Turning it off does not block `komo_f:` link values. **Auto-submit** controls whether the form submits itself when it already has the values it needs. The default is **None**, so users still press **Submit** unless you change it: * **None** — the user must press **Submit** (default). * **Required** — the form auto-submits when every required field already has a value (from the contact's saved details, a field default, or a `komo_f:` link). * **All** — the form auto-submits when every field already has a value. If the URL already has a `?`, append further parameters with `&`. ```text theme={null} ...komo.site/card/?komo_f:email={{email}} ``` For embeds in a React Native app, pass `formPrefillValues` instead. See [Mobile App Integration](/integrations-automation/mobile-app-integration) and the [Forms developer docs](https://developers.komo.tech/forms/). ### Step 4: Create your communications ![Data Capture: option c — Step 4: Create your communications](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-4-create-your-option-c.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=759eda0915b1367cb7afe9433f0a94b6) Clicking on the **Communications** tab will provide an overview of all the communications participants could receive by engaging with your card. * **(1)** Navigate to the **Communications** tab of the Data Capture dropdown menu. * **(2)** Click on **+ Add communication** to begin creating a new communication. * **(3)** Add an **internal name**. This is internal and the name won't be seen by the recipients. * **(4)** Here you can set whether your recipients will receive the particular communication via a **transactional email, marketing email, or SMS**. * **(5)** Set the **conditions** that need to be met in order for an entrant to receive this communication. The three options here are: * **Manually sent** — Requires you to select an entrant/entrants to receive the communication. * **On form complete** — Once a user submits the form they will trigger this communication. * **At a scheduled time** — All entrants will receive the communication at the set time. > [!NOTE] > > After clicking **Create,** this screen will pop up and you can then customize your communication. > > #### **Email Communications** > > To send email communications, you'll need to have the email field on your form. > > ![Data Capture: option a — Step 4: Create your communications](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-4-create-your-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=de6776e17115f783339dacaced502631) > > **(A)** Update your communication internal name. > > **(B)** Select the sender's name. By default, this is set to your Company name in the portal. If you can't find a sender name, click on Add or edit senders to add to your current list. > > **(C)** Here is where you'll add a subject line. > > **(D)** Here you can enter the Preheader which is the first line of text that appears in the inbox after the subject line. > > **(E)** Mark this checkbox if you want to paste an HTML code to create your email. Design and create your email on your CRM, copy the HTML code and paste it in the text box. > > **(F)** Use this area to construct your email. Utilize the toolbar to format and style your email. > > **(G)** Here you can insert images and buttons and edit the email layout. You can also insert email variables. Copy and paste these codes into your email to personalize your communications by pulling data collected when your user fills out the form. > > **(H)** Here you can edit the body and container colors. > > **(I)** To send each entrant their own unique coupon, use a workflow. See [Issue a coupon to everyone who submits a form](/competitions-promotions/digital-coupons/digital-coupons#issue-a-coupon-to-everyone-who-submits-a-form). > > **(J)** This option allows you to test the communication. > > > [!NOTE] > > > > If sending a marketing email, you will also need to select which **Communication Subscription Group** your email should be sent to and include an **unsubscribe URL code** in the email body to give users an option to opt-out. This will ensure the email is only sent to users who have opted in to the selected subscription communications. > > > > For more information on setting up Communication Subscriptions, [read this article](/crm/communications/communication-subscriptions/index). > > #### **SMS Communications:** > > To send SMS communications you'll need to add an SMS field to your form. > > ![Data Capture: step 4: Create your communications](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-4-create-your-screenshot.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=f6ec8ce1aeb2e89e61db870e8943f950) > > > [!WARNING] > > > > To send SMS communications (per current regulations), you will need to have a Twilio account. [Learn how to set this up](/getting-started/hub-setup/sms-sender-ids/index). > > * **(A)** Update your communication internal name. > * **(B)** Select the SMS sender name. > * **(C)** Construct your SMS message here. > * **(D)** Copy and paste these codes into your email to personalize your communications by pulling data collected when your user fills out the form. > * **(E)** To send each entrant their own unique coupon by SMS, use a workflow. See [Issue a coupon to everyone who submits a form](/competitions-promotions/digital-coupons/digital-coupons#issue-a-coupon-to-everyone-who-submits-a-form). > * **(F)** Here you can test the SMS. ### Step 5: Set up your prizes ![Data Capture: step 5 — Step 5: Set up your prizes](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-5-set-up-step-5.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=b0e38a8d6d8a5ebd044da06992a84243) By clicking on the **Prizes** tab within the **data capture** dropdown, you will see an overview of your competition's prizes. * Create your first prize by clicking on **+ Add Prize**. * **(1)** Give your prize an **internal name** that makes it easy to keep track of. * **(2)** Click on the **Edit prize rules** button to set your rules. > [!NOTE] > > * Decide how you want to **award your prize**. You can choose one of the following: > * **(A) Manual** - Allows you to pick a winner later and manually select an entrant/entrants to receive the prize. > * **(B) Manual (rule based)** - Allows you to manually award a prize to everyone or randomly drawn entrants who meet pre-determined filter criteria. > ![Data Capture: option a — Step 5: Set up your prizes](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-5-set-up-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=29ff4d836f3f59a76d43e633e9b457c4) > * **(a)** Here you can select whether you would like to manually award the prize to **everyone** who meets the filter criteria set in **Step (c)** below. > * **(b)** Here you can opt to award the prize to a user who meets the filter criteria set in **Step (c)** drawn at random. > > ![Data Capture: option c — Step 5: Set up your prizes](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/data-capture-step-5-set-up-option-c.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=70d1cfd934f200b8fe3c9c59da7b5371) > > * **(I)** In the **Limit** section you can set the total number of random users who can be awarded the prize. You also have the ability to toggle on or off the **Group by email toggle** to ensure each user with a unique email is only counted once when randomly awarding prizes. > * **(c)** Here you can set the **filter criteria** users must meet to be eligible for the prize. > * **(C)** **Continuous (instantly award when criteria met)** - Allows you to automatically award prizes to all users as soon as they meet pre-determined filter criteria. > > [!NOTE] > > > > If using continuous prizing, you will need to ensure this is enabled prior to go-live. > * **(a)** Here you can **limit** the total number of random users who can be awarded the prize when they meet the criteria set in **Step b.** > * **(b)** Here you can set the **filter criteria** users must meet to be eligible for the prize. > * Once your satisfied with your settings, click **Save.** (3) + (4) Refer back to [Step 4](#step-4-create-your-communications) to configure communications. ### Step 6: Manage your entries Once your competition is live and entries start coming in, you'll need to manage them effectively. Click on the Entries tab within your Data capture dropdown to access comprehensive entry management tools. * **(1) Search & Filter:** Use the search bar and column filters to find specific entries or apply status-based filtering. * **(2) Entry Status:** Monitor which entries are Qualified vs Disqualified based on your entry rules. * **(3) Bulk Operations:** Select multiple entries using checkboxes to perform bulk actions like tagging or status changes. * **(4) Export Entries:** Download filtered entry data for analysis, prize fulfillment, or reporting. * **(5) Entry Details:** Click on individual entries to view detailed information and make manual adjustments. > Advanced Features: For comprehensive entry management capabilities including advanced filtering, bulk operations, and automated workflows, see our detailed [Entry Management](/interactive-features/features/entry-management) guide. > Fraud Prevention: Entry management works seamlessly with [Entry Rules](/interactive-features/features/entry-rules) to automatically filter spam and unwanted entries while maintaining data integrity. ## Common gotchas > **The "Enter competition" button on the results screen does nothing** > > If your card shows an **Enter competition** button on the results screen but tapping it does not open the data-capture form, the culprit is usually the **Result shows form** toggle in the result settings. > > * Open the card's **Content** tab and navigate to the **Result** screen configuration. > * Toggle **Result shows form** to **ON**. > * Republish the card. > > Some result configurations only show the form on a perfect score (e.g. a Quiz where you have set the form to appear only when the user gets 100%). If that is intentional, the button behaviour is expected — the button only becomes actionable once the user achieves the qualifying score. If it is not intentional, remove the score condition on the form visibility rule. > **Form elements on the preview are selectable, not just visual** > > The form editor in the sidebar shows a live preview of each field. Clicking a field selects it for editing — it is not just a display. If a field appears to have been added when you did not intend to add it, click the field, then click the **X** or **Delete** icon in the sidebar to remove it. > **Entry rules disqualify entrants after the form is submitted, not before** > > [Entry rules](/interactive-features/features/entry-rules) run at submission time. An entrant who trips a rule (e.g. IP address, email domain block) will still see the confirmation screen, but their entry is marked as **Disqualified** in the Entries tab. > > This has downstream implications for [Workflows](/integrations-automation/workflows/index): > > * The **Data captured (qualified only)** trigger will **not** fire for disqualified entries. > * The **Data captured (Including disqualified)** trigger fires for every submission. > > If your prizing or communications rely on the qualified-only trigger and an eligible entrant is being missed, check the Entries tab for a Disqualified status and review your [entry rules](/interactive-features/features/entry-rules). > **Manual prize awards need a "Prize awarded" workflow, not "Data captured"** > > A common trap when manually awarding a prize to a specific entrant: > > * Your original workflow is triggered by **Data captured (qualified only)** — it sent the prize when the entrant first submitted the form. > * The entrant was disqualified (or never received the prize for another reason), so the trigger did not fire. > * You go to the Entries tab and manually award the prize — but nothing sends, because the workflow is still listening on the data-capture trigger, not on prize awards. > > Fix: clone the workflow and change the trigger to **Prize awarded**. Manual prize awards emit a `Prize.Awarded` event, so the cloned workflow will fire for every manual issue. You can keep both workflows live — one for the automatic path and one for manual re-issues — or consolidate on the `Prize.Awarded` trigger if that fits your model. > > See [Workflow triggers](/integrations-automation/workflows/triggers) for the full trigger reference. ## FAQ **What is the difference between a marketing and transactional email?** A marketing email is any email that is intended to promote your brand and push recipients to perform an action you want them to take. A transactional email differs in that it provides necessary information that the recipient requires in order for you to adequately complete a transaction or deliver your service. Transactional emails tend to be initiated off the back of an action taken by the recipient. **What happens when a user unsubscribes?** If a user clicks through and unsubscribes from communications, they will automatically be removed from the communication subscription they opted out of and will no longer receive the emails sent to that list. **Does pre-filling a form also submit it?** No. Prefill (`komo_f:` link values saved to the session) only fills fields. Auto-submit is a separate setting and defaults to **None**, so users still press **Submit** unless you set auto-submit to **Required** or **All**. # Default Data Capture Form Source: https://knowledge.komo.tech/getting-started/hub-setup/default-data-capture-form/index Create a quick and easy default form to use for all competitions. If you plan to Add Data Capture to your Content Cards, we recommend taking a few minutes to set up your Default Form in the Hub settings before getting started. This default form automatically attaches to competitions, so setting it up in advance will save you time - especially if you plan to run multiple competitions. > [!NOTE] > > This feature will only add the data capture form when it is first created; you are still able to alter the Data Capture on a case-by-case basis to suit whatever competition you are running. ## How to build one: ### Step 1: Go to the Hub settings ![Default Data Capture Form: step 1 — Step 1: Go to the Hub settings](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/default-data-capture-form-step-1-go-to-step-1.gif?s=d9d4a227ba130375992b09024d3337e5) * Navigate to your **Engagement Hub.** * Click on the **Settings** tab and then head to the **Data Capture** tab. ### Step 2: Edit your Default Form ![Default Data Capture Form: step 2 — Step 2: Edit your Default Form](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/default-data-capture-form-step-2-edit-your-step-2.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=6829e5c6ed35b50cbe2628a60a6a998a) * **(1)** Here we can add the form **cover image**. You may choose to alter this depending on the competition you are planning to run. However, setting a simple image here (e.g. a logo) will add it to your form. * **(2)** Here you can alter the **title** and **description** that will sit above your data capture fields. * **(3)** Here we are looking at the specific **data capture fields**. * **(4)** Hovering over each field, you can edit the **additional settings** such as making it a required field. * **(5)** Scrolling down, clicking on the plus icon, you can add as many **additional fields** as you would like, such as a marketing opt-in. > [!NOTE] > > ![Default Data Capture Form: option a — Step 2: Edit your Default Form](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/default-data-capture-form-step-2-edit-your-option-a.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=85991d1e290f844591c5191ee7bf667a) > > * **(A)** Add existing contact properties to the default form. If you don't have any created, [follow these steps](/crm/contacts/contact-properties) to create properties that you will consistently use overtime. > * **(B)** Create new fields to add to the default form. > > [!NOTE] > > > > You can create a contact property here. * **(6)** Here you can alter the **copy and colors** of the submit button. ### Step 3: Add Content ![Default Data Capture Form: step 3 — Step 3: Add Content](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/default-data-capture-form-step-3-add-content-step-3.gif?s=0464ed696fc232d2e7d507882a289701) * Navigate back to the **Editor page** and add a content card to your Hub. ### Step 4: Add a Data Capture ![Default Data Capture Form: step 4 — Step 4: Add a Data Capture](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/default-data-capture-form-step-4-add-a-step-4.gif?s=4bb1a5c0708cf3e59e65941111cc0594) * Clicking on the **card** will open the editing module. * Head to the **Data Capture** tab and then click **Add Data Capture**. * Clicking on **Form**, you will see the Default Form has been added. # Design Asset Guidelines Source: https://knowledge.komo.tech/getting-started/hub-setup/design-asset-guidelines/index View and download the guidelines and templates for your Engagement Hub, Live Trivia, and Digital Coupons. Use the resources below to ensure your creative assets meet the requirements for the Komo platform. ### **Design Guidelines** To help you understand the visual requirements for each product, we have provided comprehensive guidelines for our hubs and cards. Using these specifications ensures your content is optimized for the Komo platform, providing a seamless and high-quality experience for your users. View hub and card design guidelines presentation ![Design Asset Guidelines: design Guidelines](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/kba-hub-card-dsgn-guidelines-2.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=8763190724878a9350757e6cea5036cf) [Open](https://docs.google.com/presentation/d/1pWj8mh1TdBxVx7ZhLxS8vt3QVwUJxi8sDyITsIhk3MM/edit?usp=sharing) View advanced hub and card design guidelines presentation ![Design Asset Guidelines: design Guidelines](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/kba-hub-card-advance.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=bb53b21bb84556171f6f01d29b359c69) [Open](https://docs.google.com/presentation/d/1pWj8mh1TdBxVx7ZhLxS8vt3QVwUJxi8sDyITsIhk3MM/edit?usp=sharing) **Design Templates** To help you translate your ideas into the card templates you see on the platform, we've made our hub & card Figma file available for download. Using these pre-built files ensures your designs are perfectly scaled for the Komo portal, saving you the time of setting up dimensions from scratch. Open hub and card Figma templates ![Design Asset Guidelines: design Guidelines](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/kba-hub-card-figma-1.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=0e64b4d554e473ee597c5fa6d26a5514) [Open](https://www.figma.com/design/x4iC8tkKDrUVDcFmFFrKRD/Card-Templates--EXTERNAL-?node-id=929-36) ## FAQs > **Can I use my own design tool?** > > Yes. Design your assets in any tool, such as Figma or Photoshop, export them, and upload them into Komo. > > For transparent card covers, export as a **PNG** with a transparent background. See [Advanced Hub and Card Designs](/getting-started/resources/advanced-hub-and-card-designs). > > The image picker includes built-in stock libraries on the **Unsplash** and **Pexels** tabs. > **What image file types can I upload?** > > The image uploader accepts **PNG**, **JPEG**, **WebP** and **SVG**. **GIF** is accepted on fields that support animation, such as card covers. > > Transparent PNGs work well for card covers. Some fields, such as Photo Frame frames, don't accept GIFs. > **Can my designs include animation or moving parts?** > > Yes. Animated GIFs work on card covers. We recommend keeping each GIF under 3MB so it loads quickly on mobile. > > For the Hub background, we recommend a static image. Animated backgrounds add file size, slow loading and can affect accessibility. > > For video, use a [Video card](/interactive-features/features/video-card) rather than a cover or background. That page lists the supported formats: **mp4**, **webm**, **HLS** and **DASH**. # Hub Editor Source: https://knowledge.komo.tech/getting-started/hub-setup/hub-editor/index Get up to speed on all aspects of the Hub Editor so you can build killer promotions in no time. ### Contents * [What is it?](#what-is-it) * [Watch it come to life](#what-is-it) * [How do I use it?](#what-is-it) ### What is it? The Hub Editor gives you the ability to create Cards on pages, customise the overall look and feel and edit page-specific settings. ### How do I use it? * [Styling](#how-do-i-use-it) * [Cards](#step-2-add-a-background) * [Page Settings](#how-do-i-use-it) ### Styling * [Step1: Open Styling](#how-do-i-use-it) * [Step 2: Add a Background](#what-is-it) * [Step 3: Edit the Header](#watch-it-come-to-life) * [Step 4: Upload a Cover image](#what-is-it) * [Step 5: Set up your Footer settings](#how-do-i-use-it) * [Step 6: Set your Button colours](#watch-it-come-to-life) ### Step 1: Open Styling ![Hub Editor: step 5 — Step 1: Open Styling](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-1-open-styling-step-5.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=dcd0884a24133e96e2b328ac91d3fa4a) * **(1)** Within Editor, click on the **Styling** tab. ### Step 2: Add a Background ![Hub Editor: step 2 — Step 2: Add a Background](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-2-add-a-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=9a484ce936bbb2abe59992d563c9a65d) * **(1)** You can have a **solid colour** as your background. * **(2)** Upload a background **image** here. * **(3)** Here you can add a colour **overlay** to your background image. > **Note:** The background will update as below.![Hub Editor: step 3 — Step 2: Add a Background](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-2-add-a-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=ea418486f6a621e96f8fc6ab7fa582b6) ### Step 3: Edit the Header ![Hub Editor: step 3 — Step 3: Edit the Header](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-3-edit-the-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=0ab0a7fa200bc82f41d268205bda3aad) * **(1)** You can upload your **logo** to sit on the header bar or toggle this option off. * **(2)** Alter the header bar **colours** here. * **(3)** If you prefer not to have the header bar visible, you can **toggle off** this feature here. > **Note:** The header will update as below.![Hub Editor: step 4 — Step 3: Edit the Header](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-3-edit-the-step-4.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=5005bbf5413d6c06832e671f2f0884c8) ### Step 4: Upload a Cover image ![Hub Editor: step 4 — Step 4: Upload a Cover image](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-4-upload-a-step-4.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=91e28762320b185aca49d061c14d1aa1) * **(1)** Here you can **upload** an image that will sit at the top of the Hub. * **(2)** You have the option to **toggle off** this feature here. > **Tip:** You can upload a transparent PNG image to create a 'floating' effect. **Note:** The cover image will update as below. ![Hub Editor: step 5 — Step 4: Upload a Cover image](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-4-upload-a-step-5.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=b209b9444cec4bc6d3cfb142cd411811) ### Step 5: Set up your Footer settings ![Hub Editor: step 5 — Step 5: Set up your Footer settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-5-set-up-step-5.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=16391e2cc3adaaf5f7cdee44c98d9459) * **(1)** Upload your **logo** here or **(2)** you can **disable** the logo here. * **(3)** Change the footer **background** colour and **text** colour. * **(4)** Here is where you'll input a brief **description** of the hub or your company. * **(5)** Clicking on the edit icon, you can paste all your **social links**; or * **(6)** turn this option **off** here. > **Note:** The footer will update as below.![Hub Editor: step 6 — Step 5: Set up your Footer settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-5-set-up-step-6.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=d40bb35f50cd98c787691f14e848b634) ### Step 6: Set your Button colours ![Hub Editor: step 6 — Step 6: Set your Button colours](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-6-set-your-step-6.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=83b9e2504e7c99ed0871a75c95a0c047) * **(1)** Here is where you can alter the colour of the **call-to-action bar.** > **Tip:** We recommend setting this up prior to creating your cards as once this is changed, all content added to the Hub will have these settings. You will also be able to change the call-to-action bar colours at the card level. > **Note:** The button colours will update as below. > > ![Hub Editor: step 1 — Step 6: Set your Button colours](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-6-set-your-step-1.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=b8f6e856a0566322bd5193962414d636) ##### Cards * [Step 1: Open Cards](#styling-step-1-open-styling) * [Step 2: Add Cards](#styling-step-1-open-styling) * [Step 3: Reorder Cards](#styling-step-1-open-styling) ### Step 1: Open Cards ![Hub Editor: step 2 — Step 1: Open Cards](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-1-open-cards-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=ee77a7e2f8ac28fe24ac3e007b1b62f2) * **(1)** Within Editor, click on the **Cards** tab. ### Step 2: Add Cards ![Hub Editor: step 2 — Step 2: Add Cards](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-2-add-cards-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=df49d5130c4ef9202a71dca521504a3d) * Add cards by selecting **(1)** + Add card, **(2)** +, or **(3)** + (only displays after the first card is created). ![Hub Editor: option a — Step 2: Add Cards](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-2-add-cards-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=5c7cdc27e65b2cdc58b0ced668313081) * **(A)** Here, you can access a range of cards that can be created **From Scratch.** As the name suggests, this involves manually working through various steps to set up your card. * **(B) From Existing** allows you to import previously created cards from the Content Card repository into this page. This saves set up time and allows you to create a card once and reuse across multiple pages. * **(C) From Templates** allows you to import Card templates that can then be tweaked to your various needs. * **(D)** Here you can search the name of the Card you're looking to import. * **(E)** Here, you can scroll through all available Cards, including **Games, Media, and Embeds** and select the option you wish to create. **Notes:** A page can hold a maximum of **50 cards**. Add content is disabled once that cap is reached. For comprehensive instructions on the creation of all available Cards, please access the detailed articles in the Content section of this knowledge base. ### Step 3: Reorder Cards ![Hub Editor: option d — Step 3: Reorder Cards](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-3-reorder-cards-option-d.gif?s=baa06f38e7430679c095783807da379d) * Reorder cards as you wish by hovering your mouse over the left-hand side of the Card tab, clicking the 6 dots and then dragging to the desired position. * You will now notice that the Card order on the page has been updated. ### Page Settings * [Step1: Open Page settings](#how-do-i-use-it) * [Step 2: Set Page details](#how-do-i-use-it) * [Step 3: Edit SEO settings](#watch-it-come-to-life) * [Step 4: Update Search and Sharing settings](#how-do-i-use-it) ### Step 1: Open Page settings ![Hub Editor: step 3 — Step 1: Open Page settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-1-open-page-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=59d646aa7812386106413b70ba8ca05e) * **(1)** Within Editor, select the **Page settings** tab. ### Step 2: Set Page details ![Hub Editor: step 2 — Step 2: Set Page details](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-2-set-page-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=3020706f70e00a6c31d1b1cc4e637600) * **(1)** Here you can edit your Page Name if desired. ### Step 3: Edit SEO settings ![Hub Editor: step 3 — Step 3: Edit SEO settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-3-edit-seo-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=584b8a7aa63def5d4a95a66afdc1ef56) * **(1)** Here you can view and edit all SEO details for your page. * **(2)** If you wish to change any details, click **Edit.** ![Hub Editor: option a — Step 3: Edit SEO settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-3-edit-seo-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=e0659394dc523ea469575ece14bf0cb9) * **(A)** Here you can edit your **Title** so that it is an optimal length for SEO purposes. * **(B)** Edit the page **Description** to provide a brief outline of the page for viewing in search engines. * **(C)** Upload a **Favicon** that will be displayed alongside the page listing in search engines. This is usually your brand logo or icon. * **(D)** Be sure to **Preview** your SEO settings to ensure you're satisfied with how they will appear publically. * **(E)** Click **Update** to confirm the settings. * **(3)** Select whether you would like **Indexing** enabled or not. Indexing determines whether the page is visible within search engines. ### Step 4: Update Search and Sharing settings ![Hub Editor: step 4 — Step 4: Update Search and Sharing settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-editor-step-4-update-search-step-4.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=3b63be06de34a97578e1124b443df973) * **(1)** Here you verify page ownership in Google Search Console by pasting in the Verification HTML tag content. * **(2)** You can upload a Sharing Image which is the image that will be displayed when sharing the page on social media platforms. # Hub Fonts Source: https://knowledge.komo.tech/getting-started/hub-setup/hub-fonts/index Want to know how to change the font for all the elements to your Hub? Read on... ## What is it? Editing Hub Fonts is a feature that gives you the ability to upload and display custom fonts on your Hub. This results in converting all the text elements of your Hub, please reach out to your customer success specialist to help devise aid you with implementation. > [!NOTE] > > This feature is currently in Beta testing. Please reach out to your Customer Success Specialist to see if you're eligible to take part in this. ## How do I do this? ### Step 1: Go to the Hub Settings ![Hub Fonts: step 1 — Step 1: Go to the Hub Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-fonts-step-1-go-to-step-1.gif?s=edc5e3504e6ea2efbafb461cc3c5f6e2) * Navigate to your **Engagement Hub**. * Click on the **Settings** tab and then head to the **Styling** tab. ### Step 2: Upload Custom Font ![Hub Fonts: step 2 — Step 2: Upload Custom Font](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-fonts-step-2-upload-custom-step-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=1ce7a3a9326ffbd417747220731c1ade) * (1) Click on **Upload font**. * (2) Give your custom font a **name**. * (3) **Upload** a new custom font. > [!NOTE] > > **Note:** The font file needs to be TFF, WOFF or WOFF2. > > ![Hub Fonts: option a — Step 2: Upload Custom Font](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-fonts-step-2-upload-custom-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=b41201620dea4763ecbb99b82375ce69) > > * **(A)** You will see a list of all custom fonts uploaded. Click ... to **edit** the name of the custom font. > * **(B)** Upload **additional custom fonts** by following the previous steps. > * **(C)** Using the drop-down, **select the custom font** you wish to use for your Hub. ### Step 3: Preview feature ![Hub Fonts: option c — Step 3: Preview feature](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-fonts-step-3-preview-feature-option-c.gif?s=87436a17937e7dc156dce876c5904a21) * Navigate to the **font end of the Hub** to preview the application of your custom font. > [!NOTE] > > The custom font only applies to text/HTML areas on the Hub and content cards. Any text within images will not be affected. ## FAQ **Can I change my Hub Fonts at any time?** Yes, you can update your font by using the drop-down and select from the provided list of fonts or from your custom list. **How many fonts can I choose from?** The Komo platform provides 12 fonts to choose from, however, you can add as many custom fonts as you would like. **Can I have more than 1 font applied on the Hub?** Unfortunately, the Hub can only support one font across the whole Hub. You cannot have multiple fonts applied to different areas of the Hub. # Hub Settings Source: https://knowledge.komo.tech/getting-started/hub-setup/hub-settings/index Set up your default settings and save time later on! As you begin your Hub-building journey, your Hub settings are a great place to start. These default settings will save you time and energy in the long run and set you up for success from the start! ## Hub Settings ![Hub Settings: hub Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-hub-settings-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=08e062a5ff05d8d427be37ec67c25671) * **(1)** Head to the **Settings** tab and **(2)** click on **Hub** to access the settings. * **(3)** Edit the **Internal Name** of the Hub you have just created. * **(4)** Add a custom **Hub entry condition screen.** As an example, some of our customers use this to ensure users are over 18 before they're granted entry to their Hub. This will appear as soon as a user tries to access your Hub and content. [**Click here to learn more.**](/interactive-features/features/entry-condition-screen/index) * **(5)** Enable **real-time content updates** , which will update content on your Hub and alert your users of this new content in real-time with a **'new content available'** notification. * **(6)** Set your **draft preview password**, allowing your internal team or clients to view your completed Hub as a draft without using an open URL that could be accessed by your consumers before you're ready. We provide a pre-generated one for you, but you can always change it! ## Styling Settings ![Hub Settings: styling Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-styling-settings-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=fe59ede3c38c48353442968fd416b1f3) * **(1)** Click on **Styling** to navigate to these settings. * **(2)** Here you can add your **brand colors** making styling your Hub easier. > [!NOTE] > > When you alter colors on the Hub, your brand colors will appear as options to select from. > > ![Hub Settings: styling Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-styling-settings-screenshot-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=2b1615bcc798819ba02a87787682c3bb) * **(3)** Select the **font** for the text on your Hub to display in. You can read more about setting this up [**here.**](/getting-started/hub-setup/hub-fonts/index) * **(4)** Upload **custom fonts**. This will allow you to use your own brand's font instead of one of the fonts we have provided for you. You can read more about setting this up [**here**](/getting-started/hub-setup/hub-fonts/index). ## User Settings ![Hub Settings: user Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-user-settings-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=d203b1d77eb1faeec393ef44c0edd74c) * **(1)** Click **Users** to enter the settings. * **(2)** Here you can **enable Profiles** allowing users to identify themselves with an avatar while they engage with the games across your hub. You can read more about setting up this feature [here](/interactive-features/features/badges-and-workflows#step-8-enable--configure-profiles-optional). * **(3)** Enable **Badges** allowing you to assign achievements to certain users based on their activity within your hub. You can read more about setting up this feature [here](/interactive-features/features/badges-and-workflows/index). * **(4)** Edit the **contact verification process.** It's a way to verify that a person is who they say they are so we can keep all customer data secure (our first priority) and provide a smooth experience for returning contacts. You can learn more about setting up this feature [here](/crm/contacts/contact-verification/index). ## Site Domain ![Hub Settings: site Domain](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-site-domain-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=7acd2dddeca9a5e28f7dc840d191a3f0) * **(1)** Head to the **Domain tab** of your Hub Settings. * **(2)** **White label** if you wish to purchase a new URL for your Hub (e.g. [ACME.com](http://ACME.com)). This is where you can configure this. [Click here to learn more about this.](/getting-started/hub-setup/white-labeling-your-domain) * **(3)** Set or edit the **.[komo.site](http://komo.site)** domain name. ## Data Capture Settings ![Hub Settings: data Capture Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-data-capture-settings-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=554aa2c567bfe394ecfb8c7b2dea80d9) * **(1)** Head to the **Data Capture** tab of your Hub Settings. * **(2)** Create the **Default Form** that will be added to any Data Capture you create after this point. [Click here to learn more about this](/getting-started/hub-setup/default-data-capture-form/index). > [!NOTE] > > We highly recommend setting up your Default Form prior to building content cards - it will save you a lot of time in the long run! * **(3)** Scrolling down, you can configure your reference table validation \[optional]. You can learn more about this [**here.**](/crm/communications/reference-tables/index) ## Terms and Conditions ![Hub Settings: terms and Conditions](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-terms-and-conditions-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=7b39cd6c0f90377693c3bb53aa185181) * **(1)** Head to the **Terms** tab of your Hub Settings. * **(2)** Upload your terms and conditions to the Hub and hyperlink these terms to your competitions. [Click here to learn more about this](/getting-started/resources/terms-conditions/index). ## GDPR Settings ![Hub Settings: gDPR Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-gdpr-settings-screenshot.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=8a7ac3711bd065f80fb7ad63df7638fc) * **(1)** Head to the **GDPR** tab of your Hub Settings. * **(2)** Enable and configure your **Cookie Consent banners**. > [!NOTE] > > Once enabled, click the **Edit Cookie Consent Banner** button and follow the steps below:\\ > > ![Hub Settings: option b — GDPR Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-gdpr-settings-option-b.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=c5eb5800dd6b073aac9978c6edc707b0) > > * **(A**) To edit the copy of the banner, click on the text input modal. > * **(B)** Here you can edit the background and text colors of your banner. > * **(C)** Here you can edit the text and background colors of the CTAs. ## Integrations ![Hub Settings: option b — GDPR Settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-settings-gdpr-settings-option-b.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=c5eb5800dd6b073aac9978c6edc707b0) * **(1)** Head to the **Integrations** tab of your Hub Settings. * **(2)** Connect your Google Tag Manager, Webhooks, Slack, Zaps, external CRM, and other external software to the Komo ecosystem. Click [**here**](/integrations-automation/tag-management) to learn more about integrations and webhooks. **Once you've got all your Settings ready it's time to start building your Engagement Hub!** Head back to the **Editor** tab, look for the **Add Content** button, and start playing around with the ever-growing list of Komo content cards and begin engaging your community! # Komo AI (Kai) Source: https://knowledge.komo.tech/getting-started/hub-setup/komo-ai-kai/index Use AI to generate reverse briefs, creative ideas, and test-ready cards from a single prompt, directly within Komo. ## What is it? Using Kai, you can generate campaign ideas, reverse briefs, and fully structured, test-ready cards from a single prompt, all within your Komo hub. Kai is designed to accelerate your workflow and reduce manual setup across supported card types. Read on to learn how to get started and make the most of Kai. ## Watch it come to life [Loom video player](https://www.loom.com/embed/140d24a5e1b64c9a966e221cc7f114d2) ## How do I do it? ### Step 1: Enable Kai across your organization ![Komo AI (Kai): step 1 — Step 1: Enable Kai across your organization](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-1-enable-kai-step-1.gif?s=1366995fcf13f89553a0c3ee77080a63) * Navigate to your **hub** and click the **Chat with Kai/Stars button** in the header bar. * Check the **Opt in box**. * Kai will now be enabled for your organization. * You can now exit this modal. > [!NOTE] > > Only users with Owner permissions will be able to enable Kai. If you do not have these permissions, please reach out to the stakeholder within your organization who has these permissions. > > Kai can also be enabled by accessing the 'Create with AI' modal which can be found when adding a card to your hub. ### Step 2: Add an AI-enabled card to your hub ![Komo AI (Kai): step 2 — Step 2: Add an AI-enabled card to your hub](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-2-add-an-step-2.gif?s=c24277b7ab45522f0daa6411c39e250c) * Navigate to your **hub** and click **Add card**. * Select the **AI tag** in the list of tags. * Select the **AI-enabled** card you wish to create. * Click **'Create with AI**'. ### Step 3: Enter your card prompt ![Komo AI (Kai): step 3 — Step 3: Enter your card prompt](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-3-enter-your-step-3.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=d3ff4395aec0214f39800b377bce7ff1) * The Kai prompt modal allows you to enter a text-based prompt outlining the card you wish to create, or goals you have, from which Kai can generate a fully-functional card. * **(1)** Within the **prompt box** describe the card you would like to create or the goals you have. The more detailed you are with your prompt, the better the output is likely to be. * **(2)** Clicking the **Enhance prompt** button will take the text you have written and polish the prompt prior to submission. * **(3)** Clicking the **Change tone** button will take the text you have written and change its overall tone based on the tone selection you make. * **(4)** If you're **stuck for ideas** you can select one of the suggested prompts. * **(5)** Clicking the **New suggestions** button will generate 3 new suggested prompts. * **(6)** Once you're satisfied with your prompt click the **Send message** button to submit the prompt. At this point, Kai will generate a reverse brief for your review prior to building out the card in full. > [!NOTE] > > ![Komo AI (Kai): option a — Step 3: Enter your card prompt](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-3-enter-your-option-a.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=ad8170e7aba6d5861ee8ee5d43e45ebc) > > * **(A)** If Kai requires more detail prior to generating the brief, it will prompt you with clarifying questions to gather the necessary information. > * When responding to these follow up questions you can **(B)** select one of the **suggested responses** or **(C) type a response** in the response box and **(D)** click **Send message.** ### Step 4: Review Kai's reverse brief and generate the card ![Komo AI (Kai): option b — Step 4: Review Kai's reverse brief and generate the card](https://mintcdn.com/komotechnologies/hOGlJdRCRzddzv3v/images/4-1.webp?fit=max\&auto=format\&n=hOGlJdRCRzddzv3v\&q=85\&s=7e07fab6bba8faf3bfac3b424e182f2f) * Once Kai has all required information, you will be presented with a reverse brief for review prior to card creation. > [!NOTE] > > The brief can be edited by prompting Kai within the prompt box on the left hand side. You will also have the ability to make changes and edits to your card after it has been generated by Kai. * **(1)** Here you can review an Overview of the card to be created with the audience, objectives and included features like data capture forms. > [!NOTE] > > Data capture forms will be added by default for all cards that require data capture forms for gameplay. The default data capture form for your site will be used. * **(2)** Here you can see the **Colors** that will be used throughout the card. * **(3)** You will also be able to see the **card-specific** details ie. quiz questions, spin results etc. * **(4)** Clicking the **pencil** or **+** icon next to the relevant sections allows you to make direct edits to those sections prior to card creation. When clicked, you will then need to add details/instructions in the prompt box on the left. * **(5)** Occasionally, Kai will present you with an **Insight** which is a recommendation to improve the performance of your card based on your goals. You have the ability to accept or decline that recommendation. * **(6)** Within the prompt box, you can ask Kai to **make changes** to the brief prior to card creation. * **(7)** Scrolling down, you can view additional card details including **prizing**, **communications** and **form details** where relevant. * **(8)** Once you are happy with the reverse brief, click **Create card**, followed by **Yes, create**. #### Step 5: Review and edit the card ![Komo AI (Kai): step 5 — Step 5: Review and edit the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-5-review-and-step-5.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=4aaea7cbb43472e71ffe24cec3388c07) * You will now see that Kai has created your card for you. While this card is in a publishable state, we highly recommend reviewing, editing and testing prior to publishing. > [!NOTE] > > You will see that the card has been populated with basic text-based placeholder images (intended to be replaced with your brand imagery). While Kai cannot generate designed images at this point, this capability may exist in future.- (1) Click the **Card cover** to enter the card editor. * **(1)** Click the **Card cover** to enter the card editor. > [!NOTE] > > ![Komo AI (Kai): option a — Step 5: Review and edit the card](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-5-review-and-option-a.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=3bb437beb45a03bd30571da0e0da3023) > > **(A)** Within the **Setup guide** you can see each of the elements Kai has built for the card. > > **(B)** We recommend clicking through each of the **card tabs** on the left hand side to review and make any required changes to your card prior to testing and publishing. For guidance on testing, please read this article. > > **(C)** Once you are ready to publish your card, select **Publish**. ### Step 6: Generate creative ideas and campaigns with Kai (optional) ![Komo AI (Kai): option c — Step 6: Generate creative ideas and campaigns with Kai (optional)](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-6-generate-creative-option-c.gif?s=475855292230d116c0c34f4474bd7302) * Outside of generating reverse briefs and creating cards, Kai can also help you come up with creative ideas for your brief or campaign. Click the **'Chat with Kai'/Stars button** in the top header of the portal to access the prompt modal. ### Step 7: Ask Kai for creative inspiration ![Komo AI (Kai): step 7 — Step 7: Ask Kai for creative inspiration](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-7-ask-kai-step-7.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=615e69961b267119a124ec0adde64f2a) * **(1)** Within the **prompt box** describe the idea or problem you would like Kai to generate ideas for. * **(2)** Clicking the **Enhance prompt** button will take the text you have written and polish the prompt prior to submission. * **(3)** Clicking the **Change tone** button will take the text you have written and change its overall tone based on the tone selection you make. * **(4)** If you're **stuck for ideas** you can select one of the suggested prompts. * **(5)** Clicking the **New suggestions** button will generate 3 new suggested prompts. * **(6)** Once you're satisfied with your prompt click the **Send message** button to submit the prompt. At this point, Kai will generate creative ideas for your review. > [!NOTE] > > ![Komo AI (Kai): option a — Step 7: Ask Kai for creative inspiration](https://mintcdn.com/komotechnologies/lDpX8fzjw-uBAUV9/images/komo-ai-kai-step-7-ask-kai-option-a.webp?fit=max\&auto=format\&n=lDpX8fzjw-uBAUV9\&q=85\&s=08173b9e2eca0b32271fc37338642f38) > > * **(A)** Here you can review the **creative ideas** ideas Kai has generated. > * **(B)** If you need to prompt Kai further or ask any questions you can do so within the **prompt box** and click **(C)** Send message. ## FAQ ### What can Kai help me create? Right now, Kai is designed to help you generate campaign ideas and create Cards with a single prompt. You can use Kai to: * Generate and explore campaign ideas or creative approaches * Generate a reverse brief from a simple card goal or idea * Create a test-ready card from the brief with the click of a button ### Is Kai perfect? No. Kai is fast, but not flawless. Because it is powered by generative AI, Kai may occasionally produce inaccurate suggestions, inconsistent logic, or placeholder content. It is important to ensure all content is reviewed prior to going live. ### Will Kai get better? Yes, and fast. As the beta continues, you can expect regular updates that make Kai faster, smarter, and even more useful over time. ### What are Kai's current limitations? Kai is still in beta, so there are a few things it doesn’t support yet (however, many of these capabilities will be introduced in future): * **No image generation**\ Kai will insert placeholder visuals but cannot generate custom images. * **No file uploads**\ You can’t upload assets or documents for Kai to reference. * **Single card generation only**\ Kai currently builds one card at a time. * **Card behavior may vary**\ Each card format is unique so Kai's performance will vary between cards. > [!NOTE] > > For an extensive list of FAQs relating to Kai, please access this page. # Hub Publishing vs Card Publishing, Visibility & Pages Source: https://knowledge.komo.tech/getting-started/hub-setup/publishing-visibility-pages/index Master the complete publishing workflow: hub vs card publishing, page visibility, single card pages, scheduling, and multi-page hub architecture # Hub Publishing vs Card Publishing, Visibility & Pages Understanding the complete publishing architecture is crucial for managing your Engagement Hub effectively. This guide covers hub-level publishing, card-level publishing, page visibility, single card pages, and the advanced scheduling system. ## Overview: The Three-Layer Publishing System Komo uses a **three-layer publishing architecture**: ``` Layer 1: Hub (Site) Publishing ↓ Controls entire hub visibility Layer 2: Card Publishing ↓ Controls individual card existence Layer 3: Page Visibility ↓ Controls where cards appear within hub ``` ### Layer 1: Hub Publishing **What it controls:** Whether the entire Engagement Hub is accessible to the public. **States:** * **Draft** - Hub not visible, only accessible to admins * **Published** - Hub live and accessible via domain ### Layer 2: Card Publishing **What it controls:** Whether an individual card exists and can be displayed. **States:** * **Draft** - Card exists but isn't visible anywhere * **Published** - Card is live and can be shown on pages * **Archived** - Card has been archived and removed from all pages You can also set a **publishing schedule** on a card (separate from status) so it publishes or unpublishes at a chosen time. See [Card Scheduling](/getting-started/hub-setup/card-scheduling). ### Layer 3: Page Visibility **What it controls:** Which specific pages within a hub display the card. **States:** * **Visible** - Card appears on that page * **Hidden** - Card exists but doesn't appear there You can also schedule when a card becomes visible or hidden on a page. ## Hub Publishing (Layer 1) ### What Hub Publishing Does Publishing a hub makes the entire site accessible at your configured domain: **Before Publishing:** * Hub only accessible to logged-in admins * Preview mode available * Test and refine content * Configure domain settings **After Publishing:** * Hub accessible to public via domain/URL * All published cards become visible (based on page visibility) * Analytics tracking begins * SEO indexing starts ### How to Publish a Hub 1. Navigate to **Hub Settings** 2. Click **"Publish Hub"** button 3. Confirm domain configuration 4. Review publishing checklist 5. Click **"Publish"** **Publishing Checklist:** * ✅ Domain configured and pointing correctly * ✅ At least one page has visible cards * ✅ Essential cards are published * ✅ Terms and conditions added (if running competitions) * ✅ Tested preview mode * ✅ Branding applied ### Unpublishing a Hub Unpublishing makes the entire hub inaccessible: **Use Cases:** * Ending a campaign * Major maintenance * Rebranding * Seasonal hubs (e.g., Christmas campaign ended) **What Happens:** * Public URL shows "Not Found" or custom message * All cards become inaccessible * Data and settings preserved * Can republish anytime ## Card Publishing (Layer 2) ### What Card Publishing Does Card publishing controls whether a card **exists** in the system: **Draft Cards:** * Exist in admin panel * Editable by team * Not visible to public * Can be previewed by admins * Don't count toward page limits **Published Cards:** * Exist and are live * Can be visible on pages (if page visibility enabled) * Accessible via single card page ### Publishing a Card **Method 1: From Card Editor** 1. Edit the card 2. Click **"Publish"** button (top right) 3. Confirm publishing 4. Card status changes to "Published" **Method 2: From Cards List** 1. Go to **Cards** list view 2. Find the card you want to publish 3. Click the **"Publish"** action in the card's action menu 4. Confirm publishing **Note:** Cards must be published individually. There is no bulk publish feature. **What Happens When Published:** * Card becomes available for page visibility * Can be added to hub pages * Accessible via single card URL * Analytics tracking begins * Can be shared individually ### Unpublishing a Card **Use Cases:** * Remove outdated content * End a competition * Fix errors * Seasonal content (e.g., remove Christmas card after holidays) **What Happens:** * Card disappears from all pages immediately * Single card URL becomes inaccessible * Data and entries preserved * Can republish anytime * Card returns to draft status **Important:** Unpublishing is **immediate** and affects all pages where the card appears. ### Scheduled Publishing Set automatic publish/unpublish times: 1. Edit card 2. Click **"Schedule"** button 3. Set **"Publish at"** date/time 4. Set **"Unpublish at"** date/time (optional) 5. Select timezone 6. Save schedule **Use Cases:** * Launch campaigns at specific times * End competitions automatically * Seasonal content (auto-show Christmas card Dec 1, hide Jan 1) * Time-limited offers ## Page Visibility (Layer 3) ### Understanding Pages A hub can have **multiple pages**, each with different cards: **Home Page:** * Default landing page * Usually contains main content * URL: `your-hub.com` or `your-hub.com/home` **Additional Pages:** * Create unlimited pages * Different content per page * URL: `your-hub.com/page-name` * Examples: `/games`, `/competitions`, `/vip` ### Card-Page Relationship **Key Concept:** Cards exist independently of pages, then are "placed" on pages. **One Card, Multiple Pages:** * Same card can appear on multiple pages * Example: Newsletter signup card on Home, Games, and Contact pages * Each page shows the same card (shared data/entries) **Page-Specific Visibility:** * Card visible on Page A * Same card hidden on Page B * Controlled independently per page ### Managing Page Visibility **Show Card on Page:** 1. Navigate to page editor 2. Click **"Add Card"** 3. Select existing card or create new 4. Card appears on page **Hide Card from Page:** 1. Find card on page 2. Click **"Hide"** or **"Remove from Page"** 3. Card disappears from that page only 4. Card still exists and can appear on other pages **Important:** Hiding a card from a page ≠ unpublishing the card. The card remains published and visible elsewhere. ### Visibility Schedule (Per Page) Schedule when a card appears/disappears on a specific page: 1. Find card on page 2. Click **"Schedule Visibility"** 3. Set **"Show at"** - When card appears 4. Set **"Hide at"** - When card disappears (optional) 5. Select timezone 6. Save **Use Cases:** * Flash sales (show banner 9 AM, hide 5 PM) * Event countdowns (appear 7 days before, hide after event) * Daily specials (different card each day) * Rotating content ## Single Card Pages ### What is a Single Card Page? A **standalone page** that displays only one card, without the hub navigation, header, or footer. **URL Structure:** * Hub page: `hub.com/games` (shows multiple cards + navigation) * Single card: `hub.com/?card=abc123&singleCard=true` (shows only that card) ### When to Use Single Card Pages **Use Cases:** * **Email campaigns** - Link directly to specific competition * **Social media** - Share direct link to quiz * **QR codes** - Scan to enter specific promotion * **Embedded experiences** - Link from external website * **Focused experiences** - Remove distractions for high-value conversions ### Creating Single Card Links **Method 1: Share Modal** 1. Edit card 2. Click **"Share"** button 3. Check **"Link to single card page"** checkbox 4. Copy generated URL 5. Optionally add UTM parameters **Method 2: Manual Construction** ``` https://your-hub.com/?card={card-id}&singleCard=true ``` **With UTM Parameters:** ``` https://your-hub.com/?card={card-id}&singleCard=true&utm_source=email&utm_campaign=summer_sale ``` #### Start the card straight away (skip the cover) Add `&state=AutoStart` to a card link to open the card and skip its cover. For example: ``` https://your-hub.com/?card={card-id}&singleCard=true&state=AutoStart ``` You can combine `state=AutoStart` with other parameters, such as [UTM tags](/getting-started/promotion/utm-parameters). What happens after AutoStart depends on the card type: * **Game cards start gameplay immediately:** Photo Frame, Quiz, Swiper, Spin to Win, Scratch & Win, Instant Win, Memory Challenge, Live Trivia, Predictive, Treasure Hunt, Picker, and Live Q\&A. * **Fact, Video, Number Guess, Checklist, and standard Image cards** open the entry form if the visitor can enter, otherwise the cover. * **Upload, Carousel/Vote, and banner Image cards** just show the cover. A card restricted by an access rule the visitor doesn't meet won't auto-start. ### Single Card vs Hub Page: User Experience **Hub Page Experience:** * User sees hub header/navigation * Multiple cards visible * Can browse other content * Full brand experience * Context of other offerings **Single Card Experience:** * Only the card visible * No hub navigation * No distractions * Focused on one action * Higher conversion rates for specific goals ### Analytics Differences **Hub Page Traffic:** * Tracked as hub page view * User can navigate to other cards * Session includes multiple interactions **Single Card Traffic:** * Tracked as direct card engagement * Isolated analytics for that card * Useful for measuring campaign effectiveness * Clear attribution ## Multi-Page Hub Architecture ### Creating Multiple Pages 1. Go to **Hub Settings > Pages** 2. Click **"Add Page"** 3. Name the page (e.g., "Games", "VIP Area") 4. Set page slug (URL-friendly name) 5. Configure page settings 6. Add cards to new page ### Page Types **Standard Pages:** * Regular content pages * Show in navigation (optional) **Hidden Pages:** * Don't show in navigation * Accessible via direct URL * Good for landing pages, special campaigns Pages do not support password protection. To gate access, use entry conditions / access policies on cards (for example auth, form, age gate, or loyalty rules), or hub-level entry conditions. A hub **draft preview password** lets anyone with the password view the draft hub — it is not limited to admins. ### Navigation Management **Automatic Navigation:** * Hub auto-generates navigation menu * Shows all non-hidden pages * Order based on page arrangement **Custom Navigation:** * Reorder pages in settings * Hide specific pages from nav * Add external links * Customize menu appearance ### Cross-Page Card Strategy **Shared Cards (Same Card on Multiple Pages):** * Newsletter signup on every page * Same competition across multiple entry points * Consistent branding elements * Shared data (entries, analytics) **Page-Specific Cards:** * Games only on Games page * VIP content only on VIP page * Targeted experiences * Isolated analytics ## Complete Publishing Workflow Examples ### Example 1: New Campaign Launch **Week 1: Preparation** * Create hub (draft) * Add pages: Home, Competition, Terms * Create competition card (draft) * Create terms card (draft) * Test everything in preview **Week 2: Pre-Launch** * Publish hub * Publish terms card * Set competition card to scheduled (publish Monday 9 AM) * Hide competition card from navigation until launch **Week 3: Launch Day** * Competition card auto-publishes at 9 AM * Show on Home and Competition pages * Send email with single card link * Share on social media **Week 4: Campaign End** * Competition card auto-unpublishes (scheduled) * Add "Campaign Ended" card to page * Keep terms visible for legal requirements ### Example 2: Multi-Page VIP Experience **Setup:** * Main hub: Standard content * VIP page: Exclusive competitions (gated with entry conditions) * Games page: General games * Rewards page: Loyalty program **Card Strategy:** * General signup card: Visible on all pages * VIP competition: Only on VIP page, with access conditions (for example loyalty tier or form gate) * General games: Only on Games page * Loyalty dashboard: Home and Rewards pages **Publishing:** * Publish hub * Publish all cards * Configure page visibility per card * Add entry conditions on VIP cards as needed ### Example 3: Seasonal Content Rotation **January:** * New Year promotion card (scheduled: Jan 1-31) * Visible on Home page only **February:** * Valentine's campaign (scheduled: Feb 1-14) * Replaces New Year card on Home page * Also visible on /special-offers page **March:** * Easter preview (scheduled: Mar 1-31) * Different card on Home page * Valentine's card hidden **Year-Round:** * Newsletter signup: Always visible on all pages * Contact form: Always visible on Contact page ## Best Practices ### Publishing Strategy **Do:** * Test thoroughly in draft mode before publishing * Use scheduled publishing for time-sensitive content * Keep legal pages (Terms, Privacy) always published * Create hidden pages for specific campaigns * Use single card pages for focused conversions **Don't:** * Publish unfinished cards * Forget to unpublish outdated competitions * Overload pages with too many cards (max 50) * Publish without testing mobile responsiveness ### Visibility Management **Do:** * Use page-specific visibility strategically * Schedule visibility for time-limited offers * Hide cards rather than unpublishing (if might reuse) * Monitor which cards appear on which pages **Don't:** * Leave test cards visible on public pages * Forget to hide seasonal content after holidays * Make navigation cluttered with too many pages * Hide essential cards (Terms, Contact) ### Multi-Page Architecture **Do:** * Organize content logically by page * Use clear, descriptive page names * Limit navigation to 5-7 main pages * Create focused experiences per page **Don't:** * Create too many pages (confusing navigation) * Put all cards on one page (overwhelming) * Duplicate same card on every page (redundant) * Forget mobile navigation experience ## Troubleshooting ### Issue: Card Not Showing on Page **Check:** 1. Is the card **published**? (not draft) 2. Is the card **visible** on that specific page? 3. Is there a visibility schedule preventing display? 4. Is the hub itself published? 5. Has the card reached its max entries (if competition)? ### Issue: Published Card Not Accessible **Check:** 1. Hub is published? 2. Card is published (not draft)? 3. Not hidden on that page? 4. No entry limits reached? 5. Eligibility rules met (if configured)? ### Issue: Single Card Link Not Working **Check:** 1. Card is published? 2. Card ID in URL is correct? 3. `singleCard=true` parameter included? 4. Hub domain is correct? 5. No extra characters in URL? ### Issue: Schedule Not Working **Check:** 1. Timezone configured correctly? 2. Both publish and unpublish times set (if needed)? 3. Schedule saved successfully? 4. Card status allows scheduling? 5. Check if schedule conflicts with manual publish/unpublish ## FAQ **Q: What's the difference between unpublishing a card and hiding it from a page?** A: **Unpublishing** removes the card entirely (invisible everywhere). **Hiding** from a page keeps it published but removes it from that specific page (still visible elsewhere). **Q: Can I have the same card on multiple pages?** A: Yes! One card can appear on unlimited pages. All pages show the same card with shared data and entries. **Q: What happens if I unpublish a hub?** A: The entire site becomes inaccessible. All cards, pages, and content are hidden from public view. Admin access remains. **Q: Can I schedule a card to show on different pages at different times?** A: Yes! Each page has independent visibility scheduling for the same card. Show on Page A Monday, Page B Tuesday. **Q: Is there a maximum number of cards per page?** A: Yes. A hub page can hold a maximum of **50 cards**. Add content is disabled once a page reaches that cap. Draft and published cards both count. If a page feels crowded, split content across multiple pages. **Q: Can I password-protect a page or individual cards?** A: Pages cannot be password-protected. Use entry conditions / access policies on cards, or hub-level entry conditions, to gate access. A hub **draft preview password** lets anyone with the password view the draft hub. **Q: Do single card pages count as page views in analytics?** A: Yes, they're tracked as card-specific engagement. You can see both hub page views and single card views in analytics. **Q: Can I embed a single card on an external website?** A: Yes! Use the embed code option to iframe the single card page into external sites. **Q: What happens to entries when I unpublish a card?** A: All entry data is preserved. When you republish, entries are still there. Only visibility changes, not data. **Q: Can I have different versions of the same card on different pages?** A: No, it's the same card. If you need different versions, create separate cards or use branching logic within the card. ## Related Documentation * [Card Scheduling](/getting-started/hub-setup/card-scheduling) - Detailed scheduling guide * [Multi-Page Hubs](/interactive-features/features/multi-page-hubs) - Advanced page architecture * [Before You Hit Publish](/getting-started/hub-setup/before-you-hit-publish) - Pre-launch checklist * [Entry Rules](/interactive-features/features/entry-rules) - Gating and access control * [Analytics](/getting-started/hub-setup/analytics) - Tracking and measurement *** **Need Help?** Contact [support@komo.tech](mailto:support@komo.tech) for publishing and visibility assistance. # Read me when your competition ends! Source: https://knowledge.komo.tech/getting-started/hub-setup/read-me-when-your-competition-ends/index Want to know what to do once your competition ends? Read on... This article will pick up from the point when your competition has ended and provide all the information you need to know when closing off your card's competitions. Read on for a step-by-step guide on what your options are once this occurs. ## Unpublishing ![Read me when your competition ends!: unpublishing](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-unpublishing-screenshot.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=12837abaeaecb6bdf13e90d0726e0cef) You have a couple of different options when taking your content down from the Engagement Hub. * **(1)** If you have manually published your card, you can simply click on the **unpublish** option here. This will manually take down the content from your hub. * **(2)** Alternatively, you can **schedule** a time for your content to be automatically unpublished from your hub here. ![Read me when your competition ends!: option a — Unpublishing](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-unpublishing-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=0cc048429f6370ae665e458e2acd8cad) * **(A)** You would use this option to make your content go live at a **set date**. * **(B)** Set the **date/time** your card will be automatically unpublished from the Engagement Hub. ## Awarding Prizes ![Read me when your competition ends!: option a — Awarding Prizes](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-awarding-prizes-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=957f79da19cd4b6b1ae4f6728d5d3d6b) > [!NOTE] > > We recommend setting up prizes prior to running your competition, however, if you haven't set them up you can do this by clicking on the Prizes tab. * **(1)** This area will provide you with an **overview** of all the prizes you've created for this card. * **(2)** By clicking here you can begin the process of **creating a new prize**. > **Creating a New Prize** > > ![Read me when your competition ends!: option a — Awarding Prizes](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-awarding-prizes-option-a-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=673cf1a6c535607e6cb7fe547259a1e0) > > After selecting **Add Prizes** you will be redirected to this window. > > * **(A)** Add an **internal name** to your prize. > * **(B)** Click **edit prize rules.** > * **(C)** Start building out your prize award rules. The awarding rules are detailed below. > * **Award prize manually -** Requires you to select an entrant/entrants to receive the prize. > * **Randomly pick X persons -** After clicking **Award prizes** the prize will be randomly allocated to X number of entrants. > * **Everyone who entered -** Every entrant will receive a prize. > * **Everyone who didn't win -** Every entrant who hasn't won any other prize will receive this prize. > * **(D)** Depending on how you configured the above, these options will **further refine** when entrants will receive this prize. > * **(E)** Customize the **communication** associated with that prize, within the communication you can attach coupons. * **(3)** Once your card's competition has closed, click this button to **award the prizes**. > [!NOTE] > > If you have chosen to award your prizes manually, the process for awarding will look slightly different. > > ![Read me when your competition ends!: option a — Awarding Prizes](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-awarding-prizes-option-a-3.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=f8a7d3a62f83d1560bd1ca2fd3d7149a) > > * **(A)** Instead of clicking on award prizes, click the 3 dots next to any prize you have configured to award manually. > > * **(B)** Click **select recipients to award.** > > ![Read me when your competition ends!: option a — Awarding Prizes](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-awarding-prizes-option-a-4.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=4a0a7308ea4e22be8853d79e1fe75696) > > * **(a)** Here you can **search your entrants** for those you wish to award prizes. > > * **(b)** Here is where you will **tick** the recipients you wish to award a prize. > > * **(c)** Once you've selected all of your prize recipients, click **award prize.** ## Downloading Entries ![Read me when your competition ends!: downloading Entries](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-downloading-entries-screenshot.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=542c2f79a4ca7548139692cb5cb316f7) To view all competition entrants, click on **Entries.** * **(1)** Clicking here will allow you to **download a .CSV file** with an overview of the information entrants provided in the data form, along with their responses to your content. * **(2)** This area will **populate with data** once people enter your competition. ## Announce Your Winners After your competition has ended we highly recommend announcing your winners either on the Engagement Hub, Social Media or EDM. This is a great way to drive people back to your Hub, to participate in future competitions and content. Below is an example of how our customer, San Churro, use the description of their Cards to announce their competition winners! ![Read me when your competition ends!: announce Your Winners](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/read-me-when-your-competition-ends-announce-your-winners-screenshot.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=8ec5c480852bda001eda6c6f11b9e7b4) # SMS Communications Source: https://knowledge.komo.tech/getting-started/hub-setup/sms-communications/index Understanding how SMS communications work, including pricing, character limits, and best practices. SMS communications incur a minimum additional cost of 12c per SMS. Different symbols and languages can result in increased text length. SMS messages are charged at a flat rate of 12c per segment, with one segment equivalent to 160 characters. > [!NOTE] > > Coupon and other links will add to your character count. Use of `{{coupon_link}}` within SMS communications can add up to 112 characters to your SMS. > [!TIP] > > To calculate the length of your SMS, use the [Twilio message segment calculator](https://twiliodeved.github.io/message-segment-calculator/). # SMS Sender IDs Source: https://knowledge.komo.tech/getting-started/hub-setup/sms-sender-ids/index Understanding the regulations around SMS sender IDs under Australian laws & how to set up your own unique SMS Sender ID. > [!WARNING] > > Please note that the information and advice that Komo provides regarding Sender IDs or any other matter of this nature is of a general basis only, and we suggest you seek your own legal advice specific to your needs. ## What is it? SMS Sender IDs, also known as Alphanumeric Sender Names are the **"from name"** you see on your device when you receive an SMS. This could be a business name like "Komo", rather than a numeric phone number. This makes your messages feel far more professional and trustworthy. There are many regulations around these Sender IDs for businesses and these laws have changed for Australian businesses in 2023. Alphanumeric Sender Names must now be pre-registered to send messages to customers. The problem is, up until this year, anyone has been able to send SMS messages from any "From name" they like, whether that's a bank, the ATO or any other organization. This is clearly a problem, so we welcome this regulation. SMS scams are sadly not uncommon, and these reduce consumer trust in the medium, which otherwise is such a powerful way of connecting with customers. We have worked with our nominated SMS web service API provider, Twilio, to ensure this process is as easy as possible and aligns with these new regulations. ## Why should I have my own Twilio account? Having your own Twilio account to set up individual sender IDs on the Komo platform provides complete control over meeting new laws and regulations. It ensures that you are well informed about the necessary steps for setting it up. By having your own account, you become the sole owner of the sender ID, allowing you to establish a distinct and recognizable identity for your SMS messages. This level of ownership empowers you to maintain compliance with evolving legal requirements, such as data protection and anti-spam regulations, as you have direct control over the messaging practices associated with your sender ID. Additionally, by being aware of the entire setup process, you gain a deeper understanding of the technical aspects involved, enabling you to troubleshoot any issues that may arise and optimize the performance of your SMS communications. Overall, having your own Twilio account for setting up individual sender IDs gives you the autonomy and knowledge necessary to navigate and adapt to the changing landscape of laws and regulations governing SMS messaging. ## How do I set it up? Creating your own Twilio account is simple, but there are a few steps that involve uploading documentation and proof that you are entitled to use your designated Sender ID. We will walk you through these steps next. **1. Set up your Twilio account** * **(1)** Go to [Twilio.com](http://Twilio.com) and click 'start for free'. * Once you have created an account using your personal contact information, your window will automatically take you to your organization's Console. * **(2)** From here follow the following menu items on screen: **Account > Trust Hub > Customer Profile** and click **Create Primary Business Profile** to start the process. * **(3)** Once here, configure your Primary Business Profile by following the prompts on screen > [!NOTE] > > You can set up Secondary Business Profiles for any other regions your organization may operate in. * **(4)** Your next step is to register a Sender ID for your Primary Business Profile [here](https://twlo.my.salesforce-sites.com/SenderId). * **(A)** Fill out all form fields on screen. * **(B)** Supply all necessary documentation to prove your organization has the right to use your Sender ID. This will include a registration form and the LOA for Sender ID specific to your region. > [!WARNING] > > Your Primary Business Profile bundle and registration form and documents need to be reviewed manually by Twilio, one at a time. Consequently, you will need to complete Step 3, leaving time for review before starting Step 4. Please allow upwards of 7 business days for Twilio to manually approve these assets. Do not proceed with Step 5 until you have received approval on Steps 3 and 4. ***Once the above Steps have been completed and approved by Twilio, you're ready to configure your messaging service.*** **2. Set up your Messaging Service** > [!NOTE] > > Note from Twilio: > > Sending a high volume of messages in the United States and globally quickly becomes complex. As the complexity of your messaging application grows, it’s helpful to organize your account and message logs into separate Messaging Services using Twilio Programmable Messaging. You can think of a Messaging Service as a higher-level “bundling” of messaging functionality around a common set of senders, features, and configuration. The same settings and feature configuration apply to all of the senders (long code numbers, short codes, toll-free numbers, etc.) in the Messaging Service’s pool. A Messaging Service’s features can be managed and configured directly through the Console as well as using the REST API. * Once your Sender ID has been approved, it is connected to a [Messaging Service](https://www.twilio.com/docs/messaging/services). *This is a recommended step of the Sender ID process.* * **(1)** Head to your Console within Twilio, where you will be able to add Messaging Services. * **(2)** For every Messaging Service you add to your account, you will need to configure its [incoming message handling](https://www.twilio.com/docs/messaging/services#incoming-messages-handling) and [status callback URL](https://www.twilio.com/docs/messaging/services#status-callback-url). These can be configured in the **Integration** section of your Messaging Service's settings. * **(3)** You’ll also need to associate one or more phone numbers or [short codes](https://www.twilio.com/docs/glossary/what-is-a-short-code) to the Service to send messages. > [!NOTE] > > As an example, you may have numerous Australian phone numbers or short codes associated with your Messaging Service. This is so that when you're sending a lot of SMS messages at the same time, Twilio can spread them across all the phone numbers in the pool. You may also have numerous phone numbers or short codes in other regions to target SMS recipients in those regions. This Service has intelligent rules about which numbers it will choose to send your SMS messages from (note: this happens automatically). **Once you have completed the above steps in Twilio, you're ready to connect your account within the Komo ecosystem!** **3. Connect your Twilio account to Komo using Connected Apps** ![SMS Sender IDs: how do I set it up?](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/sms-sender-ids-how-do-i-set-screenshot.gif?s=2465a7595d321ad4774970e3e8f1d352) * Navigate to the **Komo Dashboard** and click on your **admin icon** on the top right. * Click on **Company Settings**, navigate to **Connected Apps** and then click on **Connect** below Twilio SMS. > **Connect Twilio** > > ![SMS Sender IDs: option a — How do I set it up?](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/sms-sender-ids-how-do-i-set-option-a.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=920b1de8b93dedcf7fc4cbee35a5fcb5) > > * **(A)** Enter your [**Twilio Account SID**](https://console.twilio.com/us1/account/keys-credentials/api-keys). This step is **required**. > * **(B)** Enter your [**Twilio API Key SID.**](https://console.twilio.com/us1/account/keys-credentials/api-keys) This step is **recommended**. > * **(C)** Enter your [**Twilio API Key Secret**](https://console.twilio.com/us1/account/keys-credentials/api-keys)**.** This step is **recommended.** > * **(D)** Adding your [**Auth Token Secret**](https://console.twilio.com/us1/account/keys-credentials/api-keys) is **optional** and is only required if you want to use the Auth Token method to connect then click **Add.** * Once you've completed the above steps, you're ready to send your SMS communications to customers via the Komo Platform, supported by Twilio and in accordance with Australia's new Sender ID laws and regulations! **4. Choose your Sender ID when setting up communications** * **(1)** To start sending SMS messages using your new and approved Sender ID, navigate to any of your Cards in the portal. **Click** on the Card to open its **editing modal.** ![SMS Sender IDs: how do I set it up?](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/sms-sender-ids-how-do-i-set-screenshot.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=79359be79e5b7a59229c9397e4ceff84) * **(2)** Click on the **Data Capture** tab of the editing modal. * **(3)** Then choose the **Communications** tab that appears from the dropdown menu. * **(4)** Click on the **+ Add Communication** button. ![SMS Sender IDs: how do I set it up?](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/sms-sender-ids-how-do-i-set-screenshot-2.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=91d45f02b0a3b7d7768dfe8f7d717d71) * **(5)** Give your communication an **internal name.** * **(6)** Choose the type of communication you wish to create. In this case, you would choose **SMS.** * **(7)** Choose the **trigger** that will send your communication. ![SMS Sender IDs: how do I set it up?](https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/sms-sender-ids-how-do-i-set-screenshot-3.webp?fit=max\&auto=format\&n=haZ8nFo61lut3UyH\&q=85\&s=fb087113f0c9a8c3e41a78f7cc92845c) * **(8)** Here is where you will choose your Sender ID from the **'From' Dropdown menu.** * **(9)** Click **Update SMS.** **Congratulations - You've prepared your SMS to send from your newly registered Alphanumeric Sender ID! 🎉** ## FAQ **Which SMS providers does Komo support?** Twilio is the only SMS provider Komo supports today. Other SMS senders, such as Salesforce Marketing Cloud or other gateways, cannot be used to send Komo SMS. Connect your own Twilio account under **Company Settings → Connected Apps → Twilio SMS** — see the **Connect your Twilio account to Komo using Connected Apps** step above. # Welcome to Komo Source: https://knowledge.komo.tech/getting-started/hub-setup/welcome-to-komo-read-me-first/index Whether you've used the Komo platform before or starting from scratch, it never hurts to go back to basics. ## The Engagement Hub Think of your Hub as your consumer's one-stop shop for branded experiences, content, competition, games, and more. All of your content can live on your Hub, including games and digital rewards (more details on those features in the left navigation). Your Engagement Hub can be embedded within an app, exist as a sub-domain to your marketing website, or as a standalone URL. The Komo platform has an ever-growing number of what we call content cards and other tools that will help you engage your community. The platform is supported by a friendly and diligent Customer Success team that exists to help you get the most out of Komo's customer engagement tools. ## What Do I Need to Get Started? Before you jump into making your first Hub, please ensure you have completed all of the below initial onboarding tasks: 1. You have filled out your onboarding questionnaire. 2. You have had or scheduled your kick-off call with your designated Customer Success Manager (or CSM for short!). 3. You have been given access to the Komo portal and have set up permissions within your company settings, along with adding all necessary team members to your company in the Komo ecosystem. 4. You have had your onboarding call with your CSM to go over any questions and concerns you may have. This is also when we will show some other details and features like analytics, etc. 5. You’ve connected your Google Account in Account Settings. This will allow you to log in to the Komo ecosystem using your Google account. This step is optional but is a great way to maintain the security of your Komo account. > [!NOTE] > > The email address associated with your Google Account must be the same as the email associated with your Komo account. We also recommend watching the 2 videos below to get you up and running on the Komo platform! ## Navigating the Portal [Loom video player](https://www.loom.com/embed/ada598e633964bccb058b3a5840bf2f9) ## Building your First Card [Loom video player](https://www.loom.com/embed/a5bbadb73efe4debb152c9b672da4aed) ## Promoting your Hub Just like your social media channels and website, promoting your Hub and driving traffic to this digital destination is vital to successfully reaching your goals. For further suggestions regarding Hub promotion, check out our Knowledge Base Article [here](/getting-started/promotion/promoting-your-engagement-hub). ### Our Best Tips to Drive Traffic to Your Hub * Connect your Instagram 'Link in Bio' to your Hub. You can then convert all other links previously included in your bio into [clickable banners](/interactive-features/features/click-banner-card) that sit on your Hub, making the Hub your one-stop shop for community building. * Use the incredible engagement tools available to you on the platform, like Badges, leaderboards, points, and customer profiles. These features will not only drive traffic to your Hub but ensure that your customers keep coming back for more. * Place the link to your Hub on your website. This can be done through a banner, QR code, imagery, or landing page. Incentivize traffic by explaining to your community that it is the primary location for your most up-to-date content. * Add your Hub URL to all purchase receipts (physical and digital). * Make use of digital media; utilize paid and organic social media promotion to increase your reach. * Leverage your database to increase traffic to your Hub by including it in EDMs. * Use your Hub as an engagement tool at your live events or in your brick-and-mortar locations (more on this below). ### In-Venue Promotion Tips * Use posters with QR codes in locations your community frequents to increase awareness of the Hub and drive traffic. Popular locations are at the point of sale, in the bathroom(s), on tables, and on store windows. * Make use of [big screens](/support-resources/general/running-your-live-trivia-in-venue) and [Live Data Feeds](/interactive-features/features/live-data-feeds) to capture crowd attention during live events. * Print a Hub QR code on the back of your customer's receipts. * Provide staff with training and a 'cheat sheet' of the best ways to promote the Engagement Hub to their customers. ## Hub Content ### Consider your Buyer: Keeping your buyer persona front-of-mind when creating content will allow you to create higher-quality content and produce a higher engagement rate. Ask yourself questions like these when creating content for your Hub: * What does my persona enjoy? * How do they consume information? * What are their passion points? * How do they perceive value? * What is important to them when it comes to customer experience and journey? ### Best Practices for Creating Hub Content * Use our **Card Templates** to your advantage! Our platform houses over 50 templates for different cards, campaigns, and industries to give your creativity a kick-start and guide you in the right direction. You can view our library of Templates by using the **+ Add Content** button in your Hub Editor. * As well as Templates, we provide [Design Guidelines](https://docs.google.com/presentation/d/1pWj8mh1TdBxVx7ZhLxS8vt3QVwUJxi8sDyITsIhk3MM/edit#slide=id.p) for each Card, assisting you in designing your assets with the right specs, some examples of what your content could look like, and some tips to help you on your way! * Ensure you're adding **Terms and Conditions** to each of your competitions. You can find templates for these [here](/getting-started/resources/terms-conditions). * **Don't overcomplicate** your Hub; a simple quiz can be just as effective as a complex one if promoted correctly. * **Hub design is just as (if not more!) important as the design of your individual content Cards.** Take the time to set your logos, link up your other touchpoints in the footer of your Hub, and bring your brand identity to your Hub as a whole. * **Use your brand assets** to your advantage; include your color palette, logo, and other assets as much as possible as this will help drive brand recognition. * In addition to this, use graphics like your card cover images to display key information like competition prizes, sponsorships, etc. * You can **use CTAs** on cards to encourage further engagement with your brand. * **Test your content** to make sure you have set it up the way you intended and to ensure customers have a good user experience. * Keep your content fresh. Whenever a customer visits your Engagement Hub there should always be something new for them to engage with. This will improve the user experience and keep them coming back for more content. You can do this easily by utilizing the [card scheduling](/getting-started/hub-setup/card-scheduling) feature! ### Hosting Competitions Nearly every card on the Engagement Hub allows you to host a competition by adding a Data Capture form to the card. This allows you to seamlessly reward consumers for their engagement, with digital coupons, Pays-Enabled Digital Mastercards®, or your own branded rewards and experiences. Click here to see the full article on setting up [Data Capture.](/getting-started/hub-setup/data-capture) ### Key Considerations Below are a few key items you might want to consider, and the corresponding Knowledge Base Articles to help you on your way: * **Would you like to send SMS messages from the Komo Platform?** To do this, you must register your organization's Alphanumeric Sender ID via Twilio and connect this with Komo to ensure you meet Australian laws and regulations. Follow the steps in the article [here](/getting-started/hub-setup/sms-sender-ids/index) to get started. * **Do you have other tools in your marketing stack that you'd like to connect with Komo's ecosystem?** Komo supports integration with various CRM platforms, social networks, Google Analytics, and many more which you can read about [here](/integrations-automation/tag-management). * **It's important to decide how you want to utilize all of your brand touchpoints to promote your Hub using an omnichannel approach.** Check out our article on Promotion [here](/getting-started/promotion/promoting-your-engagement-hub/index) to get the ideas flowing! * **How would you like to manage the data you collect via the Komo Platform?** Some of our customers prefer to use the Portal as a mini CRM, while others connect their external CRM via our [integration settings](/integrations-automation/tag-management). The choice is yours, but this is a good decision to make upfront. * **Have you considered how you might reward your consumers for their engagement with your Hub?** Komo provides many avenues for prizing, including [Digital Coupons](/competitions-promotions/digital-coupons/digital-coupons/index) and open and closed-loop Digital Pays-Enabled Mastercards® (via [Vault Payment Solutions](https://www.vaultps.com.au/)). Or, you can provide your own branded prizes and experiences to your users! ### Hub Ideas The Engagement Hub features a large and ever-growing selection of content cards to help you reach your goals. Here are a few ideas to get you started: * **Videos:** The Komo platform integrates with Youtube, Vimeo, and Twitch, allowing you to embed videos directly into your Hub and centralize your content for your customers. * **Articles & Blogs**: Link to press releases, news articles, and your blog(s) with [Click banners](/interactive-features/features/click-banner-card/index)! * **Behind The Scenes**: Use your Hub as an opportunity to truly engage with your audience by giving them a behind-the-scenes look at how you create your product or service! * **Secret Codes:** Have your users enter a secret code to unlock a special deal or coupon using the [Secret Code](/interactive-features/features/secret-code/index) Card. This is a great way to drive customers in-store or to your other digital touchpoints. * **Interesting Quotes**: Use the [Image Card](/interactive-features/features/image-card/index) to share interesting information and quotes about your brand. This can tie in with the other content on your Hub by providing a hint to Quiz and Number Guess Cards. * **Teasers**: Use the Hub to tease new products and draw consumers in to see what's new! * **Customer Feedback**: Use the [20 Words or Less Card](/interactive-features/features/20-words-or-less/index) to collect customer feedback about your products and services. * **Tips and Tricks:** Educate consumers on best practices to use your products and services by sharing a How-To video or blog post. * **Promote Events:** Got a big event coming up? Use the Hub to promote your in-person or virtual event by building hype with various related content such as the [Countdown Card](/interactive-features/features/countdown-card/index). * **Polls:** Let customers have their say on your brand with Poll Cards. These cards provide an opportunity for you to better understand your audience and improve your product. * **Run a Rewards Campaign:** Use the [Receipt Uploader Card](/interactive-features/features/receipt-uploader-card/index) as a means to validate receipts and reward customers for their purchases. Alternatively, the card allows you to collect .JPEG and .PNG files to develop shareable, user-generated content. # White Labeling your Domain Source: https://knowledge.komo.tech/getting-started/hub-setup/white-labeling-your-domain/index Set up a personalized URL for your Hub. ## What is it? By default, your new Hub's URL will be (your Hub name)**.[komo.site](http://komo.site)**. For example, [**komohub.komo.site**](http://komohub.komo.site) You have the ability to fully customize and white label your Hub domain and remove the domain **.[komo.site](http://komo.site)**. ## Option 1: komo.site ![White Labeling your Domain: option 1: komo.site](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/white-labeling-your-domain-option-1-komo-site-screenshot.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=81b3b2f5ecc96897c20165da578a3dee) * Navigate to your **Engagement Hub**. * **(1)** Click on **Settings** and then **(2)** **Domain** on the left sidebar. * **(3)** You can customize your default (Hub) domain without purchasing another domain by simply changing the text within the box. You will then get a pop-up to confirm this change. ## Option 2: Custom domain ![White Labeling your Domain: option 2: Custom domain](https://mintcdn.com/komotechnologies/22OmvqhqqNidygu6/images/white-labeling-your-domain-option-2-custom-domain-screenshot.webp?fit=max\&auto=format\&n=22OmvqhqqNidygu6\&q=85\&s=c352dc6589db61ef0b041f219caf0908) * **(1)** Tick the **White label domain** box. This will open a drop-down menu with all the steps to fully white label your Hub. > [!NOTE] > > For more help white labeling using Cloudflare click [here](#add-a-new-site-to-cloudflare). * **(2)** Enter your **pre-purchased domain** in the box. * Once you have completed these steps, we will provide you with a CNAME record. * You will have to enter your DNS configuration within the next 48 hours. > [!WARNING] > > You cannot white label a Hub at the Apex (root) of a domain unless the DNS provider (e.g. Cloudflare) supports CNAME flattening. > > For example, you cannot white label '[mydomain.com](http://mydomain.com)' with GoDaddy (which doesn't support CNAME flattening), it would need to be '[www.mydomain.com](http://www.mydomain.com)' (a subdomain). However, '[mydomain.com](http://mydomain.com)' could be used with Cloudflare which does support CNAME flattening. If you require further assistance with CNAME flattening, reach out to your Customer Success Specialist. * **(3)** Next, create your custom **CNAME record**. * Go to your DNS provider’s website (e.g. [**Cloudflare**](https://www.cloudflare.com/dns/) ). If you’re choosing one for the first time, go with one that supports SSL. * Create a new CNAME (‘canonical name’) record for your custom domain. * Point it at Komo's host domain - [**cname.komo.site**](http://cname.komo.site) > **Add a new site to Cloudflare** > > ### Add a new site to Cloudflare > > On Cloudflare, begin by adding a new site to your account. > > If you are using an external registrar, follow the steps Cloudflare provides for updating your Registrar's **nameserver** settings to point at the Cloudflare servers. > > If you buy a domain through Cloudflare, you won't need to change any nameserver settings. > > #### **Update the DNS Settings** > > Once your new site is added to Cloudflare, go to **DNS** on the side menu and add the following DNS management records: > > ![White Labeling your Domain: option 2: Custom domain](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-setup-dns-png.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=ed502bce8004e184df82a9aa49abefb9) > > Make sure to replace "[*mydomain.com*](http://mydomain.com)" with your own domain (**without** the "[*www.*](http://www)"). > > #### **Add Page Rules** > > On the Cloudflare menu, select **Rules > Page Rules**. Here we will be adding a rule so that any requests for "[*www.domain.com*](http://www.domain.com)" get redirected to "[*domain.com*](http://domain.com)". > > Click on **Create Page Rule** then follow the procedure below: > > ![White Labeling your Domain: option 2: Custom domain](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-setup-page-rules-steps-png.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=04cfe40d7c3f1a07e6b9efa83e03e722) > > #### **How do I set this up?** > > **1. Enter your www domain with an asterisk after it e.g. [www.mydomain.com/](http://www.mydomain.com/)**\* > > **2. Select the "Forwarding URL" setting** > > **3. Then select "301 - Permanent Redirect"** > > **4. Enter the redirect address as follows, using your domain name (without www): [https://mydomain.com/\$1](https://mydomain.com/\$1)** > > **5. Click Save and Deploy** > > This should result in a rule that looks like the following: > > ![White Labeling your Domain: option 2: Custom domain](https://mintcdn.com/komotechnologies/fh79xGJR6fRUjmRd/images/cloudflare-setup-page-rules-png.webp?fit=max\&auto=format\&n=fh79xGJR6fRUjmRd\&q=85\&s=9590fea05e3e498b8ddc671f2c9002e8) * **(4)** Finally, verify the status of your white label. Once the CNAME has been pointed toward the Komo portal, click the **Verify Status** button to confirm the white label domain status and link to your domain. > [!NOTE] > > This may take a few hours to update. # Card Sharing Source: https://knowledge.komo.tech/getting-started/promotion/card-sharing/index Share cards from your Hub with links, QR codes, email or socials. ### What is it? You can now share specific cards from your Hub directly to your social accounts, through email, with a link or QR code. ### How do I use it? ### Step 1: Navigate to the card ![Card Sharing: step 1 — Step 1: Navigate to the card](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-sharing-step-1-navigate-to-step-1.gif?s=3e0fd5f3c11563c64c66b7eabfba15b9) * Navigate to your **Engagement Hub**. * Once there, scroll to the card you want to share. ### Step 2: Set up your card sharing settings ![Card Sharing: step 2 — Step 2: Set up your card sharing settings](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-sharing-step-2-set-up-step-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=8b27e8e9e194a773838dd3ae645f4675) * Click on the card to open the editing modal. * **(1)** Head to the Sharing tab. * **(2)** This is the image that is shown when sharing the card. > [!NOTE] > > This by default is your cover image. You can change this image if you wish. * **(3)** Add a title that will be used when sharing the card. * **(4)** Add a description that will be shown when sharing the card. ### Step 3: Select your sharing option ![Card Sharing: step 3 — Step 3: Select your sharing option](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-sharing-step-3-select-your-step-3.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=1c7617e1ac1980090c3f4c8394363e7b) > [!NOTE] > > To be able to access the card sharing option, your Hub needs to be published. * **(1)** Click on the ... on the top right of the card then **(2)** select **Share**. * **(3)** Enable the **single card page** to direct users to view just the card on the Hub. > [!NOTE] > > Below is a preview of a single card page. > > ![Card Sharing: step 3: Select your sharing option](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-sharing-step-3-select-your-screenshot.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=8f4881a23b7d8fcf42d189bae14f1b42) * **(4)** If you have **multi-pages**, you can select the page you wish to share. * **(5)** Add **UTM parameters** to your Hub URL. > [!NOTE] > > We highly recommend using UTM parameters/tracking for all promotional links including QR codes. Click here to learn more. * **(6)** Selecting the **Clipboard** button to copy the sharable link * **(7)** Create a **QR code**. > **Managing your QR Code** > > ![Card Sharing: option a — Step 3: Select your sharing option](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-sharing-step-3-select-your-option-a.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=2a3c2978af949d4fe2d69fcb431ad451) > > * **(A)** The **Hub URL** cannot be changed in this setting. > > [!NOTE] > > > > Ensure you're happy with your domain prior to generating a QR code as once you alter the domain, you will need to generate a new QR code. > * **(B)** Select your preferred **file type**. > * **(C)** Alter the **size** of the QR code. > > [!NOTE] > > > > The dimensions are a locked aspect ratio of 1:1. > * (D) Edit the **styling** of the QR code. > > ![Card Sharing: option c — Step 3: Select your sharing option](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-sharing-step-3-select-your-option-c.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=a63e080200e8235fddb6b62fc36b42c6) > > * **(a)** Edit the **background colour** of the QR code. > * **(b)** Edit the **foreground colour** of the QR code. > * **(c)** Upload an **image or logo** here that will sit in the centre. > * **(E)** Add **UTM parameters** to the QR code/s to track where traffic is coming from. > > ![Card Sharing: step 3: Select your sharing option](https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/card-sharing-step-3-select-your-screenshot-2.webp?fit=max\&auto=format\&n=hyNEub_8vkzR1bhF\&q=85\&s=fa064331bdb8ecdd4210e1eb38caa095) > > * (a) Add a **source** to identify where the traffic originated from. > * (b) Include a **medium** to track what type of traffic users originated from. > * (c) Input the **campaign name**. > * (d) Add a **term** to track which keyword term a user came from. > > [!NOTE] > > > > This is only used for paid search ads. > * (e) The **content** will allow you to differentiate between ads or links if you have multiple links directing to the same URL. * **(8)** Connect and create a QR code via **Flowcode**. * **(9)** Share via **email**. * **(10)** Share via **Facebook**. * **(11)** Share via **X**. * **(12)** Share via **LinkedIn**. ## FAQ #### Can I share directly on my socials? Yes, when you click on the social icons, it will automatically connect to your signed in account for that platform and create a draft post where you can add a caption. #### Do I need to create an image for it to be shared? When you share a card, it will pull through the card's cover image. To change the sharing image, you can see how to do so [here](#how-do-i-use-it-step-1-navigate-to-the-card). #### Do I need to set up any SEM/SEO settings for the card when sharing? Yes, you can see how to edit these settings [here](#how-do-i-use-it-step-1-navigate-to-the-card). # Hub Sharing Source: https://knowledge.komo.tech/getting-started/promotion/hub-sharing/index Share your Hub with links, QR codes, email or straight to your socials. ## What is it? You can now share your Hub directly to your social accounts, through email, with a link or QR code. ## How do I use it? ### Step 1: Set up your SEO/SEM settings ![Hub Sharing: step 1 — Step 1: Set up your SEO/SEM settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-sharing-step-1-set-up-step-1.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=b832b25929cbeebff5ce3dc4ddd72b57) * Navigate to your **Engagement Hub**. * **(1)** Once there, click on **Page settings** and then **(2)** Edit. > [!NOTE] > > Here you can set whether you would like your Hub to be visible in **search engine results**. > > ![Hub Sharing: option a — Step 1: Set up your SEO/SEM settings](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-sharing-step-1-set-up-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=8f1319453387d5b2c8f0f4a8485a16d8) > > * **(A)** This refers to the **title** of your site and will be shown in the browser tab. > * **(B)** Here you can set up your **SEO description**. > * **(C)** This is the **icon** that will be shown next to your Hub name in your browsers tab. > * **(D)** This is a **preview** of search engine results. ### Step 2: Sharing a published Hub ![Hub Sharing: option d — Step 2: Sharing a published Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-sharing-step-2-sharing-a-option-d.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=e426152a7051fd27e9bfcc4f6c7f6b7c) * **(1)** Click on **Share** to open the sharing options. * **(2)** If you have **multi-pages**, you can select the page you wish to share. * **(3)** Add **UTM parameters** to your Hub URL. > [!NOTE] > > We highly recommend using UTM parameters/tracking for all promotional links including QR codes. Click here to learn more. * **(4)** Selecting the **Clipboard** button to copy the sharable link * **(5)** Create a **QR code**. > **Managing the QR Code** > > ![Hub Sharing: option a — Step 2: Sharing a published Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-sharing-step-2-sharing-a-option-a.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=a91158c0e099a86af3cf2a3a87cf8ef1) > > * (A) The Hub URL cannot be changed in this setting. > > [!NOTE] > > > > Ensure you're happy with your domain prior to generating a QR code as once you alter the domain, you will need to generate a new QR code. > * (B) Select your preferred file type. > * (C) Alter the size of the QR code. > > [!NOTE] > > > > The dimensions are a locked aspect ratio of 1:1. > * (D) Edit the styling of the QR code. ![Hub Sharing: option b — Step 2: Sharing a published Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-sharing-step-2-sharing-a-option-b.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=27d14a50d8f4ae3c4a7bc3a6c8368f9c) > * **(a)** Edit the **background colour** of the QR code. > * **(b)** Edit the **foreground colour** of the QR code. > * **(c)** Upload an **image or logo** here that will sit in the centre. > * **(E)** Add UTM parameters to the QR code/s to track where traffic is coming from. ![Hub Sharing: option d — Step 2: Sharing a published Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-sharing-step-2-sharing-a-option-d-2.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=88d85fe487214b3ef86d80292c627bff) > * **(a)** Add a **source** to identify where the traffic originated from. > * **(b)** Include a **medium** to track what type of traffic users originated from. > * **(c)** Input the **campaign name**. > * **(d)** Add a **term** to track which keyword term a user came from. > > [!NOTE] > > > > This is only use for paid search ads. > * **(e)** The **content** will allow you to differentiate between ads or links if you have multiple links directing to the same URL. * **(6)** Connect and create a QR code via **Flowcode.** * **(7)** Share via **email**. * **(8)** Share via **Facebook**. * **(9)** Share via **X**. * **(10)** Share via **LinkedIn**. ### Step 3: Sharing an unpublished Hub ![Hub Sharing: step 3 — Step 3: Sharing an unpublished Hub](https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/hub-sharing-step-3-sharing-an-step-3.webp?fit=max\&auto=format\&n=YBuAsk8OUeUukWbG\&q=85\&s=ff671a48091fa721e74392a6d33185cb) * **(1)** Click on **Preview** to open the options. * **(2)** Selecting the **Clipboard** button to copy the sharable link. * **(3)** Create a **QR code.** > [!NOTE] > > Follow Step 2(5) to generate a QR code. ## FAQ **Can I share directly on my socials?** Yes, when you click on the social icons, it will automatically connect to your signed in account for that platform and create a draft post where you can add a caption. **Do I need to set up any SEM/SEO settings for the Hub when sharing?** Yes, you can see how to edit these settings [here](#contents). **Can I generate a QR code before building any content or going live?** You sure can! We understand promotional collateral can take some time so follow [Step 3](#how-do-i-use-it-step-1-set-up-your-seosem-settings) to see how to create a QR code when your Hub is still in draft mode. # Link Trails Source: https://knowledge.komo.tech/getting-started/promotion/link-trails/index Create tracked short links and QR codes for campaigns with Komo Link Trails ## What is it? **Link Trails** let you create short, trackable links (and matching QR codes) that redirect people to a destination you choose — usually a Hub, card, or campaign page. Short links use your region's `komo.link` host (for example `us1.komo.link` or `au1.komo.link`). Because you can change the destination after the fact, they're especially useful for a generic link or QR code you print once (posters, tickets, signage) and then point at different destinations later — without reprinting. A trail is a campaign container. Inside it you can add multiple short links that share the same destination and settings, so each channel (newsletter, poster, ticket gate, social) gets its own URL while reporting rolls up in one place. > [!NOTE] > > Link Trails sit under **Links** in the workspace nav and may show a **Beta** badge. Availability depends on your workspace entitlement. Over time we'll add more sophisticated link routing and intelligence. ## Why would I use it? Use Link Trails when you need clean, shareable URLs and want to see which channel drove the clicks: * Print a lasting QR or short link, then update where it goes without reprinting * Shorten long Hub or card URLs for email, social, ads, and print * Generate QR codes for in-venue or broadcast use * Apply UTM parameters once at the trail level * Set an expiry with a fallback URL so campaigns don't dead-end * Password-protect a link when access should be limited * Review click analytics by short link, referrer, UTM, country, and device ## How to set one up ### 1. Open Link Trails In your workspace sidebar, open **Links** → **Link Trails**. ![Navigate to Links in the workspace sidebar](https://mintcdn.com/komotechnologies/3ODSycZRRHnf6ddI/images/link-trails-navigate-to-links.png?fit=max\&auto=format\&n=3ODSycZRRHnf6ddI\&q=85\&s=c58022712fdefa034f83567f9be90251) ### 2. Create a trail 1. Click **+ Create link trail**. 2. Enter a **Name** (internal — for your team). 3. Enter the **Destination URL** (where visitors should land). 4. Click **Create**. Your new trail appears on the Link Trails list as a **Draft** until you publish it. ![Link Trails list with Create link trail](https://mintcdn.com/komotechnologies/3ODSycZRRHnf6ddI/images/link-trails-list.png?fit=max\&auto=format\&n=3ODSycZRRHnf6ddI\&q=85\&s=e82f08f88fa19b1645d0f56059c38a95) ### 3. Configure settings Open the trail and go to the **Settings** tab. Set the **Destination URL**, then use the option buttons as needed: | Option | What it does | | - | - | | **Password** | Visitors must enter a password before the redirect | | **Expiration** | Stops the trail after a date/time; optional **fallback URL** for late visitors | | **UTM** | Default UTM parameters appended when the short link resolves | | **Link Preview** | Title, description, and image shown when the link is shared | | **QR style** | Default QR look for short links in this trail (colours, shape, logo) | Save your changes, then **Publish** when you're ready for the short links to go live. After publishing, use **Edit draft** to change settings and publish again. ![Trail Settings with destination, UTM, link preview, and QR style](https://mintcdn.com/komotechnologies/3ODSycZRRHnf6ddI/images/link-trails-settings.png?fit=max\&auto=format\&n=3ODSycZRRHnf6ddI\&q=85\&s=9f5a6a8383f9226679c8bd8bad283402) ### 4. Add short links Open the **Short Links** tab and add a link for each place you'll share the trail: 1. Click to add a short link. 2. Keep the platform host (your region's `*.komo.link`). 3. Accept the generated path, or enter a custom slug (for example `newsletter-august`). 4. Copy the URL, or open the QR icon to download a QR code for that link. ![Short Links tab with multiple komo.link URLs](https://mintcdn.com/komotechnologies/3ODSycZRRHnf6ddI/images/link-trails-short-links.png?fit=max\&auto=format\&n=3ODSycZRRHnf6ddI\&q=85\&s=d00d72fdf43c5b140d11016947e3a33f) > [!TIP] > > Give each channel its own short link (email vs QR vs social). Analytics can break clicks down per short link while they share one destination. ## How it works 1. Someone opens a short link or scans its QR code on `*.komo.link`. 2. Komo records the click (referrer, UTMs, device, location, and which short link was used). 3. If a password is set, they're prompted before continuing. 4. If the trail has expired, they're sent to the fallback URL (when configured) instead of a broken page. 5. Otherwise they're redirected to the trail's destination URL, with default UTMs applied when set. **Statuses** | Status | Meaning | | - | - | | **Draft** | Not live yet — configure and publish when ready | | **Published** | Short links resolve to the live destination | | **Stopped** | Temporarily paused — resume when you want traffic again | | **Archived** | Retired from active use | Use the trail's actions menu to **Stop**, **Resume**, **Rename**, or **Archive**. ### Analytics On a published trail, the **Analytics** tab shows: * Daily **clicks** over the last 30 days * Breakdown by **short link** and **destination** * **Referrers** and **UTM** values * **Countries** (and related location tabs) * **Devices** / **OS** ![Trail Analytics with clicks, short links, referrers, countries, and devices](https://mintcdn.com/komotechnologies/3ODSycZRRHnf6ddI/images/link-trails-analytics.png?fit=max\&auto=format\&n=3ODSycZRRHnf6ddI\&q=85\&s=33e64acedba4d28f12f3efb1b9bfebac) ## FAQ #### Can I have more than one short link per trail? Yes. Add as many short links as you need for different channels or creatives. They share the trail's destination and settings. #### Can I customise the short link path? Yes. When adding a short link you can use a generated path or a custom slug. The host stays on your region's `komo.link` domain. #### What happens when a trail expires? Visitors are sent to the **fallback URL** you set under Expiration. If you don't set a fallback, the link no longer redirects to the campaign destination after expiry. #### What's the difference between Stop and Archive? **Stop** pauses a published trail so you can **Resume** it later. **Archive** retires the trail from active use. #### Do Link Trails replace the UTM Builder or card/hub share links? No. [UTM Parameters](/getting-started/promotion/utm-parameters), [Card Sharing](/getting-started/promotion/card-sharing), and [Hub Sharing](/getting-started/promotion/hub-sharing) still apply. Link Trails are for managed short links and QR codes when you want reusable, tracked campaign URLs under **Links**. #### Related workspace tools Under **Links** you'll also find **UTM Templates** and **QR Templates** for reusable defaults across trails. # Promoting your Engagement Hub Source: https://knowledge.komo.tech/getting-started/promotion/promoting-your-engagement-hub/index Find tips for sharing your Engagement Hub with your audience! **Proper promotion of your Engagement Hub is critical to its success.** The Komo Platform supports [omnichannel distribution](https://www.komo.tech/features-omni-channel-distribution), enabling you to share your Hub using a mix of traditional, digital, and experiential marketing strategies. Omnichannel promotion is what will allow you to **capture critical customer engagement statistics** and **rich zero and first-party data**. We recommend utilizing all the channels available to your brand and always keeping your target audience in mind. > [!NOTE] > > It's also important to remember that we've designed the Komo Platform to house the most unique and engaging concepts on the market - So make sure you give it the limelight by using it as stand-alone content when promoting. > [!TIP] > > Before you share your Hub or competitions, we recommend setting up your Hub SEO/SEM and card-sharing settings. ## Digital Promotion Using your digital channels is one of the simplest but most effective ways to promote your Hub! Below are some of the ways you could consider sharing your content digitally: **Social Media** Promotion using social media works in a two-way loop on the Komo Platform. You can embed your social content directly on your Hub AND share your Hub by promoting it via your social channels. > [!NOTE] > > Here's an example of how San Churro share their social content directly via their Hub. > > ![Promoting your Engagement Hub: digital Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-digital-promotion-screenshot.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=463c40dee6f28e4afa789111168aebd9) > > And another example of how [San Churro](https://www.sanchurro.com/) share their Hub, La Churro Casa, by housing the URL in the bio of their Instagram! > > ![Promoting your Engagement Hub: digital Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-digital-promotion-screenshot-3.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=8f687393319077b9e7cb4de1916a96eb) Post regularly to social media about the Engagement Hub and its competitions. Use CTA's and focus on the available prizes to effectively drive people to your Hub. In the case of bigger campaigns, you can also use influencer marketing to drive people to your Engagement Hub. For a great example of this in action, check out the promo video from The Budget Rental Roosters Hub: > [!NOTE] > > **Budget Rental - Search for The Roosters Biggest Fan** > > [https://www.facebook.com/plugins/video.php?height=476\&href=https%3A%2F%2Fwww.facebook.com%2Fofficialsydneyroosters%2Fvideos%2F527621981646613%2F\&show\_text=false\&width=476\&t=0](https://www.facebook.com/plugins/video.php?height=476\&href=https%3A%2F%2Fwww.facebook.com%2Fofficialsydneyroosters%2Fvideos%2F527621981646613%2F\&show_text=false\&width=476\&t=0) Web Embeds Embedding your Hub content across your other digital touchpoints, such as your website, is an excellent way to encourage engagement with your Hub - Remember, be where your customer is! Configuring an embed is super simple. Just follow the steps in [this Knowledge Base article](/content-types/embeds)! **Card URLs vs. Hub URLs** Sharing your Hub URL across your digital channels is another excellent tactic. Write about your latest game or competition, create a graphic to represent it (don't forget to show off any prizes involved!), and share the URL directly to your Hub. But did you know you can also share a URL that will take users to your Hub and scroll directly to a specific card or piece of content? Finding this URL is super simple. Just find the card you wish to share on the portal, click the 3 dots in the top right of the card, and select share. From there, just copy your URL and you're good to go! ![Promoting your Engagement Hub: digital Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-digital-promotion-screenshot-2.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=568df347fa48ab3ce73c98473d70e3ff) **Stories** Utilize Instagram and Facebook Stories to remind your community about your Engagement Hub. For maximum effectiveness, add a link to the story that drives traffic to your Hub. > [!NOTE] > > **Central Coast Mariners** > > Check out how the [Central Coast Mariners](https://ccmariners.com.au/) used their Instagram stories to promote their McDonald's Man of the Match Voting Card. > > ![Promoting your Engagement Hub: digital Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-digital-promotion-screenshot-4.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=d6694311c4915eee68c122232b5f6d49) **EDMs** Include your Hub, its content, and its unique features in your EDMs. Newsletters are often overlooked, but have seen great success for many of our partners! You can break down your database even further into people who have already engaged with your Hub's content, by clicking on **Data Capture** in the Editor and then **Export**. This will download a .csv file of the user's emails which you can then use to retarget with EDMs. **Paid Ads** Most social media channels reward paid advertising, so don't be afraid to boost posts and set up Hub-specific ad campaigns to drive traffic. For best practice, ensure your graphics highlight the prizes you have on offer and have clear CTAs. > [!NOTE] > > **Cheesecake Shop** > > Check out how [the Cheesecake Shop](https://www.cheesecake.com.au/) used paid advertising to promote their Christmas Scratch & Win! > > ![Promoting your Engagement Hub: digital Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-digital-promotion-screenshot-5.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=49ff262ec3b19caec167f744a126e37c) **Shareable Outcomes & UGC** Many of our Content Cards encourage user-generated content, which can be great content to repurpose for your socials. Popular UGC cards include the Picker mechanic, Poll results, Meme Generator, and 20 Words or Less entries. > [!NOTE] > > Check out how Football Australia used the Picker Card to invite users to create their ultimate Socceroos Team of the Century, which led to 2,300+ social shares and debate across social channels! You can read a case study on this campaign [here](https://blog.komo.tech/case-studies/case-study-football-australia-team-of-the-century-picker). > > ![Promoting your Engagement Hub: digital Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-digital-promotion-screenshot-6.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=e00ca3c523b9f28882f1005ee852a85c) ## In-Venue Promotion Whether in a shopping center, retail store, or at a sports game or conference, taking advantage of in-person interaction is another great way to promote your Hub. Take advantage of foot traffic by advertising your Hub in-venue in as many places as possible. Always remember - be where your customer is! **Posters** Use posters in areas of heavy foot traffic, points of sale, and toilets to maximize their effectiveness. Designing with vibrant colors and strong fonts can help draw the customer's attention. Be sure to also include a QR code so patrons can quickly scan and access your Hub. > [!NOTE] > > Check out a few examples below of how Komo customers have used posters to promote their hub in-store or in-venue! > > **BodyScience Poster Promo** > > ![Promoting your Engagement Hub: in-Venue Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-in-venue-promotion-screenshot.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=a50901c316ec1bde12cb7e7780334d60) > > **The Good Foundation Poster Promo** > > ![Promoting your Engagement Hub: in-Venue Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-in-venue-promotion-screenshot-2.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=d9a08c52301c68193786f8e0f2c1264d) > > **Pacific Square Poster Promo** > > ![Promoting your Engagement Hub: in-Venue Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-in-venue-promotion-screenshot-3.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=404ff43e433c4bea2b78a6d4ee9cc8f2) **Big Screen Integration** Large, in-venue screens are also a great digital medium to promote your Engagement Hub. > [!TIP] > > Include animations to capture customers attention! > [!NOTE] > > See how a selection of Komo customers use the big screen to promote their hubs in-venue at events and sports games! > > Central Coast Mariners > > ![Promoting your Engagement Hub: in-Venue Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-in-venue-promotion-screenshot-4.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=896d26a0ade251d27f88424ecb30b502) > > **Hoyts Cinema Oscar Party** > > ![Promoting your Engagement Hub: in-Venue Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-in-venue-promotion-screenshot-5.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=4db702b653ecca19b71a65859f27ccfc) **Live Data Feeds** Our [Live Data screens](/interactive-features/features/live-data-feeds) are another great way to promote and share your Hub content in-venue. Beyond just promoting your Hub (as above), Live Data Feeds allow you to pull data from your content and display this on the big screen. For example, perhaps you are running a Live Predictor at a sports game, asking fans to predict game outcomes. Using Live Data Feeds, you can design a fully-branded screen that displays fan predictions on the big screen for all to see. This is a great way to promote your Hub *and* make your consumers feel a part of the action! > [!NOTE] > > **Check out how [B\&T](https://www.bandt.com.au/) used Live Data Feeds at their 2022 Awards Night to share the leaderboard from their Live Trivia on a fully customized and branded screen.** > > ![Promoting your Engagement Hub: in-Venue Promotion](https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/promoting-your-engagement-hub-in-venue-promotion-screenshot-6.webp?fit=max\&auto=format\&n=2hH4unVX-mPKIOda\&q=85\&s=9faee739b4543dd39dff1a1225eea54d) ## Broadcast/ Virtual Event Promotion If available to you, a live broadcast is another excellent way to promote your hub and collect live consumer insights and first-party data! And we're not just talking about a television broadcast - Perhaps you're hosting a virtual event, webinar, LinkedIn live... Your Hub can be shared digitally and engaged with live via a broadcast of any kind! **QR Codes** The simplest way to share your Hub via a broadcast is to invite viewers to scan a QR code to access your Hub. As mentioned in the section on [Digital Promotion](#digital-promotion), you can share QR codes (or URLs) for either your entire Hub OR specific content. This is great if you want to direct viewers of your broadcast to a specific game or competition! > [!NOTE] > > Check out how [Fox Sports](https://www.foxsports.com.au/) used a QR code during their live broadcast and at a live cricket match to promote their hub! > >