Mantine 9.8 is one of the biggest feature releases the React component library has shipped this year. Its changelog is dated 10 November 2026, and a 9.8.1 patch followed on 15 November. It adds a Mentions textarea, an international PhoneInput, a Diff viewer, week and quarter pickers, a masked date input, a whole new @mantine/emoji package and two new hooks. This tutorial shows how to use the most useful pieces in a real form, plus the one behaviour change to check before you upgrade.

Step 1: Upgrade

All @mantine/* packages share one version, so upgrade them together:

npm install @mantine/core@^9.8.1 @mantine/hooks@^9.8.1 @mantine/dates@^9.8.1
# optional packages used below
npm install @mantine/code-highlight@^9.8.1 @mantine/emoji@^9.8.1 @emoji-mart/data

The new @mantine/emoji package lists React and React DOM ^19.2.0 as peer dependencies, so check your React version first.

Mentions: “@” suggestions in a textarea

Mentions is a textarea that opens a suggestions dropdown when the user types @ (or any trigger you set). Picked mentions are stored in the value as @[Display](id) markup, while the user only sees the display text:

import { useState } from 'react';
import { Mentions } from '@mantine/core';

const users = [
  { id: 'asha', display: 'Asha Rao' },
  { id: 'vikram', display: 'Vikram Singh' },
  { id: 'meera', display: 'Meera Iyer' },
];

export function CommentBox() {
  const [value, setValue] = useState('');

  return (
    <Mentions
      label="Comment"
      placeholder="Type @ to mention a teammate"
      value={value}
      onChange={(payload) => setValue(payload.value)}
      minRows={3}
    >
      <Mentions.Mention trigger="@" data={users} />
    </Mentions>
  );
}

Note that onChange gives you a payload object, not a string. Read payload.value.

Getting the mentioned IDs on the server

Because the stored value uses @[Display](id) markup, you can pull out the IDs with a simple regular expression before sending notifications:

const mentionedIds = [...value.matchAll(/@\[[^\]]+\]\(([^)]+)\)/g)].map((m) => m[1]);
// "Hi @[Asha Rao](asha)" -> ["asha"]

Always check those IDs on the server as well. Never trust client-side markup for permissions.

PhoneInput: international numbers with masks

PhoneInput provides a country selector, country detection and formatting masks. Flags are not bundled, which keeps your bundle small. You draw them yourself with renderFlag:

import { PhoneInput } from '@mantine/core';

export function ContactPhone() {
  return (
    <PhoneInput
      label="Phone number"
      placeholder="Your phone number"
      defaultCountry="in"
      renderFlag={(country) => (
        <img
          src={`https://hatscripts.github.io/circle-flags/flags/${country?.iso2 ?? 'xx'}.svg`}
          alt={country?.name ?? 'Select country'}
          style={{ width: 20, height: 20, borderRadius: 20 }}
        />
      )}
    />
  );
}

The changelog example uses defaultCountry="us". Country codes are lowercase ISO 3166-1 alpha-2 codes (country.iso2), so "in" selects India. If you’d rather not load images from a third-party CDN, host the flag SVGs yourself or render emoji flags.

WeekPicker and QuarterPicker for reports

Reporting screens often need “pick a week” or “pick a quarter”. Mantine 9.8 adds both, each with an input version:

import { useState } from 'react';
import { QuarterPickerInput, WeekPickerInput } from '@mantine/dates';

export function ReportFilters() {
  const [week, setWeek] = useState<string | null>(null);
  const [quarter, setQuarter] = useState<string | null>(null);

  return (
    <>
      <WeekPickerInput label="Week" placeholder="Pick a week" value={week} onChange={setWeek} />
      <QuarterPickerInput label="Quarter" placeholder="Pick a quarter" value={quarter} onChange={setQuarter} />
    </>
  );
}

Values are plain YYYY-MM-DD strings:

  • WeekPicker: clicking any day selects the whole week, and the value is the first day of that week according to firstDayOfWeek.
  • QuarterPicker: the value is the first day of the quarter (for Q3 2026 that is 2026-07-01).

Both support picking multiple values and ranges, just like MonthPicker. Watch out for firstDayOfWeek: if your backend assumes Monday-start weeks, set the same value in Mantine’s DatesProvider so both sides agree.

MaskedDateInput for typed dates

MaskedDateInput lets users type a date into separate masked fields for day, month and year. It suits birth dates, where scrolling through a calendar is slow:

import { MaskedDateInput } from '@mantine/dates';

<MaskedDateInput label="Date of birth" />;

It supports configurable field order, custom separators, optional time fields and a calendar dropdown.

Diff: show what changed

The new Diff component in @mantine/code-highlight compares two strings in unified or split (side-by-side) view. You can choose character, word or line granularity, and collapse unchanged context lines:

import { Diff } from '@mantine/code-highlight';

const previousCode = `const [count, setCount] = useState(0);`;
const currentCode = `const [count, dispatch] = useReducer(reducer, 0);`;

export function ChangePreview() {
  return <Diff previousValue={previousCode} currentValue={currentCode} />;
}

It’s handy for audit logs, “review changes before saving” dialogs, and showing what an AI assistant changed in a document or config file.

Emoji picker in three flavours

The new @mantine/emoji package works with any emoji data source through adapters. Adapters for emoji-mart and emojibase-data are included. It offers EmojiPicker, EmojiPickerInput and EmojiPickerPopover:

import { useState } from 'react';
import { ActionIcon } from '@mantine/core';
import data from '@emoji-mart/data';
import { emojiMartAdapter, EmojiPickerPopover } from '@mantine/emoji';

const emojiData = emojiMartAdapter(data);

export function ReactionButton() {
  const [emoji, setEmoji] = useState<string | null>(null);
  return (
    <EmojiPickerPopover data={emojiData} onEmojiSelect={(e) => setEmoji(e.emoji)}>
      <ActionIcon variant="default" size="lg">{emoji || '☺'}</ActionIcon>
    </EmojiPickerPopover>
  );
}

Emoji data files are large. Load the picker lazily, for example with React.lazy or a dynamic import(), so it doesn’t slow down your first page load.

Two new hooks

  • useActiveElement() returns the element that currently has focus. A common use is turning off global keyboard shortcuts while the user is typing in an input.
  • useBrowserLanguage() returns the browser language and updates when the user changes it. It is useful for picking a default locale.
import { useActiveElement } from '@mantine/hooks';

const active = useActiveElement();
const typing = active?.tagName === 'INPUT' || active?.tagName === 'TEXTAREA';

Behaviour change to check

Keyboard navigation in @mantine/dates pickers has been improved. Arrow keys now move focus across months, and focus returns to the input when the dropdown closes. That is better for accessibility, but tests that check which element has focus after closing a picker may now fail. Update those tests.

Other smaller additions include slotLabelInterval and minute-level businessHours for DayView and WeekView, clickOutsideCapture on Popover, and autoCloseProgressPosition for notifications.

Takeaway

Mantine 9.8 fills common gaps that teams used to cover with extra libraries: mentions, phone numbers, week and quarter pickers, diffs and emoji. Upgrade every @mantine/* package together, render your own flags for PhoneInput, lazy-load the emoji picker, and check focus-related tests in date pickers. Full details are in the Mantine 9.8.0 changelog.