{"id":7509,"date":"2026-04-10T02:20:42","date_gmt":"2026-04-10T00:20:42","guid":{"rendered":"https:\/\/mybox.com\/help\/?post_type=manual_kb&#038;p=7509"},"modified":"2026-04-10T02:20:43","modified_gmt":"2026-04-10T00:20:43","slug":"basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress","status":"publish","type":"manual_kb","link":"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/","title":{"rendered":"Basic User Avatars: How to Manage Local Profile Photos in WordPress"},"content":{"rendered":"\n<div class=\"translation-block translation-block-merged\">\n<p class=\"wp-block-paragraph\">By default, WordPress uses Gravatar\u2014a third-party service\u2014to display user profile pictures. While convenient, many site owners prefer to host images locally to improve privacy, comply with data protection regulations, or simply give users a more direct way to upload photos without leaving the website.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Basic User Avatars<\/strong> is a lightweight, efficient plugin that allows users to upload custom profile photos directly to your <strong>mybox<\/strong> server.<\/p>\n\n\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_86 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/#Key_Features_and_Benefits\" >Key Features and Benefits<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/#Step-by-Step_Installation_and_Setup\" >Step-by-Step Installation and Setup<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/#How_to_Use_the_Front-End_Form\" >How to Use the Front-End Form<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/#Migrating_from_WP_User_Avatar\" >Migrating from WP User Avatar<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/#Performance_and_Best_Practices\" >Performance and Best Practices<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/#Troubleshooting_Common_Issues\" >Troubleshooting Common Issues<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/basic-user-avatars-how-to-manage-local-profile-photos-in-wordpress\/#Summary\" >Summary<\/a><\/li><\/ul><\/nav><\/div>\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Key_Features_and_Benefits\"><\/span>Key Features and Benefits<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Local Hosting:<\/strong> Images are stored in your WordPress Media Library on the <strong>mybox<\/strong> infrastructure, keeping user data under your control.<\/li>\n\n\n\n<li><strong>Front-End Support:<\/strong> Use a simple shortcode to allow users to change their photos on &#8220;My Account&#8221; or &#8220;Profile&#8221; pages without accessing the dashboard.<\/li>\n\n\n\n<li><strong>bbPress Integration:<\/strong> Automatically adds upload fields to bbPress forum profiles.<\/li>\n\n\n\n<li><strong>Lightweight Code:<\/strong> Optimized to run without slowing down your site&#8217;s performance.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Step-by-Step_Installation_and_Setup\"><\/span>Step-by-Step Installation and Setup<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Log in to your WordPress dashboard and go to <strong>Plugins > Add New<\/strong>.<\/li>\n\n\n\n<li>Search for <strong>&#8220;Basic User Avatars&#8221;<\/strong>, install, and activate it.<\/li>\n\n\n\n<li><strong>Configure Permissions:<\/strong> Go to <strong>Settings > Discussion<\/strong>. Look for the &#8220;Local Avatars&#8221; section.\n<ul class=\"wp-block-list\">\n<li>If you want to restrict uploads to specific roles (like Authors or Editors), check the box to limit uploads to users with file upload permissions.<\/li>\n\n\n\n<li>Leave it unchecked if you want all registered users (including Subscribers) to upload their own avatars.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"How_to_Use_the_Front-End_Form\"><\/span>How to Use the Front-End Form<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<\/div>\n\n<div id=\"mybox-338637446\" class=\"mybox-content mybox-entity-placement\"><div class=\"early-access-banner-inpost\">\r\n  <div class=\"banner-left-inpost\">\r\n    <div class=\"icon-box-inpost\">\r\n      <img decoding=\"async\" src=\"https:\/\/mybox.com\/help\/wp-content\/uploads\/2026\/02\/square-info-icon.svg\" alt=\"Info\">\r\n    <\/div>\r\n    <div class=\"text-box-inpost\">\r\n      <span class=\"label-inpost\"><span class=\"translation-block translation-block-banner-text\">Early access<\/span><\/span>\r\n      <h4><span class=\"translation-block translation-block-banner-text\">Still need help?<\/span><\/h4>\r\n      <p><span class=\"translation-block translation-block-banner-text\">Contact our customer service team.<\/span><\/p>\r\n    <\/div>\r\n  <\/div>\r\n\r\n  <div class=\"banner-right-inpost\">\r\n    <a href=\"https:\/\/panel.mybox.com\/helpdesk2\/v\/list\/\" class=\"banner-button-inpost\"><span class=\"translation-block translation-block-banner-text\">Message us<\/span><\/a>\r\n  <\/div>\r\n<\/div><\/div>\n\n<div class=\"translation-block translation-block-merged\"><p class=\"wp-block-paragraph\">To allow users to upload photos from the front end of your site (essential for WooCommerce or membership sites), place the following shortcode on any page:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>[basic-user-avatars]<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When a user visits that page, they will see their current avatar along with a &#8220;Choose File&#8221; button and a &#8220;Delete&#8221; option.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Migrating_from_WP_User_Avatar\"><\/span>Migrating from WP User Avatar<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If you previously used the &#8220;WP User Avatar&#8221; plugin (now renamed to ProfilePress), Basic User Avatars makes the transition easy. It includes a migration tool that converts your existing local avatars.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong> After migrating, you must replace the old <code>[avatar_upload]<\/code> shortcode with the new <code>[basic-user-avatars]<\/code> shortcode for the form to continue working.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Performance_and_Best_Practices\"><\/span>Performance and Best Practices<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">To ensure your <strong>mybox<\/strong> hosting remains fast while handling many user images:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Standardize Sizes:<\/strong> Encourage users to upload square (1:1 aspect ratio) images. WordPress will automatically scale them, but starting with a square image prevents awkward cropping.<\/li>\n\n\n\n<li><strong>Image Optimization:<\/strong> Since these photos are stored in your Media Library, they will be processed by any image optimization plugins you have active. This is highly recommended to save disk space.<\/li>\n\n\n\n<li><strong>Backup Consideration:<\/strong> Remember that avatars are now part of your standard WordPress backups. Ensure your backup routine includes the <code>wp-content\/uploads<\/code> folder.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Troubleshooting_Common_Issues\"><\/span>Troubleshooting Common Issues<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>The upload button is missing for some users:<\/strong> Check your settings in <strong>Settings &gt; Discussion<\/strong>. If the &#8220;Only allow users with file upload capabilities&#8221; option is enabled, Subscribers will not be able to upload photos. Disable this if you want all users to have access.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Avatars are not appearing in comments:<\/strong> Ensure that &#8220;Show Avatars&#8221; is enabled in your WordPress Discussion settings. If it is enabled and they still don&#8217;t show, check if a caching plugin is serving an old version of the page.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Summary\"><\/span>Summary<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Basic User Avatars is the ideal solution for <strong>mybox<\/strong> administrators who want a simple, no-frills way to handle local profile pictures. It strikes a perfect balance between functionality and minimalism, making it a &#8220;set it and forget it&#8221; tool for forums and community-driven websites.<\/p>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[25,58,60],"manual_kb_tag":[],"class_list":["post-7509","manual_kb","type-manual_kb","status-publish","format-standard","hentry","manualknowledgebasecat-hosting","manualknowledgebasecat-web-applications-cms","manualknowledgebasecat-wordpress-plugins"],"_links":{"self":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/7509","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/7509\/revisions"}],"predecessor-version":[{"id":7510,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/7509\/revisions\/7510"}],"wp:attachment":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/media?parent=7509"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manualknowledgebasecat?post=7509"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb_tag?post=7509"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}