Plugin Directory

Test out the new Plugin Directory and let us know what you think.

Post Avatar

Choose an avatar from a pre-defined list to include in a post.

Manual Installation

  1. After downloading the zip file from WordPress.org, extract the contents onto your computer. This will create a folder, post-avatar, containing the plugin files.
  2. Connect to your webserver and upload the post-avatar folder to where your plugins are installed, typically, /wp-content/plugins.
  3. To activate the plugin go to the Plugins menu in your WordPress admin. Click "Activate" for the "Post Avatar" plugin

Automatic Installation

  1. From the Plugins menu, click Add New and search for Post Avatar
  2. Click "Install Now" so that WordPress will download and install the plugin
  3. Once the installation is complete, you will be asked to click Activate Plugin

See Also: "Installing Plugins" article on the WP Codex


The Plugins section of your WordPress admin provides notification if there are new updates for the plugin.

For a manual upgrade, delete the folder post-avatar from the plugins folder and follow the new installation instructions.

For automatic upgrade, click on ** Upgrade Now**.


You can change default options by going to the Post Avatar link in the Settings menu at your WordPress admin.

  • Path to Images Folder - location of your images folder in relation to your WordPress installation. Defaults to wp-content/uploads.

  • Show avatar in post? Disable to use template tag. - Tick this so that the chosen post avatar will be automatically displayed in your post, just prior to your post content. Enabled by default.

  • Scan the images directory and its sub-directories - Tick this to include images stored in sub-directories of the images folder during the avatar selection. Enabled by default.

  • Get image dimensions? Disable this feature if you encounter getimagesize errors - Turned on by default, a tick mark here will determine the image's width and height. If you encounter any getimagesize errors, turn this feature off.

  • Show post avatars in RSS feeds? - Turned off by default, place a tick mark here to include avatars in your RSS feeds.

  • Customize HTML/CSS - These options help you further customize how post avatars will look.

    A. Use this HTML before/after the post avatar image - Enter the HTML code that will wrap around the image. Can be left blank. The plugin defaults to <div class="postavatar"></div>.

    Example: Before: <div class="myimage"> / After: </div> Output: <div class="myimage"><img src="http://mydomain.com/images/chosen-image.jpg" height="120" width="180" alt="post-title" /></div>

    B. CSS Class - Define the CSS class associated with the post avatar image. Can be left blank. It is empty by default.

    Example: The class name is: postimage Output: <img class="postimage" src="http://mydomain.com/images/chosen-image.jpg" height="120" width="180" alt="post-title" />

Using both HTML and CSS class will result in the following output: <div class="myimage"><img class="postimage" src="http://mydomain.com/images/chosen-image.jpg" height="120" width="180" alt="post-title" /></div>

The "Advanced Customization" section of this readme has more advanced customization tips.



The plugin does not handle image uploads. You will need to use your FTP or a file manager to upload photos. There are also a number of plugins that handle file uploads

Upload images, using your preferred upload method, to the folder defined in the Post Avatar settings page.


  1. Go to the Post Editor screen. Below the content text area you will find the Post Avater section.

  2. Select the image name from the dropdown list. You can also use the next and previous arrow buttons on either side of the dropdown to scroll through images.

  3. Once you've made your selection, click Publish for a new post or Update for a previously saved one.

Requires: 3.9 or higher
Compatible up to: 4.1.14
Last Updated: 2 years ago
Active Installs: 1,000+


5 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1