Managing Contacts

Opterius Mail includes a built-in address book that lets you store contact information locally. Contacts are used for autocomplete when composing messages, and you can manage them independently of your email.

Where Contacts Are Stored#

Contacts are stored in the contacts table in Opterius Mail's local database. Each contact is keyed to your email address — contacts you create are yours alone and are not visible to other users of the same Opterius Mail installation.

Important: Contacts are local to this Opterius Mail installation. They are not synced to your IMAP server, other mail clients (Outlook, Thunderbird, etc.), or a CardDAV server. If you want contacts in other applications, export them (see Importing & Exporting Contacts) and import them there.

Opening the Contacts Section#

The contacts section is accessible from:

• The sidebar: Click the Contacts icon (person/silhouette icon) in the left navigation.
• The top navigation bar: Some templates include a Contacts link in the main navigation.
• The keyboard shortcut: Press G then C to jump to Contacts.

The Contacts List#

The contacts list shows all your saved contacts with:

• Display name (or email if no name is set)
• Primary email address
• Quick action buttons (Edit, Delete)

Contacts are sorted alphabetically by display name. Use the search box at the top of the contacts list to filter by name, email, or phone number.

Creating a Contact#

1. Click the New Contact button (+ icon) at the top of the contacts list.
2. Fill in the contact form:

3. Click Save contact.

The contact is immediately available for autocomplete in the compose window.

Adding Multiple Email Addresses#

A single contact can have multiple email addresses (e.g. personal and work). Click + Add email in the contact form to add another address. Each email address can be labeled: Home, Work, or Other.

When composing, typing part of the contact's name will suggest all of their email addresses.

Editing a Contact#

1. Find the contact in the list (or search for them).
2. Click the Edit button (pencil icon) on their card.
3. The same form used for creating appears, pre-filled with their existing details.
4. Make your changes and click Save contact.

Deleting a Contact#

1. Find the contact in the list.
2. Click the Delete button (bin icon) on their card.
3. A confirmation dialog appears. Click Delete to confirm.

Deletion is permanent — there is no undo. If you delete a contact by accident, you will need to re-create them manually or restore from an export.

Note: Deleting a contact does not affect any emails sent to or received from them. It only removes them from your address book.

Searching Contacts#

Type in the search box at the top of the contacts list to filter in real time. The search checks:

• Display name
• First and last name
• Email addresses
• Organization name
• Phone numbers

The filter updates as you type — no need to press Enter.

Contact Groups#

Contact groups (also called labels or categories) allow you to organize contacts into named collections (e.g. "Family", "Work", "Newsletter"). Groups are displayed in a panel on the left of the contacts section.

To create a group:

1. Click + New Group in the contacts sidebar.
2. Give the group a name.

To add a contact to a group:

1. Edit the contact.
2. In the Groups field, select one or more groups.

When composing, you can type a group name in the To field to add all members of that group as recipients at once.

Notes on Sync#

Contacts in Opterius Mail are local database records only. They are not exposed via CardDAV. If you use mobile devices or desktop clients and want contacts synchronized across all of them, you will need a separate CardDAV solution (such as Nextcloud Contacts, Radicale, or a hosted CardDAV service).