Content Block Macro Parameters and Key
Content Block macro key and configuration options.
Key
| Parameter | Description | Expected Input | Example Value(s) |
|---|---|---|---|
| Placement* | Defines how to apply this block when joining other pages.
| Drop-down menu selection |
|
| CSS Class | Facilitates styling the block. | CSS class name(s); space-separated if more than one |
|
| ID | Uniquely identifies the block on the page. | Positive integer |
|
| Name | Defines a name for the block. Useful when including the block's content on another page or converting the block to a tab. | Text string |
|
| Never Tabbed | Toggles the block between tabbed and non-tabbed presentation. | Check mark | |
| Defer Loading | Toggles the loading of this block's content after everything else on the page. Only use this option for slow-rendering block content. | Check mark | |
| Alternate Design | Toggles between the default or alternate block design as defined in the theme. | Check mark | |
| Hide on Mobile | Toggles the visibility of this block when viewed on a mobile device. | Check mark | |
| Height | Sets the height of the block. | Pixels |
|
| Margin | Creates space around the block. | Pixels |
|
| Padding | Creates space within the block, between the content and the block's borders. | Pixels |
|
| Background Color | Displays a color behind the block's content. | CSS color value; Theme Press color reference |
|
| Background Image from Theme | Defines an image from the current theme to display behind the block's content. | Image filename |
|
| Background Image from Page | Defines an image, attached to the current page, to display behind the block's content. | Image filename |
|
| Background Image Position | Defines the position of the background image. | CSS background-position values |
|
| Background Image Repeat | Defines the repeat value for the background image. | CSS background-repeat values |
|
| Background Image Size | Defines the dimensions of the background image. | CSS background-size values |
|
| Gradient Top | Defines the top gradient color to display behind the block's content. | CSS color value; Theme Press color reference |
|
| Gradient Bottom | Defines the bottom gradient color to display behind the block's content. | CSS color value; Theme Press color reference |
|
| Gradient Start | Defines the starting point of the gradient relative to the top of the block. | Percentage (of the block's total height) |
|
| Gradient Stop | Defines the stopping point of the gradient relative to the top of the block. | Percentage (of the block's total height) |
|
| Border Width | Defines the pixel size of the block's border. | Pixels |
|
| Border Style | Defines the style of the block's border. | CSS border-style values |
|
| Border Color | Defines the color of the block's border. | CSS color value; Theme Press color reference |
|
| Border Radius | Defines the amount of rounding on the corners of the block's border. | Pixels |
|
| Shadow Values | Defines values for creating a box shadow behind the block. | CSS box-shadow values |
|
| From Layout | Theme Press value used during page assembly; NEVER set this value. | ||
| Meta Properties | Allows the first heading to set the meta title, remaining text to set the meta description, and the first image displayed to be the meta image. (Useful for rich link displays and SEO.) | Check mark | |
| Collapsible | Defines the initial visibility of the block. Toggles between initially expanded (showing), initially collapsed (hidden), or initially collapsed when viewed on mobile phones. | Drop-down menu selection |
|
*Only applicable when configuring blocks in page layout architect pages.
