Footer
A site footer stands its brand and a line about the site at the start, in twelve squares; columns of links beside it, eight squares each, two squares apart; and two squares below, the legal line at the start and the preferences, language and theme, at the end. Every line is one square. Column headings are in the title grey, links in the text’s ink with a faint hairline under the pointer, and a hairline runs along the top. Columns that do not fit beside the brand go below it; on a narrow screen the brand stands above the columns and the preferences come before the legal line.
A column can also hold contact lines: words alone, such as an address or a registration number, beside links. Among words alone the links are underlined in the text’s ink, as a link in running text is, and so is a heading that is a link. A column is eight squares wide unless it names its own width in whole squares. A column of icon links can stand as a stack of round marks at the end of the row, one control high, one a line, each on the lower sixteen of its square. Links to a privacy policy or terms stand on the square under the copyright, drawn as secondary buttons.
Design examples
Section titled “Design examples”Quiet grouped links under a short editorial identity.
<section class="specimen">
<ds-footer brand="Field Journal" tagline="Notes from places worth noticing" literal year="2026" columns='[{"heading":"Read","links":[{"label":"Essays","href":"#essays"},{"label":"Archive","href":"#archive"}]},{"heading":"Visit","links":[{"label":"Reading room","href":"#room"},{"label":"Contact","href":"#contact"}]}]'></ds-footer>
</section>
<style>
.specimen { width: 100%; min-width: 0; --cell: calc(20px * var(--sf, 1)); }
.specimen .line { width: 100%; }
.specimen .grow { flex: 1; min-width: 0; }
.specimen .muted { color: var(--ds-text-color-muted); }
.specimen .mono { --ds-typeface-regular: var(--ds-typeface-mono); font-variant-numeric: tabular-nums; }
.specimen .value { width: calc(4 * var(--cell)); text-align: right; }
.specimen .mark { display: inline-flex; align-items: flex-end; width: var(--cell); height: var(--ds-control-height); flex: 0 0 var(--cell); }
.specimen .columns { display: flex; flex-wrap: wrap; gap: var(--cell); }
.specimen .columns > * { min-width: 0; }
.specimen fieldset { border: 0; padding: 0; margin: 0; }
.specimen legend { padding: 0; }
.specimen label { display: flex; align-items: flex-end; gap: calc(var(--cell) / 2); min-height: var(--cell); }
.specimen ds-panel { height: calc(10 * var(--cell)); }
</style> Try it
Section titled “Try it”The cycles change this preview's language and theme. Columns that do not fit go under the brand.
<ds-footer brand="Studio" tagline="Tools for working on the grid" literal preferences year="2026" style="flex-basis:100%"
columns='[{"heading":"Product","links":[{"label":"Download","href":"#download"},{"label":"Help","href":"#help"}]},{"heading":"Company","links":[{"label":"About","href":"#about"},{"label":"Terms","href":"#terms"}]}]'>
</ds-footer> Contact lines and marks
Section titled “Contact lines and marks”Words alone beside links, which are underlined among them; a heading that is a link; a column twelve squares wide; round marks stacked at the end; the policy under the copyright.
<ds-footer literal year="2026" owner="Studio" style="flex-basis:100%"
columns='[{"heading":"Studio Ltd","href":"#about","links":[{"label":"Reg. 12345678"},{"label":"hello@example.com","href":"mailto:hello@example.com"}]},{"heading":"Office","href":"#map","links":[{"label":"1 Harbour Street"},{"label":"1000 City"}]},{"heading":"The boat - trips on the water","width":12,"links":[{"label":"North quay"},{"label":"1000 City"}]},{"heading":"Follow","icons":"stack","links":[{"label":"Instagram","href":"https://instagram.com","icon":"/icons/library/instagram.svg"},{"label":"Facebook","href":"https://facebook.com","icon":"/icons/library/facebook.svg"},{"label":"LinkedIn","href":"https://linkedin.com","icon":"/icons/library/linkedin.svg"}]}]'
policies='[{"label":"Privacy policy","href":"#privacy"}]'>
</ds-footer> Use it
Section titled “Use it”<ds-footer brand="Name" tagline="What it does" preferences literal columns='[{"heading":"Product","links":[{"label":"Download","href":"/download"},{"label":"Help","href":"/help"}]}, {"heading":"Elsewhere","links":[{"label":"Instagram","href":"https://instagram.com/name","external":true}]}]'></ds-footer>columns is a list of { heading, href, links, width, icons }, each link { label, href, external, current, icon }:
- A link without
hrefis a line of words alone. A column with words alone underlines its links. hrefon a column makes its heading a link.widthis the column’s width in whole squares, eight by default.icondraws the link as a mark, its label its accessible name. A column’s marks stand first in a row of their own, or, withicons: "stack", as round marks one a line at the end of the row, one square wide; the column’s heading then names the marks for assistive technology instead of standing above them.externalopens in a new tab with no referrer,currentmarks the page being read.
policies is a list of links, { label, href }, drawn as secondary buttons on the square under the copyright. Words are translation keys unless literal. The copyright reads © <year> <owner>, this year and the brand by default. preferences puts a ds-cycle for each setting it names at the end of the last row: language, theme, or both when it is present and empty.
| Attribute | Type | Default | What it does |
|---|---|---|---|
brand | string | Empty | The site’s name, a link home. |
href | string | / | Where the brand links. |
tagline | string | Empty | A line about the site under the brand, muted. |
columns | FooterColumn[] | [] | The columns of links. |
label | string | Empty | Names the columns as a navigation; without it they are plain lists. |
owner | string | The brand | Who holds the copyright. |
year | number | This year | The copyright’s year. |
policies | FooterLink[] | [] | Links under the copyright, as secondary buttons. |
preferences | string | None | language, theme, or both. |
literal | boolean | false | Show the words as written. |
| Slot | What it holds |
|---|---|
brand | A brand of the page’s own: a logo, one square high. |
preferences | Controls of the page’s own beside the cycles, such as a currency. |
legal | The last line, in place of the copyright. |
Without the element
Section titled “Without the element”A page that writes its own markup uses the same classes. A line of words alone is a <span> in its <li>; a column’s width is --ds-footer-column-width; a stack of marks is ds-footer__column--stack.
<footer class="ds-footer"> <div class="ds-footer__columns"> <div class="ds-footer__column"> <h2 class="ds-footer__heading"><a href="/about">Studio Ltd</a></h2> <ul class="ds-footer__links"> <li><span>Reg. 12345678</span></li> <li><a href="mailto:hello@example.com">hello@example.com</a></li> </ul> </div> <div class="ds-footer__column" style="--ds-footer-column-width: 12">…</div> <div class="ds-footer__column ds-footer__column--stack"> <ul class="ds-footer__icons" aria-label="Follow"> <li><a href="https://instagram.com/name" aria-label="Instagram"><span class="ds-icon" aria-hidden="true" style="--ds-icon: url(icons/instagram.svg)"></span></a></li> </ul> </div> </div> <div class="ds-footer__base"> <p class="ds-footer__legal">© 2026 Studio</p> <ul class="ds-footer__policies"><li><a class="ds-button ds-button--secondary" href="/privacy">Privacy policy</a></li></ul> </div></footer>In React
Section titled “In React”import { Footer } from "./design/react/footer";
<Footer brand="Name" literal preferences="" columns={[{ heading: "Product", links: [{ label: "Help", href: "/help" }] }]} />columns and policies are set as properties. The adapter does not register the element: import 4-page/ds-footer once in the browser entry.