---
title: "Example domain: example.org"
manual: "How to Document"
version: "main"
permalink: "https://docs.typo3.org/permalink/h2document:preventing-links"
source: "Reference/ReStructuredText/Links/ExampleLinks.rst"
rendered: "2026-10-01T06:42:43+00:00"
---

# Example domain: `example.org` {#preventing-links}

The renderer automatically converts simple URLs into links. This can be unintentional
in certain contexts, for example when using a
[hypothetical domain](https://docs.typo3.org/permalink/h2document:hypothetical-domains) like "example.org" or
[placeholders](https://docs.typo3.org/permalink/h2document:codeblocks-placeholders) instead of real query parameters
in a tutorial.
To prevent linking, the TYPO3 documentation uses the `:samp:` directive
to wrap the URL.

For example:

```rst
The TYPO3 backend can be accessed via :samp:`https://example.org/typo3` ..
```

is rendered like:

The TYPO3 backend can be accessed via `https://example.org/typo3` ..

To emphasize parts of the URL, use curly braces:

```rst
The *route* is the "speaking URL" as a whole without the domain part,
for example :samp:`https://example.org/<page-path>/{<page-name>}`.
```

is rendered like:

The *route* is the "speaking URL" as a whole without the domain part,
for example `https://example.org/<page-path>/{<page-name>}`.

## Hypothetical domains {#hypothetical-domains}

The TYPO3 documentation uses a defined set of dummy domains when describing URLs
where the domain name does not matter, but serves as a placeholder. The defined
set is

1.  `https://example.org`
1.  `https://example.com`
1.  `https://example.net`

– in this order: `https://example.org` as the preferred domain, and
`https://example.com` and `https://example.net` as alternatives if
multiple domains are required in the same context.

Why is `https://example.com` not preferred, as common sense would have it?
Because the preference for `.org` over `.com` fits with the fact
that the TYPO3 documentation is hosted on `https://typo3.org` and the
TYPO3 Association is owning the TYPO3 GmbH.

For explicit mention of the local development context it uses

1.  `https://example.localhost`.

If you need additional dummy domains, use subdomains of the domains listed
above such as `https://staging.example.org` and
`https://production.example.org`.

For example:

```rst
The class :php:`MailMessage` can be used to generate and send a mail without
using Fluid:

..  code-block:: rst

    $mail = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Mail\MailMessage::class);
    $mail
        ->from(new Address('john.doe@example.org', 'John Doe'))
        ->to(
            new Address('receiver@example.com', 'Max Mustermann'),
            new Address('other@example.net')
        )
```