# Article comments

<figure><img src="https://3723856256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGnixyIfIYFWroNtVmZo6%2Fuploads%2Fgit-blob-e82576005a36fc278d81d343d357715e3ad61b71%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Overview

A block for displaying paginated article comments with customizable pagination controls and comment form.

## Common use cases

* Set appropriate items\_per\_page based on your needs
* Configure pagination type for best user experience
* Display article comments on blog post pages
* Allow readers to engage with content through comments

## Compatible blocks

The following blocks can be nested within this block:

* [Pagination](https://help.brickspacelab.com/slab/content/blocks/navigation/pagination)

## Block settings

### General

| Setting                | Description                 | Options                   |
| ---------------------- | --------------------------- | ------------------------- |
| Show advanced settings | Reveals visibility settings | Checkbox (default: false) |

### Content

| Setting         | Description                                            | Options                  |
| --------------- | ------------------------------------------------------ | ------------------------ |
| Items per page  | Number of comments to display per page                 | 1 - 32 (default: 9)      |
| Success message | Message displayed after successfully posting a comment | Rich text input          |
| Show author     | Displays the comment author name                       | Checkbox (default: true) |
| Show dates      | Displays the comment date                              | Checkbox (default: true) |

### Spacing

| Setting                   | Description                                     | Options                   |
| ------------------------- | ----------------------------------------------- | ------------------------- |
| Enable internal padding   | Adds internal padding to the comments container | Checkbox (default: true)  |
| Enable horizontal padding | Adds horizontal padding around the block        | Checkbox (default: false) |
| Enable top padding        | Adds top padding around the block               | Checkbox (default: false) |
| Enable bottom padding     | Adds bottom padding around the block            | Checkbox (default: false) |

### Color

| Setting      | Description                                        | Options                                                                                                                                                                                    |
| ------------ | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Color scheme | Controls the background and text color combination | <p>• Body<br>• Neutral<br>• Accent 1<br>• Accent 2<br>• Accent 3<br>• Shade 1 (default)<br>• Shade 2<br>• Shade 3<br>• Primary<br>• Secondary<br>• Tertiary<br>• Blur<br>• Transparent</p> |
| Border color | Controls the border color                          | <p>• Body<br>• Subtle (default)<br>• Strong<br>• Primary<br>• Secondary<br>• Tertiary<br>• None<br><br>Visible when border position is not empty</p>                                       |

### Style

| Setting         | Description                                   | Options                                                                                                            |
| --------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Border position | Position of borders on the comments container | <p>• None (default)<br>• Top<br>• Bottom<br>• Left<br>• Right<br>• Top and bottom<br>• Left and right<br>• All</p> |

### Display

| Setting    | Description                        | Options                                                                                                                            |
| ---------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | Controls when the block is visible | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |