Cysill Outlook Add-in Support

User guide

Click here for the sysadmin guide.

How to use Cysill in Microsoft Outlook

Locating the add-in

The Cysill button can be found when composing a new email or replying to an
email. It appears in the Outlook ribbon, in the same tab as the standard
composition tools.

Checking your text

  1. Write your email in Welsh
  2. Select the text you wish to check
  3. Click the Cysill button in the ribbon
  4. A task pane will appear on the right side of the window

Cysill will analyse the selected text and display any spelling, grammar, and
mutation errors.

Correcting errors

When Cysill identifies an error:

  1. A card will appear showing:
    • The error type (spelling or grammar)
    • The text in context, with the error highlighted
    • A brief explanation of the error
    • Up to five suggested corrections
  2. Click on the correction you wish to use
  3. Press the Accept button to confirm the change
  4. The card will disappear and the change counter will increment
  5. After completing all corrections, click Update to apply the changes to
    your email

Using the personal dictionary

If Cysill flags a word that is correct but not in its dictionary:

  1. Click the Learn button on the error card
  2. The word will be added to your personal dictionary
  3. The word will not be flagged as an error in future sessions
  4. To manage your personal dictionary:
    • Click the dictionary button in the Outlook ribbon
    • A list of your learned words will appear
    • Click on any word to delete it from the dictionary

Ignoring words

If you wish to ignore a word for the current session only:

  1. Click the Ignore button on the error card
  2. The card will disappear
  3. The word may be flagged again in future sessions

Changing the interface language

Cysill is available in Welsh and English:

  1. Look at the bottom of the Cysill task pane
  2. Click on Cymraeg or English to switch language
  3. All interface labels will update immediately

If the Cysill button does not appear

If you cannot see the Cysill button in the ribbon:

  1. Look at the upper right corner of the email
  2. If Outlook is displaying a simplified version of the ribbon, click the down
    arrow to reveal all buttons

Cysill for Microsoft Outlook – deployment guide

Overview

Cysill is a Welsh language spell-checker and grammar correction add-in for
Microsoft Outlook developed by Bangor University’s Language Technologies Unit
(Uned Technolegau Iaith).

Version: 26.04.0
Developer: Prifysgol Bangor University
Support: cysgliad@bangor.ac.uk

Key features

  • Spell checking and grammar checking for Welsh text
  • Personal dictionary management
  • Bilingual interface (Welsh / English)
  • Contextual error display with correction suggestions
  • Batch correction updates

Security & privacy

Local processing architecture

The add-in processes all text locally on the user’s device. The proofing runs
in the browser / desktop app using WebAssembly. Email content is not
transmitted to external servers for analysis. The user’s personal dictionary is
stored in browser local storage and is not shared between devices or programs.

Permissions required

ReadWriteItem allows the add-in to:

  • Read content of emails being composed
  • Modify selected text in emails

See the Microsoft documentation

External connections

  1. CDN resources. This is required for the add-in to function. Add-in files are
    loaded from our Content Delivery Network, served via HTTPS.

Supported platforms

  • Microsoft Outlook (Desktop App – Windows)
  • Outlook 365 (Web – All platforms)

The MacOS desktop app is not currently supported.

Installation & deployment

Option 1: centralised deployment

Deploy via Microsoft 365 Admin Center:

  1. Download the manifest.xml file
  2. Access Microsoft 365 Admin Center
  3. Navigate to Settings > Integrated apps > Add-ins
  4. Upload the manifest file
  5. Assign to users or groups

Option 2: manual installation

Individual users can side-load the add-in:

  1. Provide users with the manifest.xml file
  2. Go to https://aka.ms/olksideload and wait for the pop-up
  3. Select My add-ins > Add a custom add-in > Add from file
  4. Browse and select the manifest file
  5. Confirm installation
  6. Microsoft will sync the add-in to your desktop app automatically, it may
    take a day. Reload the web version (Ctrl+Shift+R) and you should see the
    add-in there immediately.

Verification

After installation, users should see a Cysill button in the Outlook ribbon
when composing new emails or replies. It is available in the Message and
Insert ribbons. Clicking the button opens a task pane on the right side.

Support & privacy

Support contact

Email: cysgliad@bangor.ac.uk
Web: https://www.cysgliad.com/en/help/cysill-outlook-addin-support/
Privacy policy: https://termau.cymru/termau-outlook-add-in-privacy-policy/?lang=en