Skip to content

Emphasize account types (CalDAV/CardDAV) for iOS sync in groupware/sync_ios.rst #14182

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Helianthropy wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Emphasize account types (CalDAV/CardDAV) for iOS sync in groupware/sync_ios.rst #14182

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions user_manual/groupware/sync_ios.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Calendar
#. Select Calendar Accounts.
#. Select Add Account.
#. Select Other as account type.
#. Select Add CalDAV account.
#. Select Add **CalDAV** account.
#. For server, type the domain name of your server i.e. ``example.com``.
#. Enter your user name and password.
#. Select Next.
Expand All @@ -30,6 +30,8 @@ Your calendar will now be visible in the Calendar application.
.. note:: Beginning with iOS 12 an SSL encryption is necessary. Therefore do **not** disable **SSL**
(For this reason a certificate is required at your domain, https://letsencrypt.org/ will do).

.. note:: If you select **CardDAV** only contact syncing will be made available.


Contacts
--------
Expand All @@ -40,7 +42,7 @@ Contacts
#. Select Contacts Accounts.
#. Select Add Account.
#. Select Other as account type.
#. Select Add CardDAV account.
#. Select Add **CardDAV** account.
#. For server, type the domain name of your server and path, i.e., ``example.com/remote.php/dav/principals/users/username/`` (replace **example.com** and **username**).
#. Enter your user name and password.
#. Select Next.
Expand All @@ -50,6 +52,8 @@ You should now find your contacts in the address book of your iPhone.
.. note:: Beginning with iOS 12 an SSL encryption is necessary. Therefore do **not** disable **SSL**
(For this reason a certificate is required at your domain, https://letsencrypt.org/ will do).

.. note:: If you select **CalDAV** only calendar syncing will be made available.

Comment on lines +55 to +56
Copy link
Copy Markdown
Contributor

@miaulalala miaulalala Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

shouldn't this be the other way around? Or am I missing the purpose of this note?

Copy link
Copy Markdown
Author

@Helianthropy Helianthropy Apr 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@miaulalala, The purpose was to point out potential errors the user may have made. Referring to my specific case, I was wondering why attempting to add a calendar only left me with contact syncing (in this case, it was because I must have previously selected CardDAV and never tried the add step again—merely attempting to refresh my settings in hopes that the calendar would appear). This specifically points out a potential error (and how it manifests) that may not be obvious to notice once it’s made without this foreknowledge. I replicated the same perspective for folks wanting contact syncing who may have only added a CalDAV account.

Retracing my steps when first looking to this documentation for support, after reviewing the steps, I thought everything was looking fine, then checked notes for other hints of an error. The notes did not help me in that moment and it was only after I later noticed the Account Settings title read “CardDAV” that I realized my error.

I think the other way around would serve a similar purpose in providing a hint to the user trying to figure this out (one account doesn’t support all features), but I feel like pointing out an exact problem might register a bit better for the troubleshooting user who may otherwise feel they did follow the instructions correctly—but being so close to this issue, I might be a bit biased.


If it's still not working, have a look at `Troubleshooting Contacts & Calendar`_ or `Troubleshooting Service Discovery`_.

Expand Down