---
title: Using in an Entry
date: 2026-06-12T22:26:00+01:00
author: John Henry Donovan
canonical_url: "https://johnhenry.ie/plugins/matrix-block-anchor/docs/guide/using-in-an-entry"
section: Plugins
---
esc

↑↓ to navigate↵ to selectesc to close

Menu On this page 

- [Return to top](#)

Documentation

Documentation

# Using in an Entry

## Auto-Generated Anchors

By default, anchors are generated automatically from the block ID. With the default prefix `blockIdAnchor`, an anchor link shows up in the control panel as `#blockIdAnchor42`. The field itself stays disabled, with a short note explaining that the anchor is generated automatically.

![](https://johnhenry.ie/images/plugins/docs/matrix-block-anchor/auto-anchor.png)## Custom Anchors

When "Allow Custom Anchors" is turned on in the field settings, editors can enter their own anchor IDs. For example:

- `#about-us`
- `#pricing-section`
- `#contact-form`

![](https://johnhenry.ie/images/plugins/docs/matrix-block-anchor/custom-anchor.png)Custom anchors are validated to ensure they:

- Are not more than 100 characters
- Start with a letter
- Contain only letters, numbers, hyphens (`-`), and underscores (`_`)
- Do not contain spaces or other special characters
- Are unique within the entry

If a Matrix block is left without a custom anchor, it falls back to the auto-generated one.

![](https://johnhenry.ie/images/plugins/docs/matrix-block-anchor/fallback-anchor.png)## Using Anchor

When an editor wants to link to a particular block on a page, they use the copy anchor button in the field, then paste the link into their content.

![](https://johnhenry.ie/images/plugins/docs/matrix-block-anchor/copying-anchor.gif)

On this page
