---
title: "makelinks"
manual: "TypoScript Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3tsref:makelinks@main"
source: "Functions/Makelinks.rst"
rendered: "2026-09-19T06:55:14+00:00"
---

# makelinks {#makelinks}

`makelinks` substitutes all appearances of web addresses or mail links
with a real link tag. Web addresses and mail links must be contained in
the text in the following form:

```none
https://example.org

mailto:name@example.org
```

-   [Properties](https://docs.typo3.org/permalink/t3tsref:properties@main)

## Properties {#makelinks-properties}

### http {#makelinks-http}

Substitutes all external web addresses with a link tag so they are displayed
as a link.

Can handle links of the form:

```none
https://example.org
http://example.org
```

#### http.extTarget {#makelinks-http-exttarget}

-   **http.extTarget**

    -   *Type:* string
    -   *Default:* \_top

    The target of the link.

#### http.wrap {#makelinks-http-wrap}

-   **http.wrap**

    -   *Type:* [Wrap](https://docs.typo3.org/permalink/t3tsref:data-type-wrap@main) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)

    Wrap around the link.

#### http.ATagBeforeWrap {#makelinks-http-atagbeforewrap}

-   **http.ATagBeforeWrap**

    -   *Type:* [boolean](https://docs.typo3.org/permalink/t3tsref:data-type-boolean@main)
    -   *Default:* 0

    If set, the link is first wrapped with `http.wrap` and then the
    `<a>` tag.

#### http.keep {#makelinks-http-keep}

-   **http.keep**

    -   *Type:* list: "scheme","path","query"

    As default the link-text will be the full domain-name of the link.

    **Examples**

    With the URL `https://example.org/test/doc.php?id=3` in our text we will
    get the following results:

    **EXT:site_package/Configuration/Sets/Main/setup.typoscript**

    ```typoscript
    http.keep = "":                   # example.org
    http.keep = "scheme":             # https://example.org
    http.keep = "scheme,path":        # https://example.org/test/doc.php
    http.keep = "scheme,path,query":  # https://example.org/test/doc.php?id=3

    ```

#### http.ATagParams {#makelinks-http-atagparams}

-   **http.ATagParams**

    -   *Type:* string / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)

    Additional parameters

    **Examples**

    **EXT:site_package/Configuration/Sets/Main/setup.typoscript**

    ```typoscript
    http.ATagParams = class="board"
    ```

### mailto {#makelinks-mailto}

Substitutes all appearances of mail addresses
with a link tag. Mail addresses must be contained in
the text in the following form:

```none
mailto:name@example.org
```

#### mailto.wrap {#makelinks-mailto-wrap}

-   **mailto.wrap**

    -   *Type:* [Wrap](https://docs.typo3.org/permalink/t3tsref:data-type-wrap@main) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)

    Wrap around the link.

#### mailto.ATagBeforeWrap {#makelinks-mailto-atagbeforewrap}

-   **mailto.ATagBeforeWrap**

    -   *Type:* [boolean](https://docs.typo3.org/permalink/t3tsref:data-type-boolean@main)
    -   *Default:* 0

    If set, the link is first wrapped with mailto `wrap` and then the
    `<a>` tag.

#### mailto.ATagParams {#makelinks-mailto-atagparams}

-   **mailto.ATagParams**

    -   *Type:* string / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)

    Additional parameters

    **Examples**

    **EXT:site_package/Configuration/Sets/Main/setup.typoscript**

    ```typoscript
    mailto.ATagParams = class="board"
    ```