<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" style="task"
      id="user-changepassword">

  <info>
    <link type="guide" xref="user-accounts#passwords"/>
    <link type="seealso" xref="user-goodpassword"/>
    <link type="seealso" xref="user-admin-explain"/>

    <revision pkgversion="3.8.0" date="2013-03-09" status="candidate"/>
    <revision pkgversion="3.10" date="2013-11-01" status="review"/>
    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
    <revision pkgversion="3.18" date="2015-09-28" status="final"/>

    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list@gnome.org</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>
    </credit>

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

    <desc>Keep your account secure by changing your password often in your
    account settings.</desc>
  </info>

  <title>Change your password</title>

  <comment>
    <cite date="2012-02-19">shaunm</cite>
    <p>We need a note in here about password hints. Share content with
    user-add</p>
    <p>Turns out that you get a dialog to change the keyring password when
    you log in after changing your password. Mention that in a blurb above
    the steps above #changepass below. "When you next log in, you will be
    asked to…. If you prefer to change the keyring password immediately,
    do this:</p>
  </comment>

  <comment>
    <cite date="2012-02-19">shaunm</cite>
    <p>We need pages on the keyring. Link to them from the section
    below on changing your keyring password. This page can still go
    final for 3.0.x without that, but leave this comment in for 3.2.</p>
  </comment>

  <comment>
    <cite date="2012-02-19">mdhill</cite>
    <p>Not prompted to change keyring password on next login in 3.2, wording
    changed. Keyring pages still need adding. Bug 643445 indicates password
    hints not implemented yet in GDM.</p>
  </comment>

  <p>It is a good idea to change your password from time to time, especially if
  you think someone else knows your password.</p>

  <p>You need <link xref="user-admin-explain">administrator privileges</link>
  to edit user accounts other than your own.</p>

  <steps>
    <item>
      <p>Open the <gui xref="shell-introduction#activities">Activities</gui> overview and
      start typing <gui>Users</gui>.</p>
    </item>
    <item>
      <p>Click <gui>Users</gui> to open the panel.</p>
    </item>
    <item>
      <p>Click the label <gui>·····</gui> next to <gui>Password</gui>. If you
      are changing the password for a different user, you will first need to
      <gui>Unlock</gui> the panel.</p>
    </item>
    <item>
      <p>Enter your current password, then a new password. Enter your new
      password again in the <gui>Verify New Password</gui> field.</p>
      <p>You can press the <gui style="button"><media its:translate="no"
      type="image" src="figures/system-run-symbolic.svg" width="16" height="16">
      <span its:translate="yes">generate password</span></media></gui> icon to
      automatically generate a random password.</p>
    </item>
    <item>
      <p>Click <gui>Change</gui>.</p>
    </item>
  </steps>

  <p>Make sure you <link xref="user-goodpassword">choose a good
  password</link>. This will help to keep your user account safe.</p>

  <note>
    <p>When you update your login password, your login keyring password will
    automatically be updated to be the same as your new login password.</p>
  </note>

  <p>If you forget your password, any user with administrator privileges can
  change it for you.</p>

</page>