diff --git a/docs/patterns/card/index.md b/docs/patterns/card/index.md
index c41cec6f66..2b15997747 100644
--- a/docs/patterns/card/index.md
+++ b/docs/patterns/card/index.md
@@ -11,39 +11,9 @@ tags:
## Overview
@@ -58,40 +28,164 @@ it's near. Several cards can be used together to group related information.
information on how to use the card element.
{% endalert %}
-## Alternative color scheme
-
-
-
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam eleifend
- elit sed est egestas, a
- sollicitudin mauris tincidunt. Pellentesque vel dapibus risus. Nullam
- aliquam felis orci, eget cursus mi
- lacinia quis. Vivamus at felis sem.
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae elit
- libero, a pharetra augue. Nullam id dolor id nibh ultricies vehicula ut id
- elit. Donec id elit non mi porta gravida at eget metus.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae elit
- libero, a pharetra augue. Nullam id dolor id nibh ultricies vehicula ut id
- elit. Donec id elit non mi porta gravida at eget metus.
+
+ ### Alternative color scheme
+
+
+
+
+
+ Card's color scheme can be modified using the `--rh-color-surface-*`
+ Tokens. However, before modifying design tokens, first determine if one of
+ card's [existing color palettes](/elements/card/code/#attributes) should be used instead.
+
+ {#
+ Read more about color palettes and themes in the
+ [getting started](/get-started/color/) section.
+ #}
+
+
+ Call to action
+
+
+
+
+
+ ### Image title bar
+
+
+
+
+
+
Use to add an image to the basic style above the text.
+ Secondary and Default calls to action may be used.
+
+ ### List
+ Use to display a short amount of content using various list styles.
+ Secondary and Default calls to action may be used.
+
+
+
+ ### Data
+ Use to display quick facts or short data points under a label. A Secondary
+ call to action may be used or not.
+
+
+
+ ### Logo
+ Use to display a customer logo in a variety of arrangements. A call to
+ action is required, otherwise use a logo wall.
+
+
+
+ ### Bar
+
+
+
+
+ {# #}
+
+
Card title
+
+ Use to add a small icon and a label group to the header section. A larger
+ icon or a logo may be used.
+
+ Alternative title bar styles can be achieved by selecting [card's `header` CSS
+ Shadow Part](/elements/card/code/#parts).
+
+
+ Footer
+
+
+
+
+
+ ### Icon
+ Use to add an icon to the basic style above the text. Secondary and Default
+ calls to action may be used.
+
+
+
+ ### Asset
+ Use to display that an asset can be downloaded. An icon and label group or
+ text may be used to describe the asset.
+
+
+
+ ### Quote
+ Use to display a short quote with attribution text. Logos, images, and a
+ Secondary call to action may be used or not.
+
+
+
+ ### Avatars
+ Use to highlight a group of people who engage in an event. A label should be
+ included, but including text is optional.
+
+
+
+ ### Video
+ Use to trigger a video that will play in a [Modal dialog](/elements/dialog).
+ Different layout configurations may be used.
+
+
+
+ ### Pricing
+ Use to outline the pricing and benefits of something. Elements may be
+ removed or rearranged depending on content needs.
+
+
+
+ ### Logo slider
+ Use to display more content about a company when expanded on hover or tap. A
+ title and text should be included.
+
+
+
+ ### Name slider
+ Use to display more content about a person when the tray expands. A title
+ and text should be included.
+
+
+
## Custom Theming
@@ -105,7 +199,19 @@ Examples include:
For more information, please see the [card css custom properties](/elements/card/code/#css-custom-properties).
-### Custom Light Theme
+
+
+
+
+ ### Custom Light Theme
+
+
Card title
@@ -115,7 +221,17 @@ For more information, please see the [card css custom properties](/elements/card
Footer
-### Custom Dark Theme
+
+
+ ### Custom Dark Theme
+
+
Card title
@@ -125,6 +241,9 @@ For more information, please see the [card css custom properties](/elements/card
Footer
+
+
+
{% include 'feedback.html' %}
diff --git a/elements/rh-card/docs/20-guidelines.md b/elements/rh-card/docs/20-guidelines.md
index a49be97c4f..3d14e24a23 100644
--- a/elements/rh-card/docs/20-guidelines.md
+++ b/elements/rh-card/docs/20-guidelines.md
@@ -1,69 +1,13 @@
## Usage
-### Variants
-There are several card variants that can be used for a variety of use cases.
+Cards are used to display basic content or long paragraphs of text. Secondary and
+Default calls to action may be used.
{% alert %}
- For examples of how to implement these patterns, see the [card patterns page](/patterns/card).
+ For examples of patterns which use or modify Card,
+ see the [card patterns page](/patterns/card).
{% endalert %}
-- #### Basic
- Use to display basic content or long paragraphs of text. Secondary and
- Default calls to action may be used.
-
-- #### List
- Use to display a short amount of content using various list styles.
- Secondary and Default calls to action may be used.
-
-- #### Data
- Use to display quick facts or short data points under a label. A Secondary
- call to action may be used or not.
-
-- #### Logo
- Use to display a customer logo in a variety of arrangements. A call to
- action is required, otherwise use a logo wall.
-
-- #### Bar
- Use to add a small icon and a label group to the header section. A larger
- icon or a logo may be used.
-
-- #### Icon
- Use to add an icon to the basic style above the text. Secondary and Default
- calls to action may be used.
-
-- #### Image
- Use to add an image to the basic style above the text. Secondary and Default
- calls to action may be used.
-
-- #### Asset
- Use to display that an asset can be downloaded. An icon and label group or
- text may be used to describe the asset.
-
-- #### Quote
- Use to display a short quote with attribution text. Logos, images, and a
- Secondary call to action may be used or not.
-
-- #### Avatars
- Use to highlight a group of people who engage in an event. A label should be
- included, but including text is optional.
-
-- #### Video
- Use to trigger a video that will play in a [Modal dialog]({{
- '/elements/dialog' }}). Different layout configurations may be used.
-
-- #### Pricing
- Use to outline the pricing and benefits of something. Elements may be
- removed or rearranged depending on content needs.
-
-- #### Logo slider
- Use to display more content about a company when expanded on hover or tap. A
- title and text should be included.
-
-- #### Name slider
- Use to display more content about a person when the tray expands. A title
- and text should be included.
- {.multi-column--min-400-wide style="padding:0;list-style-type:none;margin-block:var(--rh-space-2xl) var(--rh-space-4xl);"}
-
### Content
Cards have the potential to contain lots of content, like a combination of
text, links, images, multimedia, etc. Ensure content serves the use case, but