--- title: "Download Button Field - Advanced Custom Fields" description: "Create download links that prompt user to save files locally via a click of a button. Boost engagement and user experience now!" url: "https://www.tassos.gr/docs/advanced-custom-fields/fields/download-button" date: "2026-05-01T00:12:49+00:00" language: "en-GB" --- [ Home ](https://www.tassos.gr/index.php?option=com_content&view=category&layout=blog&id=24&Itemid=1088) / [ Advanced Custom Fields ](https://www.tassos.gr/index.php?option=com_content&view=category&id=44) / [ Fields Types ](https://www.tassos.gr/index.php?option=com_content&view=category&id=64) # Download Button Field ## Create download links that prompt user to save files locally via a click of a button. Boost engagement and user experience now! The Download Button custom field allows you to download files via the click of a button. This instructs (forces) the browser to download the URL you specify instead of navigating to it, so the user will be prompted to save the file locally.[](#how_to_add_a_download_button_custom_field_to_joomla_articles) ## [How to add a Download Button Custom Field to Joomla! Articles](#how_to_add_a_download_button_custom_field_to_joomla_articles) The Download Button field provides you the way to select a file from a dircetory and create a button which will be displayed at your frontend. ![acf-download-button-field-settings](https://www.tassos.gr/images/acf-download-button-field-settings.png) Let's see what each option does. | Name | Description | |---|---| | Name | The name will be used to identify the field. Leave this blank and Joomla will fill in a default value from the title. | | Label | The label of the field to display. | | Description | A description of the field that will be displayed in the label tooltip. | | Required | Is this a mandatory field? | | Directory | Set the directory to search for files. | | Include Files | Set the files to be included in the directory list. | | Excluded Files | Set the files to be excluded from the directory list. | | Button Label | Set the button name. Use the Smart Tag **{this.filename}** to display the selected file name. | | Button Class | Set the button classes. | ## [Usage](#usage) Once you are in your Article's Edit screen, choose the "Fields" Tab to see the Download Button custom field as you can see in the screenshot below. ![acf-download-button-usage](https://www.tassos.gr/images/acf-download-button-usage.png) In this drop-down you can select which file to download via the download button on the frontend. ## [Frontend Display](#frontend) Take a look at the screenshot below to see how it could be displayed in your frontend. ![acf-download-button-frontend](https://www.tassos.gr/images/acf-download-button-frontend.png) ## [Frequently Asked Questions](#faq) ### [How do I set a directory and view it's files?](#set_directory) You can set a specific folder in which the Download Button will search and return a list of files for you to select. To set the directory, enter the path on the setting *Directory*. ### [Can I select specific files such as png and exclude pdf files?](#include_exclude_files) To include or exclude specific file types, you can set them on the settings *Include Files* and *Exclude Files* respectively. To add more than one file type, you will need to separate them via the character "|". For example: **.pdf|.jpg** ### [Can I customize the button?](#customize_button) You can set the Label and Class of the button via the settings *Button Label* and *Button Class*. The Button Class can take any class you desire to make it fit your needs. ### [Can I use ACF - Download Button with YooTheme Pro Dynamic Content?](#yootheme_support) The "ACF - Download Button" custom field is now compatible with YooTheme Pro Dynamic Content and you can use it to populate YooTheme elements such as the Text, Image, HTML, Button elements. ### [How can I override the layout of "ACF - Download Button" custom field?](#how-can-i-override-the-layout-of-acf-download-button-custom-field) To override the "ACF - Download Button" custom field, read here: [How to override the "ACF - Download Button" custom field](https://www.tassos.gr/joomla-extensions/advanced-custom-fields/docs/how-to-create-an-alternative-layout-for-joomla-custom-fields#override_render_layout). Last updated on Jan 22nd 2026 10:01 ## Schema ```json { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.tassos.gr" }, { "@type": "ListItem", "position": 2, "name": "Home", "item": "https://www.tassos.gr/docs" }, { "@type": "ListItem", "position": 3, "name": "Advanced Custom Fields", "item": "https://www.tassos.gr/docs/advanced-custom-fields" }, { "@type": "ListItem", "position": 4, "name": "Fields Types", "item": "https://www.tassos.gr/docs/advanced-custom-fields/fields" }, { "@type": "ListItem", "position": 5, "name": "Download Button Field", "item": "https://www.tassos.gr/docs/advanced-custom-fields/fields/download-button" } ] } ``` ```json { "@context": "https://schema.org", "@type": "Article", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://www.tassos.gr/docs/advanced-custom-fields/fields/download-button" }, "headline": "Download Button Field", "image": { "@type": "ImageObject", "url": "https://www.tassos.gr/" }, "publisher": { "@type": "Organization", "name": "Tassos", "logo": { "@type": "ImageObject", "url": "https://www.tassos.gr/https://www.tassos.gr/media/brand/logo-text.png" } }, "author": { "@type": "Person", "name": "Sotiris Katsaniotis", "url": "https://www.tassos.gr/docs/advanced-custom-fields/fields/download-button" }, "datePublished": "2017-05-06T00:41:36+03:00", "dateCreated": "2018-07-07T14:24:16+03:00", "dateModified": "2026-01-22T10:55:13+02:00" } ``` ```json { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "How do I set a directory and view it's files?", "acceptedAnswer": { "@type": "Answer", "text": "You can set a specific folder in which the Download Button will search and return a list of files for you to select. To set the directory, enter the path on the setting Directory." } }, { "@type": "Question", "name": "Can I select specific files such as png and exclude pdf files?", "acceptedAnswer": { "@type": "Answer", "text": "To include or exclude specific file types, you can set them on the settings Include Files and Exclude Files respectively. To add more than one file type, you will need to separate them via the character "|". For example: .pdf|.jpg" } }, { "@type": "Question", "name": "Can I customize the button?", "acceptedAnswer": { "@type": "Answer", "text": "You can set the Label and Class of the button via the settings Button Label and Button Class. The Button Class can take any class you desire to make it fit your needs." } }, { "@type": "Question", "name": "Can I use ACF - Download Button with YooTheme Pro Dynamic Content?", "acceptedAnswer": { "@type": "Answer", "text": "The "ACF - Download Button" custom field is now compatible with YooTheme Pro Dynamic Content and you can use it to populate YooTheme elements such as the Text, Image, HTML, Button elements." } }, { "@type": "Question", "name": "How can I override the layout of "ACF - Download Button" custom field?", "acceptedAnswer": { "@type": "Answer", "text": "To override the "ACF - Download Button" custom field, read here: How to override the "ACF - Download Button" custom field." } } ] } ```