Set up

Share your latest enhancements right within your platform using Jimo’s changelog. In this notice, we are going to set up the in-app changelog.

Before You Begin

Make sure Jimo is installed on your site. If you need assistance, find our installation guide here.


Accessing the Changelog Hub

  1. Log into your Jimo dashboard.

  2. Select ‘Changelog’ from the sidebar to open the Changelog Hub.

Customize Your Changelog

Before creating posts:

  • If it’s your first time, click ‘+ Create changelog’ to initialize the changelog builder.

  • If you’ve already set it up, use ‘Customize’ to tweak the design and settings.

Personalize the changelog to align with your brand and cater to your audience's experience.

The Navigator provides a structured pathway to setting up your changelog:

  1. Changelog: Design the overall style of your changelog. Here, you can:

    • Set up general parameters on behavior and position.

      By default, the language will adapt to the user's browser settings if the translation is available, but you can force one language.

    • Select a theme that aligns with your brand. Choose CTA's fonts and colors to create a consistent user experience across your changelog.

  2. Navbar: Opt to display the 'Feed' or 'Request' tabs, enabling users to switch between viewing updates and submitting feedback.

  3. Post Feed Page: Arrange how posts are laid out, defining the look and feel of the updates feed.

    You can keep your user's feedback for your eyes only with the "Private Comments" option, it might be useful if you share the same Jimo project for multiple clients.

  4. Feedback Page: Craft a feedback page that encourages user interaction, making it easy for your community to share their thoughts and suggestions.

You can also customize what your changelog will look like (colors, fonts,... ) by editing its theme. Go to Settings > Theme and click on the Changelog tab. 🎨

Trigger Options

Select how your changelog is displayed with these triggers:

  • Disable (by default): If you need to temporarily suspend access to the changelog, you can do so without removing the integration.

    You have to select another option to enable the changelog the first time you set it up.

    Once you have published your first post, you'll be able to quickly disable the changelog or set it back to your latest selected trigger directly in the Changelog Hub.

  • Float: Choose the changelog to appear as an omnipresent floating icon in the bottom right corner, ensuring it’s always within reach. You can edit the text that will appear when you over the bell icon.

  • Pulsating: Opt for a pulsating effect to draw attention and prompt users to check out what’s new. It requires to be attached to an element of your website. You just have to paste the given snippet.

    This trigger is designed to be directly integrated into your app. It will transform the element it’s bound to into an interactive element that will open the widget.

  • Side Badge: Go for a side badge for a more discreet yet accessible entry point to your changelog.

  • Custom: Fully tailor the trigger, embedding it into your site in a way that perfectly fits your design schema.

    Now that your widget is correctly set on the Custom option, we need to set up the element in your app. This step requires some knowledge of HTML/Javascript coding and also to have access to the source code of your website. You might need to ask someone in your tech team if you are not familiar with this.

    Here are the steps to follow:

    1. Create the element that should trigger the opening of the widget when a user clicks on it.

      For the purpose of this notice, we will use a simple button as follows:

      <button id="my_custom_trigger">What's new ?</button>

    2. Set a click listener on the created element that will open the widget

      <script>
        const myButton = document.getElementById("my_custom_trigger");
      
        myButton.addEventListener("click", function() {
          window.jimo.push([ "do", "widget:open" ]);
        });
      </script>

      Voilà! You're all good!

Note: we offer a set of methods that allows you to have a more advanced usage of Jimo (set user attributes, listen to widget opening and closing, hide trigger, etc.). Your tech team might be interested. You can find all the methods in our SDK documentation.

Each trigger option is designed to accommodate different styles and levels of visibility, allowing you to match user interaction with the aesthetic and functional flow of your platform.

Manage Your Active Changelog

With an active changelog, streamline your content management:

  • Use the Changelog Hub to edit live posts or respond to user feedback as part of your community engagement strategy. Efficiently moderate and manage your content to ensure relevance and accuracy.

Craft and Share Updates

After customizing your changelog:

  • Directly create and publish new posts, detailing the latest features, fixes, and updates using the 'New post' button.

    For tips and best practices on writing impactful changelog posts, check our guide here.

Review and Refine

Optimize your communication based on user response:

  • Assess the performance of your changelog entries by reviewing key metrics and gathering insights from the analytics dashboard.

    Refine your future posts and strategy by visiting our analytics page here.


FAQ

I don’t see anything on my website

It’s possible that your widget’s appearance needs to be updated. If that's the case, go back to your changelog settings via the Hub. To do so : 1/ Go to the Changelog Hub and click on the "Customize" button 2/ Locate the Trigger section in the Navigator and set the Trigger to “Float” 3/ Save changes Go back to your website and refresh.

Last updated