Special List

A Special List is a grid of short entries, each with an icon, a title and a description. The title can be plain, link to a web address or download a file. It is the quickest way to turn a bullet list into something visual.

What it is for

Benefits and features (“Why join”), steps of a process, contact channels, downloadable forms, key facts with icons. When the entries need thumbnails, overlays or videos, use Links instead; when they need images as the main element, use Feature Box.

See it live on the example page APB Special Lists.

Structure

• The Special List component sets the grid, the base color and an optional Body text shown above the entries.
• Special List Items — one per entry: title, description, icon, and the link type.

Component settings

Setting	Options	Default	What it does
Section Title / Show Section Title	text; No / Yes	— / No	See Section Title and Intro Text.
Body	rich text	empty	Introduction shown between the title and the grid (this component uses Body rather than Intro Text).
Target Placement	Body, Main Content Top/Bottom, Top region, Sidebars, Internal Placement 1–3	Body	See Target Placement.
Columns	1 … 10	3	Entries per row. See Columns and Column Gap.
Column Gap	0 … 60px	30px	Space between entries.
Color Style	Black, White, Teal Blue, Blue, Orange, Green, Red, Silver and Blue	Black	Color of titles and icons; each entry can override it. See Color Style.
Component Width	25% … 100%	100%	See Component Width.
Custom Class	text	empty	See Advanced settings.
Container Settings	—	32px bottom margin	See Container Settings.

Special List Item fields

Field	Required	What it does
Title	yes	Heading of the entry; becomes the link when Type is Link or File.
Title Style	no (Yes)	Whether the title is shown in the palette color and larger. No renders it as normal text.
Description	no	Rich text under the title.
Type	yes (No Action)	No Action — plain entry. Link — the title opens the Link. File — the title downloads the File.
Link	for Link	Internal or external address.
File	for File	PDF, Office documents, archives, images or text files.
Icon	no	Font Awesome classes, for example fas fa-rocket or far fa-file-pdf. Leave empty for no icon.
Icon Position	no (Left)	Left, Right, Top or Bottom of the text.
Icon Size	no (Normal)	Small, Normal, Medium, Large, Extra Large.
Color Style	no	Overrides the component color for this entry.
Internal Description / Custom Class	no	Editor note (never shown) / extra CSS class.

How to use it

1. Click Add Special List; set the Section Title and the number of Columns.
2. Click Add new Special List Item. Type the Title and Description.
3. Choose the Type; add the Link or File it needs.
4. Paste an Icon class from fontawesome.com and pick its position and size. Click Create.
5. Repeat, drag to order, save.

Tips

• Use the same icon position and size in all entries of one list; vary the color instead if you want emphasis.
• Icons on Top with Large size and 3–4 columns give the classic “features” row; icons on the Left with Small size suit longer descriptions.
• Use the same number of entries as columns, or a multiple of it.

For site builders

Item	Value
Module	apb_pb_special_list
Paragraph types	apb_pb_special_list, apb_pi_special_list
Requires	apbuilder, Paragraphs, Entity Reference Revisions, Inline Entity Form, Field Group, Font Awesome, core File / Link / Options / Taxonomy / Text
Shared vocabularies	apb_tax_columns, apb_tax_column_gap, apb_tax_cs_01, apb_tax_width, apb_tax_target_placement
Front-end	apb_pb_special_list/frontend (+ Font Awesome webfonts); item colors injected as inline CSS; links resolved in the active content language.
Permissions	Install grants view to anonymous and authenticated users only; grant create/update/delete on both bundles to your editor roles manually (see the release notes).
Container settings	Full profile.
Example page	/apbuilder_examples/apb-special-lists