---
title: "MappingConnection"
description: "a link that becomes a connection"
section: concepts
address: /concepts/mappingconnection
contract: 0476e35e6e275db5
---

# MappingConnection

a link that becomes a connection

[figure: MappingConnection is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `link` | `text` | yes |  |
| `kind` | [KindOfConnection](/concepts/kindofconnection) | yes |  |
| `role` | `text` | yes |  |
| `field` | `text` | no | the declared field of the object that fills the role, when the object's own fields state the connection (a table of who is active where, of who links to which host) rather than the shared header; the field's identity, its namespace and prefix, is the mapping's identifier for that field |



## Routes that use it
No route takes or returns MappingConnection directly. The record holds it, and the objects that point at it reach it.