---
title: "References"
manual: "Grid Elements"
version: "main"
permalink: "https://docs.typo3.org/permalink/gridelementsteam/gridelements:editorguidereferences@main"
source: "Chapters/EditorGuide/References/Index.rst"
rendered: "2026-11-04T14:20:48+00:00"
---

# References {#editorguidereferences}

A reference lets an existing content record appear in another
structure without being duplicated as an independent record. The
content shown is the same content, wherever it appears; there is only
ever one record to edit.

## Creating a reference {#creating-a-reference}

Referencing starts the same way copying does: an element is put on the
clipboard from its context menu, on this page or on another one. From
there, an editor has two ways to bring it in as a reference rather
than a copy:

-   From an existing element's own context menu, once something is on
    the clipboard in copy mode, *Paste reference after* appears right
    next to the ordinary *Paste after* action.
-   From an empty cell or column's *create new content element* control,
    a *Paste* dialog appears when something is on the clipboard,
    offering *Paste* and *Paste reference* side by side.

Either way, the target cell or column, including a Grid Element's own
cell, is honored, so a reference lands exactly where an ordinary paste
would.

## What is actually referenced {#what-is-actually-referenced}

A reference is its own, small content record. It does not hold a copy
of the referenced content; it holds a pointer to it. What an editor
sees in the Page Module (Web > Page on TYPO3 13, Content > Layout on
TYPO3 14) is the referenced content's own preview,
rendered in place and marked with a border so it reads clearly as a
reference rather than as the content element itself. Editing the
referenced content is done by opening the original record, wherever it
lives; the reference itself has nothing of its own to edit beyond
where it points.

Because a reference is a pointer, not a duplicate, editing the
original updates every place that references it. This is the
meaningful difference from a normal copy: a copy is independent from
the moment it is created, while a reference stays connected to a
single source of truth.

Creating a reference requires the same backend-user permission TYPO3
uses for the *shortcut* content element type, since a reference is
implemented as one. See the permissions section of [Restrictions, Validation & Permissions](https://docs.typo3.org/permalink/gridelementsteam/gridelements:restrictions@main)
for how that is enforced; an editor without that permission simply
does not see the *Paste reference* choice.

## Nesting and restrictions {#nesting-and-restrictions}

A reference can be placed inside a Grid Element's cell exactly like
any other content element, including a cell of a nested Grid Element.
Because a reference is technically a *shortcut* content element, the
column or cell restrictions that would allow or disallow a shortcut
element apply to whether a reference can be pasted there at all, the
same way any other restriction narrows down what a cell accepts, see
[Restrictions, Validation & Permissions](https://docs.typo3.org/permalink/gridelementsteam/gridelements:restrictions@main).
