diff --git a/docs/subtheme/settings.md b/docs/subtheme/settings.md
index 10ce490..69728aa 100644
--- a/docs/subtheme/settings.md
+++ b/docs/subtheme/settings.md
@@ -3,5 +3,156 @@
# Theme Settings
-{.alert.alert-warning} @todo Needs documentation.
+To override a setting, open `./subtheme/subtheme.info.yml` and add the following:
+```yaml
+# Settings
+settings:
+ BOOTSTRAP_SETTING: 'VALUE'
+```
+
+Where `BOOTSTRAP_SETTING` is the name of the setting and `VALUE` is the value.
+
+---
+
+Below is a complete list of default setting values in the [Drupal Bootstrap] 8.x-3.x
+base theme:
+
+## Buttons
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| button_colorize | `1` | Adds classes to buttons based on their text value |
+| button_iconize | `1` | Adds icons to buttons based on the text value |
+| button_size | `''` | |
+{.table.table-striped.table-responsive}
+
+## Containers
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| fluid_container | `0` | Uses the `.container-fluid` class instead of `.container` |
+{.table.table-striped.table-responsive}
+
+## Forms
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| forms_has_error_value_toggle | `1` | If an element has a `.has-error` class attached to it, enabling this will automatically remove that class when a value is entered |
+| forms_required_has_error | `0` | If an element in a form is required, enabling this will always display the element with a `.has-error` class. This turns the element red and helps in usability for determining which form elements are required to submit the form |
+| forms_smart_descriptions | `1` | Convert descriptions into tooltips (must be enabled) automatically based on certain criteria. This helps reduce the, sometimes unnecessary, amount of noise on a page full of form elements |
+| forms_smart_descriptions_allowed_tags | `b, code, em, i, kbd, span, strong` | Prevents descriptions from becoming tooltips by checking for HTML not in the list above (i.e. links). Separate by commas. To disable this filtering criteria, leave an empty value |
+| forms_smart_descriptions_limit | `250` | Prevents descriptions from becoming tooltips by checking the character length of the description (HTML is not counted towards this limit). To disable this filtering criteria, leave an empty value |
+{.table.table-striped.table-responsive}
+
+## Images
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| image_responsive | `1` | Images in Bootstrap 3 can be made responsive-friendly via the addition of the `.img-responsive` class. This applies `max-width: 100%;` and `height: auto;` to the image so that it scales nicely to the parent element |
+| image_shape | `''` | Add classes to an `![]()
` element to easily style images in any project. |
+{.table.table-striped.table-responsive}
+
+## Tables
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| table_bordered | `0` | Add borders on all sides of the table and cells |
+| table_condensed | `0` | Make tables more compact by cutting cell padding in half |
+| table_hover | `1` | Enable a hover state on table rows |
+| table_responsive | `1` | Makes tables responsive by wrapping them in .table-responsive to make them scroll horizontally up to small devices (under 768px). When viewing on anything larger than 768px wide, you will not see any difference in these tables |
+| table_striped | `1` | Add zebra-striping to any table row within the `` |
+{.table.table-striped.table-responsive}
+
+## Tables
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| breadcrumb | `1` | Show or hide the Breadcrumbs |
+| breadcrumb_home | `0` | Show `Home` breadcrumb link |
+| breadcrumb_title | `1` | Show current page title at end |
+{.table.table-striped.table-responsive}
+
+## Navbar
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| navbar_inverse | `0` | Inverse navbar style |
+| navbar_position | `''` | Allows to select between `Normal`,`Static Top`, `Fixed Top` or `Fixed Bottom` |
+{.table.table-striped.table-responsive}
+
+## Region
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| region_wells.navigation | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.navigation_collapsible | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.header | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.highlighted | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.help | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.content | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.sidebar_first | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.sidebar_second | `well` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+| region_wells.footer | `''` | Enable the `.well`, `.well-sm` or `.well-lg` classes for this region |
+{.table.table-striped.table-responsive}
+
+## Modals
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| modal_animation | `1` | Apply a CSS fade transition to modals |
+| modal_backdrop | `true` | Includes a modal-backdrop element. Alternatively, specify `static` for a backdrop which doesn't close the modal on click |
+| modal_enabled | `1` | Enabling this will replace core's jQuery UI Dialog implementations with modals from the Bootstrap Framework |
+| modal_keyboard | `1` | Closes the modal when escape key is pressed |
+| modal_show | `1` | Shows the modal when initialized |
+| modal_size | `''` | Defines the modal size between the default, `modal-sm` and `modal-lg` |
+{.table.table-striped.table-responsive}
+
+## Popover
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| popover_animation | `1` | Apply a CSS fade transition to the popover |
+| popover_container | `body` | Appends the popover to a specific element. Example: `body`. This option is particularly useful in that it allows you to position the popover in the flow of the document near the triggering element - which will prevent the popover from floating away from the triggering element during a window resize |
+| popover_content | `''` | Default content value if `data-content` or `data-target` attributes are not present |
+| popover_delay | `0` | The amount of time to delay showing and hiding the popover (in milliseconds). Does not apply to manual trigger type |
+| popover_enabled | `1` | Elements that have the `data-toggle="popover"` attribute set will automatically initialize the popover upon page load. WARNING: This feature can sometimes impact performance. Disable if pages appear to hang after initial load |
+| popover_html | `0` | Insert HTML into the popover. If false, jQuery's text method will be used to insert content into the DOM. Use text if you're worried about XSS attacks |
+| popover_placement | `right` | Where to position the popover. When `auto` is specified, it will dynamically reorient the popover. For example, if placement is `auto left`, the popover will display to the left when possible, otherwise it will display right |
+| popover_selector | `''` | If a selector is provided, tooltip objects will be delegated to the specified targets. In practice, this is used to enable dynamic HTML content to have popovers added |
+| popover_title | `''` | Default title value if title attribute isn't present |
+| popover_trigger | `click` | How a popover is triggered: `click`, `hover`, `hover` or `manual` |
+| popover_trigger_autoclose | `1` | Will automatically close the current popover if a click occurs anywhere else other than the popover element |
+{.table.table-striped.table-responsive}
+
+## Tooltips
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| tooltip_animation | `1` | Apply a CSS fade transition to the tooltip |
+| tooltip_container | `body` | Appends the tooltip to a specific element. Example: `body` |
+| tooltip_delay | `0` | The amount of time to delay showing and hiding the tooltip (in milliseconds). Does not apply to manual trigger type |
+| tooltip_enabled | `1` | Elements that have the `data-toggle="e;tooltip"e;` attribute set will automatically initialize the tooltip upon page load. WARNING: This feature can sometimes impact performance. Disable if pages appear to "e;hang"e; after initial load |
+| tooltip_html | `0` | Insert HTML into the tooltip. If false, jQuery's text method will be used to insert content into the DOM. Use text if you're worried about XSS attacks |
+| tooltip_placement | `auto left` | Where to position the tooltip. When `auto` is specified, it will dynamically reorient the tooltip. For example, if placement is `auto left`, the tooltip will display to the left when possible, otherwise it will display right |
+| tooltip_selector | `''` | If a selector is provided, tooltip objects will be delegated to the specified targets |
+| tooltip_trigger | `hover` | How a tooltip is triggered: `click`, `hover`, `hover` or `manual` |
+{.table.table-striped.table-responsive}
+
+## Advanced
+
+| Setting | Default value {.col-xs-3} | Description {.col-xs-4} |
+| ---------------------------------------- | ------------------------- | ------------------------ |
+| cdn_custom_css | `https://cdn.jsdelivr.net/bootstrap/3.3.5/css/bootstrap.css` | It is best to use `https` protocols here as it will allow more flexibility if the need ever arises |
+| cdn_custom_css_min | `https://cdn.jsdelivr.net/bootstrap/3.3.5/css/bootstrap.min.css` | Additionally, you can provide the minimized version of the file. It will be used instead if site aggregation is enabled |
+| cdn_custom_js | `https://cdn.jsdelivr.net/bootstrap/3.3.5/js/bootstrap.js` | It is best to use `https` protocols here as it will allow more flexibility if the need ever arises |
+| cdn_custom_js_min | `https://cdn.jsdelivr.net/bootstrap/3.3.5/js/bootstrap.min.js` | Additionally, you can provide the minimized version of the file. It will be used instead if site aggregation is enabled |
+| cdn_jsdelivr_theme | `bootstrap` | Choose the example Bootstrap Theme provided by Bootstrap or one of the Bootswatch themes |
+| cdn_jsdelivr_version | `@BootstrapConstant("Drupal\bootstrap\Bootstrap::FRAMEWORK_VERSION")` | Choose the Bootstrap version from jsdelivr |
+| cdn_provider | `jsdelivr` | Choose between jsdelivr or a custom cdn source |
+| cdn_custom_css_min | `'https://cdn.jsdelivr.net/bootstrap/3.3.5/css/bootstrap.min.css'` | Additionally, you can provide the minimized version of the file. It will be used instead if site aggregation is enabled |
+| include_deprecated | `0` | Enabling this setting will include any `deprecated.php` file found in your theme or base themes |
+| suppress_deprecated_warnings | `0` | Enable this setting if you wish to suppress deprecated warning messages. WARNING: Suppressing these messages does not "fix" the problem and you will inevitably encounter issues when they are removed in future updates. Only use this setting in extreme and necessary circumstances |
+{.table.table-striped.table-responsive}
+
+[Drupal Bootstrap]: https://www.drupal.org/project/bootstrap
+[Bootstrap Framework]: http://getbootstrap.com