Using Images as a Download Button in OSDownloads

In some use cases, you may wish to use an image instead of a download button. With OSDownloads, this is a three-step process.

  1. Create a download button using the OSDownloads shortcode tag.
  2. Install ReReplacer Joomla extensions from
  3. Replace the shortcode tag using ReReplacer.

Let's take a look at it in more detail.

Step #1. Create a download button using the shortcode tag

  • Visit this tutorial to create a download button using the shortcode tag.

For this tutorial, I created a download button in my sample article "Joomla". 

The button file's ID is 1. The button's text is "Download Our Book".

Here is the screenshot of the button tag embedded in my sample article "Joomla":

the download tag embedded in a Joomla article

And here is how you would find this button on the article frontend page:

the download button at the frontend

Good job! You now have the button. This is the download button that you will replace with an image. This replacement will be done by the ReReplacer extension. 

Let's download and install it.

Step #2. Install ReReplacer Joomla extensions from

  • Visit and download the ReReplacer Free Joomla extension form this page.
  • Install ReReplacer Free on your Joomla site.

Excellent! You are now all set to move on to the last step. You can now ask ReReplacer extension to replace your download button with your preferred image.

Step #3. Replace the shortcode tag using ReReplacer

  • In your Joomla administrator panel, go to Components > Regular Labs - ReReplacer:

go to components regular labs rereplacer

  • You will be taken to the ReReplacer: List administrative page. In the top left corner, click New:

click new

  • Enter your download button text into the Search box. For my tutorial, I entered "Download Our Book", without the double quotes:

enter the button text into the search field

  • Enter the <img src="/path/to/your/image"> into the Replace box. For this tutorial, I entered <img src="/images/joomla_black.png" />:

enter the image path into the replace box

  • Locate the Details group of settings to the right and enter your ReReplacer item title into the Title field:

enter your rereplacer item title

  • Click Save or Save & Close.

You should now see your image working as the "Download" button would:

image as download button at frontend