← Back
Editing: profile_configuration.html
<!DOCTYPE html> <html class="writer-html5" lang="en" data-content_root="../"> <head> <meta charset="utf-8" /> <meta name="readthedocs-addons-api-version" content="1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Profile configuration — Nextcloud latest Administration Manual latest documentation</title> <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=b86133f3" /> <link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=e59714d7" /> <link rel="stylesheet" type="text/css" href="../_static/copybutton.css?v=76b2166b" /> <link rel="stylesheet" type="text/css" href="../_static/custom.css?v=8ff6e0db" /> <link rel="stylesheet" type="text/css" href="../_static/dark_mode_css/general.css?v=c0a7eb24" /> <link rel="stylesheet" type="text/css" href="../_static/dark_mode_css/dark.css?v=70edf1c7" /> <link rel="canonical" href="https://docs.nextcloud.com/server/stable/admin_manual/configuration_user/profile_configuration.html" /> <script src="../_static/jquery.js?v=5d32c60e"></script> <script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script> <script src="../_static/documentation_options.js?v=a49d5d77"></script> <script src="../_static/doctools.js?v=9bcbadda"></script> <script src="../_static/sphinx_highlight.js?v=dc90522c"></script> <script src="../_static/clipboard.min.js?v=a7894cd8"></script> <script src="../_static/copybutton.js?v=f281be69"></script> <script src="../_static/dark_mode_js/default_light.js?v=c2e647ce"></script> <script src="../_static/dark_mode_js/theme_switcher.js?v=358d3910"></script> <script src="../_static/js/theme.js"></script> <script src="../_static/js/versions.js"></script> <link rel="index" title="Index" href="../genindex.html" /> <link rel="search" title="Search" href="../search.html" /> <link rel="next" title="User authentication with OpenID Connect" href="user_auth_oidc.html" /> <link rel="prev" title="Instruction set for apps" href="instruction_set_for_apps.html" /> </head> <body class="wy-body-for-nav"> <div class="wy-grid-for-nav"> <nav data-toggle="wy-nav-shift" class="wy-nav-side"> <div class="wy-side-scroll"> <div class="wy-side-nav-search" > <a href="../contents.html"> <img src="../_static/logo-white.png" class="logo" alt="Logo"/> </a> <div class="switch-menus"> <div class="version-switch"></div> <div class="language-switch"></div> </div> <div role="search"> <form id="rtd-search-form" class="wy-form" action="../search.html" method="get"> <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu"> <p class="caption" role="heading"><span class="caption-text">Getting Started</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li> <li class="toctree-l1"><a class="reference internal" href="../release_schedule.html">Maintenance and release schedule</a></li> <li class="toctree-l1"><a class="reference internal" href="../gdpr/index.html">GDPR-compliance</a></li> <li class="toctree-l1"><a class="reference internal" href="../declarations/index.html">Declarations</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Release notes</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../release_notes/index.html">Critical changes</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Installation</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation and server configuration</a></li> <li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database configuration</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Configuration</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">Nextcloud configuration</a></li> <li class="toctree-l1"><a class="reference internal" href="../occ_command.html">Using the occ command</a></li> <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference management</a></li> <li class="toctree-l1"><a class="reference internal" href="../webhook_listeners/index.html">Webhook Listeners</a></li> <li class="toctree-l1"><a class="reference internal" href="../windmill_workflows/index.html">Windmill Workflows</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Files</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File sharing and management</a></li> <li class="toctree-l1"><a class="reference internal" href="../file_workflows/index.html">Flow</a></li> <li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes management</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Apps</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../apps_management.html">Apps management</a></li> <li class="toctree-l1"><a class="reference internal" href="../exapps_management/index.html">ExApps management</a></li> <li class="toctree-l1"><a class="reference internal" href="../ai/index.html">Artificial Intelligence</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Users</span></p> <ul class="current"> <li class="toctree-l1 current"><a class="reference internal" href="index.html">User management</a><ul class="current"> <li class="toctree-l2"><a class="reference internal" href="user_configuration.html">User management</a></li> <li class="toctree-l2"><a class="reference internal" href="reset_admin_password.html">Resetting a lost admin password</a></li> <li class="toctree-l2"><a class="reference internal" href="reset_user_password.html">Resetting a user password</a></li> <li class="toctree-l2"><a class="reference internal" href="user_password_policy.html">User password policy</a></li> <li class="toctree-l2"><a class="reference internal" href="authentication.html">Authentication</a></li> <li class="toctree-l2"><a class="reference internal" href="two_factor-auth.html">Two-factor authentication</a></li> <li class="toctree-l2"><a class="reference internal" href="user_auth_ldap.html">User authentication with LDAP</a></li> <li class="toctree-l2"><a class="reference internal" href="user_auth_ldap_cleanup.html">LDAP user cleanup</a></li> <li class="toctree-l2"><a class="reference internal" href="user_auth_ldap_api.html">The LDAP configuration API</a></li> <li class="toctree-l2"><a class="reference internal" href="user_provisioning_api.html">User provisioning API</a></li> <li class="toctree-l2 current"><a class="current reference internal" href="#">Profile configuration</a><ul> <li class="toctree-l3"><a class="reference internal" href="#configuration">Configuration</a></li> <li class="toctree-l3"><a class="reference internal" href="#property-scopes">Property scopes</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="user_auth_oidc.html">User authentication with OpenID Connect</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../desktop/index.html">Desktop Clients</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Groupware</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../groupware/index.html">Groupware</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Office</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../office/index.html">Office</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Maintenance</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../configuration_monitoring/index.html">Monitoring</a></li> <li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li> <li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and troubleshooting</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Links</span></p> <ul> <li class="toctree-l1"><a class="reference external" href="https://help.nextcloud.com/">Community Help Forum</a></li> <li class="toctree-l1"><a class="reference external" href="https://docs.nextcloud.com/">User Manuals</a></li> <li class="toctree-l1"><a class="reference external" href="https://docs.nextcloud.com/">Developer Manuals</a></li> <li class="toctree-l1"><a class="reference external" href="https://nextcloud.com/install/">Download</a></li> <li class="toctree-l1"><a class="reference external" href="https://apps.nextcloud.com">App Store</a></li> <li class="toctree-l1"><a class="reference external" href="https://help.nextcloud.com/t/translation-knowledge-valid-for-the-entire-nextcloud-project-wiki/51550">Translations</a></li> <li class="toctree-l1"><a class="reference external" href="https://github.com/nextcloud/">GitHub</a></li> <li class="toctree-l1"><a class="reference external" href="https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule">Supported versions</a></li> <li class="toctree-l1"><a class="reference external" href="https://nextcloud.com/enterprise/">Nextcloud Enterprise</a></li> <li class="toctree-l1"><a class="reference external" href="https://github.com/nextcloud/server/blob/master/COPYING-README">License</a></li> <li class="toctree-l1"><a class="reference external" href="https://nextcloud.com/">Nextcloud GmbH</a></li> </ul> </div> </div> </nav> <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" > <i data-toggle="wy-nav-top" class="fa fa-bars"></i> <a href="../contents.html">Nextcloud latest Administration Manual</a> </nav> <div class="wy-nav-content"> <div class="rst-content style-external-links"> <div role="navigation" aria-label="Page navigation"> <ul class="wy-breadcrumbs"> <li><a href="../contents.html" class="icon icon-home" aria-label="Home"></a></li> <li class="breadcrumb-item"><a href="index.html">User management</a></li> <li class="breadcrumb-item active">Profile configuration</li> <li class="wy-breadcrumbs-aside"> <a href="https://github.com/nextcloud/documentation/edit/master/admin_manual/configuration_user/profile_configuration.rst" class="fa fa-github"> Edit on GitHub</a> </li> </ul> <hr/> </div> <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article"> <div itemprop="articleBody"> <section id="profile-configuration"> <span id="profile"></span><h1>Profile configuration<a class="headerlink" href="#profile-configuration" title="Link to this heading"></a></h1> <p>The user profile presents the information of a user and is enabled by default for all users. Users may individually enable or disable their profile in their Personal info settings under the Personal settings section.</p> <p>As an administrator you may change the default for new users and may also disable profile globally to remove all profile functionality.</p> <p>Profile properties are also written into the <a class="reference internal" href="../groupware/contacts.html#system-address-book"><span class="std std-ref">system address book</span></a>.</p> <div class="admonition note"> <p class="admonition-title">Note</p> <p>If not disabled, the profile is publicly visible. The visibility of the individual profile attributes can be either controlled by the assigned visibility scopes (e.g. “Private” will disable public access), or by the user defined profile visibility.</p> </div> <section id="configuration"> <h2>Configuration<a class="headerlink" href="#configuration" title="Link to this heading"></a></h2> <p>To enable or disable profile by default for new users switch the toggle in Basic settings under the Administration settings section.</p> <figure class="align-default"> <img alt="../_images/profile_default_setting.png" src="../_images/profile_default_setting.png" /> </figure> <p>You may also run the <code class="docutils literal notranslate"><span class="pre">occ</span></code> command below instead to change the default to <code class="docutils literal notranslate"><span class="pre">false</span></code>:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">occ</span> <span class="n">config</span><span class="p">:</span><span class="n">app</span><span class="p">:</span><span class="nb">set</span> <span class="n">settings</span> <span class="n">profile_enabled_by_default</span> <span class="o">--</span><span class="n">value</span><span class="o">=</span><span class="s2">"0"</span> </pre></div> </div> <p>Please refer to <a class="reference internal" href="../occ_command.html"><span class="doc">Using the occ command</span></a> for all available <code class="docutils literal notranslate"><span class="pre">occ</span></code> commands.</p> <p>To disable profile globally add the following line to your <code class="docutils literal notranslate"><span class="pre">config.php</span></code></p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="s1">'profile.enabled'</span> <span class="o">=></span> <span class="n">false</span><span class="p">,</span> </pre></div> </div> <p>Please refer to <a class="reference internal" href="../configuration_server/config_sample_php_parameters.html"><span class="doc">Configuration Parameters</span></a> for all available <code class="docutils literal notranslate"><span class="pre">config.php</span></code> options.</p> </section> <section id="property-scopes"> <span id="profile-property-scopes"></span><h2>Property scopes<a class="headerlink" href="#property-scopes" title="Link to this heading"></a></h2> <p>User properties (Full name, Address, Website, Role, …) have specific visibility scopes (Private, Local, Federated, Published).</p> <p>The visibility scopes are explained below:</p> <dl class="field-list simple"> <dt class="field-odd">Private<span class="colon">:</span></dt> <dd class="field-odd"><p>Contact details visible locally only</p> </dd> <dt class="field-even">Local<span class="colon">:</span></dt> <dd class="field-even"><p>Contact details visible locally and through public link access on local instance</p> </dd> <dt class="field-odd">Federated<span class="colon">:</span></dt> <dd class="field-odd"><p>Contact details visible locally, through public link access and on trusted federated servers.</p> </dd> <dt class="field-even">Published<span class="colon">:</span></dt> <dd class="field-even"><p>Contact details visible locally, through public link access, on trusted federated servers and published to the public lookup server.</p> </dd> </dl> <p>The default values for each property for each new user is listed below, but you should consult the declaration of the <code class="docutils literal notranslate"><span class="pre">DEFAULT_SCOPES</span></code> constant in the <code class="docutils literal notranslate"><span class="pre">OC\Accounts\AccountManager</span></code> class (<a class="reference external" href="https://github.com/nextcloud/server/blob/master/lib/private/Accounts/AccountManager.php">see the code</a>) to make sure these are up-to-date.</p> <table class="docutils align-default"> <thead> <tr class="row-odd"><th class="head"><p>Property</p></th> <th class="head"><p>Default visibility scope</p></th> </tr> </thead> <tbody> <tr class="row-even"><td><p>Full name</p></td> <td><p>Federated</p></td> </tr> <tr class="row-odd"><td><p>Address</p></td> <td><p>Local</p></td> </tr> <tr class="row-even"><td><p>Website</p></td> <td><p>Local</p></td> </tr> <tr class="row-odd"><td><p>Email</p></td> <td><p>Federated</p></td> </tr> <tr class="row-even"><td><p>Avatar</p></td> <td><p>Federated</p></td> </tr> <tr class="row-odd"><td><p>Phone</p></td> <td><p>Local</p></td> </tr> <tr class="row-even"><td><p>Twitter</p></td> <td><p>Local</p></td> </tr> <tr class="row-odd"><td><p>Organisation</p></td> <td><p>Local</p></td> </tr> <tr class="row-even"><td><p>Role</p></td> <td><p>Local</p></td> </tr> <tr class="row-odd"><td><p>Headline</p></td> <td><p>Local</p></td> </tr> <tr class="row-even"><td><p>Biography</p></td> <td><p>Local</p></td> </tr> </tbody> </table> <p>If you’d like to override the value for one or several default visibility scopes, use the <code class="docutils literal notranslate"><span class="pre">account_manager.default_property_scope</span></code> <code class="docutils literal notranslate"><span class="pre">config.php</span></code> configuration key, which defaults to an empty array:</p> <div class="highlight-php notranslate"><div class="highlight"><pre><span></span><span class="x">'account_manager.default_property_scope' => [</span> <span class="x"> \OCP\Accounts\IAccountManager::PROPERTY_PHONE => \OCP\Accounts\IAccountManager::SCOPE_PRIVATE,</span> <span class="x"> \OCP\Accounts\IAccountManager::PROPERTY_ROLE => \OCP\Accounts\IAccountManager::SCOPE_FEDERATED</span> <span class="x">]</span> </pre></div> </div> <p>In the above example, the phone and role properties are respectively overwritten to the private and federated scopes. Note that these changes will only apply to <em>new</em> users, not existing ones.</p> </section> </section> </div> </div> <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer"> <a href="instruction_set_for_apps.html" class="btn btn-neutral float-left" title="Instruction set for apps" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a> <a href="user_auth_oidc.html" class="btn btn-neutral float-right" title="User authentication with OpenID Connect" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a> </div> <hr/> <div role="contentinfo"> <p>© Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.</p> </div> </footer> </div> </div> </section> </div> <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions"> <span class="rst-current-version" data-toggle="rst-current-version"> ☁️ latest <span class="fa fa-caret-down"></span> </span> <div class="rst-other-versions"> <dl> <dt>☁️ Versions</dt> <dd style="width: 32%"> <a href="https://docs.nextcloud.com/server/latest/admin_manual" style="color: var(--dark-link-color);" > latest </a> </dd> <dd style="width: 32%"> <a href="https://docs.nextcloud.com/server/stable/admin_manual" > stable </a> </dd> <dd style="width: 32%"> <a href="https://docs.nextcloud.com/server/32/admin_manual" > 32 </a> </dd> <dd style="width: 32%"> <a href="https://docs.nextcloud.com/server/31/admin_manual" > 31 </a> </dd> </dl> </div> </div> <script> jQuery(function () { SphinxRtdTheme.Navigation.enable(true); }); </script> </body> </html>
Save File
Cancel