Files
zulip/help/logging-in.md
Shubham Padia 7ce87c66ac help: Make loose lists tight for help center files.
In our current implementation, loose lists and tight lists look the same
visually. Loose lists are lists with blank lines between list items, and
the contents of a list item should be enclosed in a paragraph tag in
that case. For unordered lists, paragraph tags have a bottom margin in
starlight and thus looses lists look much more spaced out than tight
lists.

That is not the behaviour we had in mind while writing the
documentation, the reason we had all these loose lists is to make the
documentation easy to write and read. So we attempt to remove all the
blank lines and fix the problem at source. Since paragraph tags are used
for other purposes in a list in starlight, it won't be a wise decision
to let the source be as is and just change things in css, other expected
behaviours might break in that case. See this topic for more details:
https://chat.zulip.org/#narrow/channel/19-documentation/topic/new.20help.20center.3A.20regressions/near/2226084

All the changes were made by a one-off script which has not been
commited to the repo. The script wasn't perfect and could not decide
between blank lines that make a list loose vs blank lines necessary for
a sub-list or a code block inside a list item. A manual review of all
the changes was done before making this commit to ensure that no
unintended changes were made to the help center files.
2025-07-22 14:36:25 -07:00

4.2 KiB

Logging in

By default, Zulip allows logging in via email/password as well as various social authentication providers like Google, GitHub, GitLab, and Apple.

Organization administrators can add other authentication methods, including the SAML and LDAP integrations, or disable any of the methods above.

You can log in with any method allowed by your organization, regardless of how you signed up. For example, if you originally signed up using your Google account, you can later log in using GitHub, as long as your Google account and GitHub account use the same email address.

Find the Zulip log in URL

Here are some ways to find the URL for your Zulip organization.

{start_tabs}

{tab|logged-out}

  • If your organization is hosted on Zulip Cloud (usually at *.zulipchat.com), go to the Find your accounts page and enter the email address that you signed up with. You will receive an email with the sign-in information for any Zulip organizations associated with your email address.
  • Search your email account for a registration email from Zulip. The subject line will include Zulip: Your new account details or Zulip: Your new organization details. This email provides your organization's log in URL.
  • If you have visited your organization's log in page in the past, try reviewing your browser's history. Searching for zulipchat.com should find the right page if your Zulip organization is hosted on Zulip Cloud.
  • You can ask your organization administrators for your Zulip URL.

{tab|logged-in}

  • If using Zulip in the browser, your organization's Zulip log in URL is the first part of what you see in the URL bar (e.g., <organization-name>.zulipchat.com for Zulip Cloud organizations).
  • In the Desktop app, select Copy Zulip URL from the Zulip menu to copy the URL of the currently active organization. You can also access the Copy Zulip URL option by right-clicking on an organization logo in the organizations sidebar on the left.
  • In the Mobile app, tap your profile picture in the bottom right corner of the app, then tap switch account to see the URLs for all the organizations you are logged in to.
  • On Zulip Cloud and other Zulip servers updated to Zulip 6.0 or higher, click the gear () icon in the upper right corner of the web or desktop app. Your organization's log in URL is shown in the top section of the menu.

{end_tabs}

Log in to a new organization

{start_tabs}

{tab|mobile}

{!mobile-switch-account.md!}

  1. Tap Add new account.

  2. Enter the Zulip URL of the organization, and tap Continue.

  3. Follow the on-screen instructions.

{tab|desktop}

!!! warn "" If you are having trouble connecting, you may need to set your proxy settings or add a custom certificate.

  1. Click the add organization () icon in the organizations sidebar on the left. You can also select Add Organization from the Zulip menu in the top menu bar.

  2. Enter the Zulip URL of the organization, and click Connect.

  3. Follow the on-screen instructions.

{!desktop-toggle-sidebar-tip.md!}

{tab|web}

  1. Go to the Zulip URL of the organization.

  2. Follow the on-screen instructions.

{end_tabs}

Switch between organizations

{!switching-between-organizations.md!}

Set or reset your password

If you signed up using passwordless authentication and want to start logging in via email/password, you will need to create a password by following the instructions below. You can also reset a forgotten password.

{!change-password-via-email-confirmation.md!}