diff --git a/docs/4.0/content/tables.md b/docs/4.0/content/tables.md
index 59bdb6373c..d4506c2c9f 100644
--- a/docs/4.0/content/tables.md
+++ b/docs/4.0/content/tables.md
@@ -579,11 +579,48 @@ Regular table background variants are not available with the dark table, however
{% capture callout-include %}{% include callout-warning-color-assistive-technologies.md %}{% endcapture %}
{{ callout-include | markdownify }}
+
+## Captions
+
+A `
` functions like a heading for a table. It helps users with screen readers to find a table and understand what it’s about and decide if they want to read it.
+
+{% example html %}
+
+ List of users
+
+
+ # |
+ First Name |
+ Last Name |
+ Username |
+
+
+
+
+ 1 |
+ Mark |
+ Otto |
+ @mdo |
+
+
+ 2 |
+ Jacob |
+ Thornton |
+ @fat |
+
+
+ 3 |
+ Larry |
+ the Bird |
+ @twitter |
+
+
+
+{% endexample %}
+
## Responsive tables
-Create responsive tables by adding `.table-responsive{-sm|-md|-lg|-xl}` to any `.table` to make them scroll horizontally at each `max-width` breakpoint 575px, 767px, 991px, and 1199px, respectively.
-
-For responsive tables that always scroll horizontally when the table is wider than its container, add the `.table-responsive` class on `.table`.
+Responsive tables allow tables to be scrolled horizontally with ease. Make any table responsive across all viewports by adding `.table-responsive` class on `.table`. Or, pick a maximum breakpoint with which to have a responsive table up to by adding `.table-responsive{-sm|-md|-lg|-xl}`.
{% callout warning %}
#### Vertical clipping/truncation
@@ -591,6 +628,8 @@ For responsive tables that always scroll horizontally when the table is wider th
Responsive tables make use of `overflow-y: hidden`, which clips off any content that goes beyond the bottom or top edges of the table. In particular, this can clip off dropdown menus and other third-party widgets.
{% endcallout %}
+### Always responsive
+
@@ -697,41 +736,57 @@ Responsive tables make use of `overflow-y: hidden`, which clips off any content
{% endhighlight %}
+### Breakpoint specific
-## Captions
+Use `.table-responsive{-sm|-md|-lg|-xl}` as needed to create responsive tables up to a particular breakpoint. From that breakpoint and up, the table will behave normally and not scroll horizontally.
-A `
` functions like a heading for a table. It helps users with screen readers to find a table and understand what it’s about and decide if they want to read it.
-
-{% example html %}
-
- List of users
+
+{% for bp in site.data.breakpoints %}{% unless bp.breakpoint == "xs" %}
+
# |
- First Name |
- Last Name |
- Username |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
1 |
- Mark |
- Otto |
- @mdo |
+ Table cell |
+ Table cell |
+ Table cell |
+ Table cell |
+ Table cell |
2 |
- Jacob |
- Thornton |
- @fat |
+ Table cell |
+ Table cell |
+ Table cell |
+ Table cell |
+ Table cell |
3 |
- Larry |
- the Bird |
- @twitter |
+ Table cell |
+ Table cell |
+ Table cell |
+ Table cell |
+ Table cell |
-{% endexample %}
+{% endunless %}{% endfor %}
+
+
+{% highlight html %}
+{% for bp in site.data.breakpoints %}{% unless bp.breakpoint == "xs" %}
+
+{% endunless %}{% endfor %}
+{% endhighlight %}