How to Use Custom Fields to Collect User Information in OSDownloads

By default, the OSDownloads download form will only collect an email address.

In this tutorial, we'll show you how to add more fields to the OSDownloads Pro download form. You'll see how to add First Name and Second Name fields, as in the image below.

form to arrive to

Step #1. Create your file

  • In your Joomla control panel, go to Components > OSDownloads Pro > Files.
  • Create the file you wish to offer in exchange for user data. If you are a beginner to OSDownloads Pro and don't know how to create a file for downloads, please see our Getting Started with OSDownloads guide.
  • IMPORTANT: Make sure you set the Require Email setting in the Requirements to Download tab to Yes. Otherwise, your download fields won't get displayed.

require email

Step #2. Create fields

  • In the OSDownloads Pro control panel, click Download Fields.

download fields

  • Click New.

click new

  1. Enter "First Name" as your custom field title into the Title field.
  2. Select data type from the Type field.
  3. Click Save & New.

new field

Pro tip: please keep in mind that by default a new field will be assigned to ALL your file categories. Leave it as is, if it is OK with you. Otherwise, use the Category field to assign your new custom field to specific categories only:

01 default category filtering set to all

  • Repeat these steps to create the Second Name field.
  • You should now see both of the newly created custom fields listed in your Download Fields page.

two custom fields listed

Step #3. Configure the Permissions

  • In the OSDownloads Pro control panel, click Options.


  • Click the Permissions tab.

click permissions

  1. Make sure your permissions get displayed under the Public tab.
  2. Scroll down the page and set the Edit Custom Field Value to Allowed.
  3. Click Save & Close.

set edit custom field value to allowed

  • Now visit the file download page on your site's frontend.
  • Click the Download button.
  • You should see both custom fields now nicely displayed and ready to collect data from your visitors.