Help Center / Elementor Editor / Widgets / Basic functionality / Custom Link Attributes

Custom Link Attributes

Last Update: February 6, 2025

With Elementor, you can add custom HTML attributes to the <a> element of every link. This enables the addition of data-* attributes, ARIA (accessibility) attributes and values, header, footer, sidebar, rel=*, and other attributes that can be found here

Add Custom Attributes to Link Elements of A Widget

If a widget has a Link element, you can add any custom attributes to the link’s HTML. For a list of custom link attributes, click here.

In this example, we’ll add the attribute of downloading a PDF file when the user clicks a button.

To add the custom attribute

  1. Select the widget by clicking it.

    The widget options appear in the panel.
  2. In the panel, in the Link field, click the gear icon.
    The Link field contains a hashtag, leave it there.
    We’ll now add code to the Custom Attributes field, using the format key|value. For example, to add rel=”sponsored” to the element’s HTML, enter rel|sponsored here. To add rel=”ugc” to the element’s HTML instead, enter rel|ugc here. To add a title to the link element, enter title|Your title text goes here. 
  3. In Custom Attributes text field, add download|60’s fashions.
    Visitors who click the button will download a pdf file called 60′ fashions.
    Now let’s create a tooltip for the button.
    Tip
    You can add multiple Link Attributes separated with a comma (,)

  4. In the Custom Attributes field, add ,title|Learn more about cool 60’s fashions.
    Visitors who hover over the button will see a tooltip saying Learn more about cool 60’s fashions.

Tip
If you add a title attribute, it will only display as a popup tooltip on hover if there is something in the Link URL field, so there must be at least a  # in the field. It cannot be blank for the hover tooltip to work.[\callout]

Note
There is no ability to add a custom attribute to a link created within a Text Editor widget. Custom attributes are only available for widgets that specifically have a link field.[\callout]

Warning
For security reason, you cannot add JS-based attributes (like onclick) to your links.[\callout]

Common Link Attributes use cases

  • Allow your visitors to download PDF files with a single button click by using the download=”yourfilename” custom attribute.
  • Implement relations SEO properties such as rel=”noopener”rel=”noreferrer”rel=”ugc”, and “rel=sponsored”. To add multiple properties to one attribute, simply list them with a space between them, e.g. rel=”noopener noreferrer”.
  • Add a title attribute to link elements, such as title=”Learn More About Us”
On this page

Share this article