diff --git a/assets/components/atoms/link/link-button.twig b/assets/components/atoms/link/link-button.twig
new file mode 100644
index 00000000..581e5fb0
--- /dev/null
+++ b/assets/components/atoms/link/link-button.twig
@@ -0,0 +1,2 @@
+Primary button link
+Secondary button link
diff --git a/assets/components/atoms/link/link.scss b/assets/components/atoms/link/link.scss
index 3fad2bee..e3e73ab6 100644
--- a/assets/components/atoms/link/link.scss
+++ b/assets/components/atoms/link/link.scss
@@ -1,11 +1,7 @@
@charset 'utf-8';
// All links are underlined by default. Supported browsers will have the right color. https://caniuse.com/#feat=text-decoration
-a,
-a:visited {
- color: $black;
- text-decoration: underline;
- background-color: transparent;
+a {
text-decoration-color: $link-hover-color;
transition:
text-decoration-color 0.2s ease-in-out,
diff --git a/assets/components/atoms/link/link.yml b/assets/components/atoms/link/link.yml
index 55f486ca..b6920ecc 100644
--- a/assets/components/atoms/link/link.yml
+++ b/assets/components/atoms/link/link.yml
@@ -25,3 +25,9 @@ variants:
- name: login
title: Login link
notes:
+ - name: button
+ title: Button link
+ notes: |
+ Use the classes `btn`, `btn-primary` or `btn-secondary` to create a link with the look of a button.
+
+ ⚠️ Button links should be used to target a page or section of a page – like a regular link. To trigger an action, use an [HTML button](#/atoms/button).