---
title: "Block xref"
source: https://dev.pageseeder.com/reference/glossary/block_xref.html
description: "Block xref is a PageSeeder cross-reference type for standalone elements with multiple processing options: None for standard links, Alternate for high-resolution variants, Embed for publishing resolution, Transclude for inline display, and Math for equations."
last_updated: 2026-09-05T17:36:31+10:00
tokens: ~243
---

# Block xref

A type of [cross-reference](cross_reference.md) that references content that is to appear as a standalone element. The different ways a block xref can be processed are the following:

- **None** – used when creating a standard link from text to a target document or fragment.
- **Alternate** – typically used with images (but can be used for other content such as citations) where an alternate representation might be needed to output a high-resolution print document, rather than a low-resolution, editing view. 
- **Embed** – for creating a reference that is resolved by publishing, for example, by [references documents](references_document.md).
- **Transclude** – a link type that displays the target in the source document as a [transclusion](transclusion.md).
- **Math** – to display [mathematical equations](mathml.md) inline.

In PageSeeder [PSML](psml.md), block xrefs are expressed using the `<blockxref>` element:

```xml
<blockxref ... />
```