v2.9.0

[abhinavxd]

Railway

If you are using Railway.com please read this important announcement about moving postgres data to volume.

What's new

WhatsApp channel

• WhatsApp inbox - connect a WhatsApp Business number through the Meta Cloud API, with templates.

Live chat widget

• Proactive messages - message visitors first based on the page they are on, their device, business hours or time on the page.

• Help center in the widget - visitors can browse help center articles inside the widget.

• Widget language from the host page - set language in the widget settings or call Libredesk.setLanguage() to switch it.

  Example

  Set the inbox language to automatic detection, then add language to your existing widget settings:

  <script>
    window.LibredeskSettings = {
      baseURL: 'https://support.example.com',
      inboxID: 'YOUR_INBOX_UUID',
      language: 'de-DE'
    };
  </script>
  <script async src="https://support.example.com/widget.js"></script>

  After the widget initializes, switch languages when the visitor changes your website's language:

  window.Libredesk.setLanguage('fr-FR');

Email

• Email aliases - an inbox can receive mail at several addresses, and agents pick the reply From address.

• Earlier messages in email templates - use {{ .PreviousMessages }} in outgoing email templates to quote messages the contact already saw.

  Example to add to your outgoing email template

  {{ if .PreviousMessages }}
    <div style="margin-top: 28px; padding-top: 20px; border-top: 1px solid #ddd;">
      <div style="margin-bottom: 16px; font-size: 13px; color: #888;">Previous messages</div>
      {{ range .PreviousMessages }}
        <blockquote style="margin: 0 0 20px; padding: 0 0 0 14px; border-left: 2px solid #ddd;">
          <div style="margin-bottom: 6px; font-size: 12px; line-height: 20px; color: #888;">
            On {{ .CreatedAt.Format "02 Jan 2006 at 15:04 MST" }},
            {{ if .SenderName }}{{ .SenderName }}{{ else }}{{ .SenderEmail }}{{ end }} wrote:
          </div>
          <div style="font-size: 14px; line-height: 24px; color: #444; overflow-wrap: anywhere;">
            {{ .Content }}
          </div>
        </blockquote>
      {{ end }}
    </div>
  {{ end }}

• Recipient filter in automation rules - match rules on the To addresses of new email conversations.

Agent dashboard

• AI tools in copilot - copilot and generate reply can call custom AI tools, with agent approval.
• Notification preferences - agents choose which notifications they get in the app, by email and as browser push.
• Install as an app - install libredesk on desktop or phone and get push notifications.
• Command palette - jump to any page, find conversations and contacts, and assign, tag or change status in bulk.
• Search filters - filter, sort and page conversation search results.

Help center

• Dark mode - show the help center in light, dark or the visitor's system setting.
• Linked translations - link an article to another as its translation.

What's fixed

• Much lower memory and CPU use. An instance with about 5,000 conversations a day and 500 agents logged in stays between 300 MB and 560 MB of memory over the day.
• Uploaded SVG files can no longer run scripts.
• Agent sessions now end when the password changes or the account is disabled.
• Replies in long email threads are no longer rejected by SMTP servers.
• AI tool calls with Gemini 3 models no longer fail.
• Many other quality of life fixes and improvements.

Upgrade notes

• Always take a database backup before upgrading.
• If you deployed with the Railway template before 1 October 2026, read this announcement about moving Postgres data to a volume.
• Follow the steps here.

Changelog

• 5668a2a Merge pull request simplify the campaign repeat label #734 from abhinavxd/fix/campaign-repeat-label
• d0d6daf simplify the campaign repeat label
• 0debc8d Merge pull request align inbox channel card headings #731 from abhinavxd/fix/inbox-card-alignment
• 890cdb7 exclude holiday shifts from overnight campaign working hours
• f8af161 reject stale campaign responses from earlier page visits
• a1c44cc fix campaign navigation and overnight hours
• fa31a75 fix system email layout assertions
• 1b2d0ae polish shared controls and compact system email layouts
• 83c6761 update widget JavaScript API examples
• 627d377 fix settings footers and preview tabs
• c8463d1 fix reply editor focus after draft loading
• f0eb223 align inbox channel card headings
• 2dc96fc Merge pull request fix login layout and agent control spacing #730 from abhinavxd/fix/release-ui-spacing
• f7d8ed5 show all permitted sidebar sections when reordering
• 8385b6b fix login layout and agent control spacing

What's Changed (Auto generated)

• Fixes thumbnail rotation issues by @eozsahin1993 in Fixes thumbnail rotation issues #539
• feat: add separate permission for private conversation notes by @LaQuay in feat: add separate permission for private conversation notes #549
• api: accept source_id on conversation and message endpoints by @malpou in api: accept source_id on conversation and message endpoints #544
• oidc: resolve redirect URL live so Root URL changes without a restart (preferred option) by @malpou in oidc: resolve redirect URL live so Root URL changes without a restart (preferred option) #548
• Fix: disable mentions for replies in tiptap by @eozsahin1993 in Fix: disable mentions for replies in tiptap #543
• Feat: read receipt indicator by @eozsahin1993 in Feat: read receipt indicator #540
• search and paginate agents, teams, tags and macros instead of loading them all at boot by @abhinavxd in search and paginate agents, teams, tags and macros instead of loading them all at boot #537
• feat: show open conversation counts in the inbox sidebar by @amb1 in feat: show open conversation counts in the inbox sidebar #534
• Update translations [2026-09-02] by @jleroy in Update translations [2026-09-02] #555
• rebuild the command palette and add keyboard shortcuts for conversation actions by @abhinavxd in rebuild the command palette and add keyboard shortcuts for conversation actions #556
• Bump qs from 6.15.2 to 6.16.0 in /frontend by @dependabot[bot] in Bump qs from 6.15.2 to 6.16.0 in /frontend #559
• Add conversation reference links to private notes by @fredrikblau in Add conversation reference links to private notes #475
• Implement create contact functionality by @Gumbraise in Implement create contact functionality #312
• move new contact button to the right of the contacts toolbar by @abhinavxd in move new contact button to the right of the contacts toolbar #572
• CRUD for editor ai prompts. by @abhinavxd in CRUD for editor ai prompts. #577
• feat(auth): add SSO-only login mode by @pat-s in feat(auth): add SSO-only login mode #492
• Bump vitest from 4.1.0 to 4.1.11 in /frontend by @dependabot[bot] in Bump vitest from 4.1.0 to 4.1.11 in /frontend #594
• Conversation list: show a priority marker on each row by @pmslava in Conversation list: show a priority marker on each row #578
• fix: truncate CSAT feedback by runes to preserve valid UTF-8 by @anvme in fix: truncate CSAT feedback by runes to preserve valid UTF-8 #601
• fix: don't render raw driver errors on CSAT submit by @anvme in fix: don't render raw driver errors on CSAT submit #602
• fix: prevent duplicate CSAT submissions under concurrency by @anvme in fix: prevent duplicate CSAT submissions under concurrency #603
• Fix: Ensure email text visibility in Dark Mode ([Bug] Dark mode doesn't show black email text #449) by @IzzaldinSamir in Fix: Ensure email text visibility in Dark Mode (#449) #452
• add per-agent notification preferences by @abhinavxd in add per-agent notification preferences #607
• remove icon from new contact button by @abhinavxd in remove icon from new contact button #610
• add Kathmandu timezone option by @abhinavxd in add Kathmandu timezone option #615
• add filters, pagination and richer results to conversation search by @abhinavxd in add filters, pagination and richer results to conversation search #612
• Custom AI tools to copilot and generate reply with human approval by @abhinavxd in Custom AI tools to copilot and generate reply with human approval #620
• show idle agents as online instead of away by @abhinavxd in show idle agents as online instead of away #621
• speed up builds and load app layouts on demand by @abhinavxd in speed up builds and load app layouts on demand #622
• Widget improvements by @abhinavxd in Widget improvements #619
• fix mobile layouts by @abhinavxd in fix mobile layouts #618
• move the reply box minimize line to the bottom of its button by @abhinavxd in move the reply box minimize line to the bottom of its button #637
• fix content spilling out of panels and dialogs when zoomed in or out by @abhinavxd in fix content spilling out of panels and dialogs when zoomed in or out #642
• stop uploaded SVG files from running scripts by @abhinavxd in stop uploaded SVG files from running scripts #641
• use the IsEncrypted helper in crypto package by @h3ssan in use the IsEncrypted helper in crypto package #652
• Feat whatsapp by @abhinavxd in Feat whatsapp #496
• feat: add recipient filter to automation rules by @Norbiros in feat: add recipient filter to automation rules #488
• Bump axios from 1.18.0 to 1.20.0 in /frontend by @dependabot[bot] in Bump axios from 1.18.0 to 1.20.0 in /frontend #669
• tune animations across the app and widget by @abhinavxd in tune animations across the app and widget #666
• ignore case sensitive match on contact email automation rules by @abhinavxd in ignore case sensitive match on contact email automation rules #671
• fix notification and conversation read state by @abhinavxd in fix notification and conversation read state #672
• fix security issues found in repository review by @abhinavxd in fix security issues found in repository review #645
• feat(inbox): Implement inbox aliases for sending and receiving by @Sanielia in feat(inbox): Implement inbox aliases for sending and receiving #558
• fix chat scrolling and related article spacing by @abhinavxd in fix chat scrolling and related article spacing #679
• add help article citations to AI replies by @abhinavxd in add help article citations to AI replies #680
• Fix replies rejected for long SMTP headers by @abhinavxd in Fix replies rejected for long SMTP headers #682
• trim long notification text so bell notifications save by @abhinavxd in trim long notification text so bell notifications save #686
• fix(frontend): expose macros on mobile by @samuelsogbesan in fix(frontend): expose macros on mobile #684
• Preserve tool call extra_content so Gemini thought signatures round-trip by @fredrikblau in Preserve tool call extra_content so Gemini thought signatures round-trip #678
• raise macro content limit to 100000 characters by @abhinavxd in raise macro content limit to 100000 characters #690
• use a parameterized query to record migration versions by @abhinavxd in use a parameterized query to record migration versions #689
• Conversation: expose the inbox to the outgoing email template by @pmslava in Conversation: expose the inbox to the outgoing email template #587
• fix Unicode text truncation by @abhinavxd in fix Unicode text truncation #691
• polish app layouts and fix UI regressions by @abhinavxd in polish app layouts and fix UI regressions #687
• Live chat widget: let the host page choose the UI language by @sunyinghao5438 in Live chat widget: let the host page choose the UI language #668
• fix reply notifications and repeated agent lookups by @abhinavxd in fix reply notifications and repeated agent lookups #703
• capitalize contact names taken from the email address by @abhinavxd in capitalize contact names taken from the email address #708
• Bug fix: fall back to reference number as subject for empty-subject email conversations by @sneha-thyagarajan in Bug fix: fall back to reference number as subject for empty-subject email conversations #709
• add earlier messages as a variable in the outgoing email template by @abhinavxd in add earlier messages as a variable in the outgoing email template #710
• Update translations [2026-10-19] by @jleroy in Update translations [2026-10-19] #711
• sidebar: list all of the contact's conversations, highlight the current one by @maximilize in sidebar: list all of the contact's conversations, highlight the current one #714
• fix issues found during release testing by @abhinavxd in fix issues found during release testing #712
• improve admin table layout by @abhinavxd in improve admin table layout #716
• Bump vite from 6.4.3 to 6.4.4 in /frontend by @dependabot[bot] in Bump vite from 6.4.3 to 6.4.4 in /frontend #718
• Bump github.com/klauspost/compress from 1.18.0 to 1.18.7 by @dependabot[bot] in Bump github.com/klauspost/compress from 1.18.0 to 1.18.7 #717
• fix login layout and agent control spacing by @abhinavxd in fix login layout and agent control spacing #730
• align inbox channel card headings by @abhinavxd in align inbox channel card headings #731
• simplify the campaign repeat label by @abhinavxd in simplify the campaign repeat label #734

New Contributors

• @eozsahin1993 made their first contribution in Fixes thumbnail rotation issues #539
• @LaQuay made their first contribution in feat: add separate permission for private conversation notes #549
• @malpou made their first contribution in api: accept source_id on conversation and message endpoints #544
• @amb1 made their first contribution in feat: show open conversation counts in the inbox sidebar #534
• @fredrikblau made their first contribution in Add conversation reference links to private notes #475
• @Gumbraise made their first contribution in Implement create contact functionality #312
• @pmslava made their first contribution in Conversation list: show a priority marker on each row #578
• @anvme made their first contribution in fix: truncate CSAT feedback by runes to preserve valid UTF-8 #601
• @IzzaldinSamir made their first contribution in Fix: Ensure email text visibility in Dark Mode (#449) #452
• @h3ssan made their first contribution in use the IsEncrypted helper in crypto package #652
• @Norbiros made their first contribution in feat: add recipient filter to automation rules #488
• @Sanielia made their first contribution in feat(inbox): Implement inbox aliases for sending and receiving #558
• @samuelsogbesan made their first contribution in fix(frontend): expose macros on mobile #684
• @sunyinghao5438 made their first contribution in Live chat widget: let the host page choose the UI language #668
• @sneha-thyagarajan made their first contribution in Bug fix: fall back to reference number as subject for empty-subject email conversations #709
• @maximilize made their first contribution in sidebar: list all of the contact's conversations, highlight the current one #714

Full Changelog: v2.8.0...v2.9.0

---

This discussion was created from the release v2.9.0.