# Footnote

### Introduction

Users must be able to perceive the association between a symbol and and its associated text.

The symbol is usually one of the following:

* Asterisk: \*
* Double Asterisk: \*\*
* Dagger: †
* Double Dagger: † †
* Numbers: 1, 2, 3, etc

### Example

Here is a footnote symbol contained under a "Seller Fees" section of the page:

```markup
<h2>Seller Fees</h2>
<p>This text has a footnote<sup>*<span class="clipped"> - See Seller Fees Notes</span></sup></p>
```

Here is the associated notes section of the page:

```markup
<section role="region" aria-label="Notes - Seller Fees">
  <h2 class="clipped">Notes - Seller Fees</h2>
  <ol>
    <li>This is an actual note</li>
    ..
  </ol>
</section>
```

Sometimes there are multiple footnote sections on the same page, therefore both the source symbol and target section much be uniquely identified (as in the example above).

### FAQ

#### Why is the symbol not hyperlinked to the footnotes section?

While it is certainly possible to create a page anchor relationship between the symbol and the footnote section, doing so opens its own can of worms. For the time being we believe the strong visual affordance and semantics laid out above will allow all users to identify, navigate and discover the system of footnotes using their keyboard (to scroll the page) or screen reader (to jump to landmark or heading).

#### Why not use aria-describedby on the symbol to read out the description/footnote?

For sighted users, the symbol gives a visual clue that there is a footnote elsewhere on the page. The user is not *forced* to read the footnote. This reduces cognitive load for the user. Whilst we *could* use aria-describedby on the symbol, so that a screen reader would automatically announce the footnote content, we have determined that this would be overly verbose in *most* cases, and would increase cognitive load for the user.

#### Should I use role="note" or role="region"?

We are currently looking into the current support status of the [ARIA note role](https://a11ysupport.io/tech/aria/note_role). For the time being, please use region.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ebay.gitbook.io/mindpatterns/disclosure/footnote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.