<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="accounts-add">

  <info>
    <link type="guide" xref="accounts" group="add"/>

    <revision pkgversion="3.5.5" date="2012-08-14" status="draft"/>
    <revision pkgversion="3.9.92" date="2012-09-18" status="candidate"/>
    <revision pkgversion="3.13.92" date="2013-09-20" status="candidate"/>
    <revision pkgversion="3.18" date="2015-09-28" status="final"/>
    <revision pkgversion="3.33.3" date="2019-07-21" status="final"/>

    <credit type="author">
      <name>Jim Campbell</name>
      <email>jwcampbell@gmail.com</email>
    </credit>
    <credit type="editor">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
    </credit>
    <credit type="editor">
      <name>Ekaterina Gerasimova</name>
      <email>kittykat3756@gmail.com</email>
      <years>2014</years>
    </credit>
    <credit type="editor">
      <name>Shaun McCance</name>
      <email>shaunm@gnome.org</email>
      <years>2015</years>
    </credit>
    <credit type="editor">
      <name>Klein Kravis</name>
      <email>kleinkravis44@outlook.com</email>
      <years>2020</years>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Allow applications to access your accounts online for files,
    contacts, calendars, and more.</desc>
</info>

  <title>Add an account</title>

  <p>Adding an account will help link your online accounts with your
desktop. Thus, your email client, calendar and other related
  applications will be set up for you.</p>

  <steps>
    <item>
      <p>Open the <gui xref="shell-introduction#activities">Activities</gui> overview and
      start typing <gui>Online Accounts</gui>.</p>
    </item>
    <item>
      <p>Click on <gui>Online Accounts</gui> to open the panel.</p>
    </item>
    <item>
      <p>Select an account from the list.</p>
    </item>
    <item>
      <p>Select the type of account you want to add.</p>
    </item>
    <item>
      <p>A dialog will open where you can either enter your online account
      credentials or a button which will open your web browser to log into the
      account. For example, if you are setting up a Google account, click
      <gui>Sign in...</gui> and then enter your email address and password.</p>
    </item>
    <item>
      <p>If you have entered your credentials correctly, you will be prompted
      to allow GNOME access to your online account. Authorize access to
      continue.</p>
    </item>
    <item>
      <p>All services that are offered by an account provider will be enabled
      by default. <link xref="accounts-disable-service">Switch</link>
      individual services to off to disable them.</p>
    </item>
  </steps>

  <p>After you have added accounts, applications can use those accounts for
  the services you have chosen to allow. See <link xref="accounts-disable-service"/>
  for information on controlling which services to allow.</p>

  <note style="tip">
    <p>Many online services provide an authorization token which GNOME stores
    instead of your password. If you remove an account, you should also revoke
    that certificate in the online service. See <link xref="accounts-remove"/>
    for more information.</p>
  </note>

</page>
