Aero Page Builder Documentation

Container Settings

Container Settings

Every component sits inside an invisible box called its container. Container Settings let you shape that box: the space inside and around it, a border, and a background color, image or video — the same way on every component.

The box around a component

Nested rectangles: an outer dashed orange rectangle labelled Margins (space outside the border, always transparent), a thick blue rectangle labelled Border, a light blue area labelled Padding (space inside the border, shows the background), and a white inner box labelled Component content: title, intro, items. Callouts mark margin top, bottom (default 32px), left and right.
From the outside in: margins, border, padding, content. The background fills the border and padding area; margins are always transparent.

The four groups of Container Settings map onto this picture:

  • Padding and Margins — how much empty space there is inside the border (padding) and outside it (margins).
  • Border — a line on any of the four sides, its color, and rounded corners.
  • Background — a background color and/or a background image or video, with opacity and blur, plus an optional text color for the section title and intro.
  • Background Media Parallax — makes a background image drift slowly as the visitor scrolls.

The container wraps the whole component: section title, intro text and items all sit inside it. When the component is narrower than 100% (Component Width), the container is the narrowed, centered box.

Where to find it

Container Settings is the last section of a component card, collapsed by default. Click its heading to open it; inside, each group (Padding, Margins, Border, Background) is a further collapsible section, followed by the Background media field.

The Container Settings section fully expanded: Padding (Top, Right, Bottom, Left all 0px), Margins (0px, 0px, 32px, 0px), Border (four sides set to none, Border color black, Border radius none), Background (Background color, Text color, Text color applies to, Background opacity 100, Background blur 0, and the Background Media Parallax group with Enable parallax, orientation Up, scale 1.4, delay 1), and the Background media field with an Add media button.
The complete Container Settings section with every group opened and default values.

Default values

A new component starts with a neutral container: no border, no background, no padding, and a 32-pixel margin below it so that stacked components do not touch.

GroupDefaultEffect
Padding0px on all sidesContent touches the border.
MarginsTop 0px, Right 0px, Bottom 32px, Left 0pxA gap under each component.
BorderAll sides none, color #000000, radius noneNo visible border.
BackgroundNo color, no text color, opacity 100%, blur 0, no media, parallax offTransparent; the page background shows through.

You only need to open Container Settings when you want to change something. Leaving it untouched is the right choice for most components.

Which components have Container Settings

  • Full set (padding, margins, border, background, media, parallax): Accordion, Carousel, Feature Box, Image Gallery, Infinite Logos, Links, Profiles, Read More, Special List, Tabs, Video, Views.
  • Padding and Margins only: Slideshow — each slide already has its own background, so the container has no border or background groups.
  • No Container Settings: Simple Content (it has per-region backgrounds instead) and Overlay Content.

Typical recipes

You wantSet
A colored band behind a componentBackground color + Padding 32px on all sides (so the content does not touch the colored edge) + optional Text color.
A framed boxBorder 1px or 2px on all sides + Border radius 8px + Padding 24px.
A photo behind a title and introBackground media (image) + Text color white + Padding 64px top and bottom; if the text is hard to read, add a few pixels of Background blur or choose a darker, calmer photo.
Two components closer togetherReduce the Margin bottom of the first one from 32px to 8px or 0px.
A cinematic heroBackground media (image) + Enable parallax.

Entering sizes

Padding, margin, border widths and border radius are typed as a number followed by a unit: 16px, 1.5rem, 2em or 5%. Pixels (px) are the easiest to predict. The word none is accepted for border sides and radius. A value without a unit, or with a typo, is rejected when you save the page.

Padding and Margins

Padding and Margins

Padding is the empty space inside the container, between its edge and the content. Margins are the empty space outside the container, between it and whatever comes before, after or beside it. Both are set per side: Top, Right, Bottom, Left.

Nested rectangles showing margins outside the border, padding inside the border, and the component content in the middle.
Padding is inside the border and shows the background; margins are outside and always transparent.

Padding

The Padding group with four text fields Top, Right, Bottom and Left, all set to 0px.
Padding fields with their default of 0px.
  • Default: 0px on all four sides.
  • Padding matters as soon as the container has a visible background or border: without padding, the text and images touch the colored edge. Typical values are 16px to 48px.
  • Padding is inside the container, so it is covered by the background color or image. Increasing the top and bottom padding is how you make a background band taller.
  • Padding reduces the space left for the content. On a narrow Component Width or in a sidebar, keep padding small.

Margins

The Margins group with four text fields: Top 0px, Right 0px, Bottom 32px, Left 0px.
Margin fields with their defaults. Bottom is 32px so that stacked components are separated.
  • Default: Top 0px, Right 0px, Bottom 32px, Left 0px.
  • The bottom margin is what keeps consecutive components apart. Lower it to bring two related components closer; raise it (64px, 96px) to separate sections more clearly.
  • Margins are always transparent: the page background shows through, never the container background.
  • Left and right margins are handled for you when the component is narrower than 100% — APB centers the component automatically (see Component Width). Leave them at 0px unless a designer asks otherwise; a left or right margin on a 100%-wide component pushes it out of alignment with the rest of the page.
  • Set vertical spacing on one side only (the bottom, as the default does). Mixing top and bottom margins across components makes the spacing between them hard to predict.

Accepted values

Each field takes a number followed by a unit:

UnitExampleMeaning
px24pxPixels. Fixed size; the easiest to reason about.
rem1.5remMultiples of the site’s base font size (usually 16px, so 1.5rem = 24px). Scales with the visitor’s font settings.
em2emMultiples of the component’s own font size.
%5%Percentage of the width of the surrounding area (for all four sides, including top and bottom).

Decimals are allowed (0.5rem). Negative values, values without a unit and anything else are rejected when you save. An empty field means “no rule”: the component then uses whatever spacing the site theme gives it, which is usually none — type 0px when you explicitly want zero.

Examples

GoalPaddingMargins
Plain component in the flow of the page0px all sides0 / 0 / 32px / 0 (defaults)
Colored band with comfortable breathing room32px all sides0 / 0 / 48px / 0
Tall hero with a background photo96px top and bottom, 32px left and right0 / 0 / 64px / 0
Two components that belong togetheras neededfirst: bottom 8px; second: default

Border

Border

The Border group draws a solid line around the container — on all four sides or only some of them — in one color, with optional rounded corners.

Three example boxes: one with a 2px blue border on all sides and square corners; one with only a 4px orange bottom border; one with a 2px green border and 16px rounded corners.
All sides, one side only, and rounded corners. The border is always a solid line.

The fields

The Border group: Top, Right, Bottom and Left fields set to none; a Border color swatch set to black; a Border radius field set to none with the hint Examples: none, 4px, 8px, 50%.
The Border group with its defaults: no border, black, square corners.
FieldDefaultWhat to type
Top / Right / Bottom / Left none The thickness of the line on that side: 1px, 2px, 4px… or none for no line. Each side is independent.
Border color #000000 (black) Click the swatch to open the color picker, or type a hex color such as #184D9B. One color is used for all sides that have a border.
Border radius none How rounded the corners are: 4px (subtle), 8px, 16px, or 50% (a pill or circle shape). none keeps square corners.

How it behaves

  • Solid only. There is no dashed or dotted option; the line is always continuous.
  • The border sits between padding and margin. Without padding, the content touches the line. Add 16px to 32px of padding when you draw a border on all sides.
  • The radius also clips the background. When you set a radius, the container background (color, image or video) is rounded to the same corners, and anything that would stick out of the rounded corner is cut off.
  • The radius works without a border. You can round the corners of a plain background band by setting a radius and leaving all sides at none.
  • Sizes follow the same rules as padding: a number with a unit (px, rem, em, %). Invalid values are rejected when you save.

Examples

LookTopRightBottomLeftColorRadius
Thin frame1px1px1px1px#D9E2EC8px
Card with rounded corners2px2px2px2px#009A6E16px
Accent line on the left (quote style)nonenonenone6px#FF6D00none
Divider under the componentnonenone1pxnone#CBD2D9none

The 90%-wide feature box on the Component Width page is a real example: a 3px green border with rounded corners.

Background

Background

The Background group fills the container with a color, an image or a video, controls how transparent or blurred that fill is, and can change the color of the text printed on top of it.

The fields

The Background group: Background color and Text color swatches (both empty), Text color applies to set to Exclude items, Background opacity (%) 100, Background blur (px) 0, and the collapsed Background Media Parallax group with the Enable parallax switch.
The Background group with its defaults (parallax was switched on here only to show its fields). The Background media field itself sits just below the Container Settings groups.
FieldDefaultPurpose
Background coloremptyA flat color filling the container.
Text coloremptyColor of the section title and intro (and optionally the items) so they stay readable on the background.
Text color applies toExclude itemsWhether Text color also reaches the text inside the component’s items.
Background opacity (%)100Transparency of the background color, from 0 (invisible) to 100 (solid).
Background blur (px)0Softens the background image or video.
Background medianoneAn image, uploaded video or YouTube/Vimeo video that fills the container.
Background Media ParallaxoffScroll effect for a background image; see its own page.

Background color

  • Click the swatch to open the color picker, or type a hex value such as #184D9B. Clear the field to remove the color.
  • The color fills the whole container: padding included, margins excluded. Add padding so that the content does not touch the edge of the colored area.
  • With a border radius, the color is rounded to the same corners.
  • When a Background media is also set, the image or video covers the color; the color is only visible for an instant while the media loads, or through transparent parts of a PNG. Use one or the other.

Text color and “Text color applies to”

A dark background makes the default (dark) text unreadable. Text color fixes that without touching the theme:

  • Pick a color (usually white, #FFFFFF, on dark backgrounds). Leave it empty to inherit the normal page text color.
  • Text color applies to decides how far the color reaches:
    • Exclude items (default) — only the Section Title and Intro Text change color. The items keep their own styling (a card with a white body stays readable).
    • Include items — the text inside the component’s items changes color as well. Use it for components whose items are plain text on the container background, such as a Links list or a Special List.
  • Text color has no effect until you set it; the “applies to” choice alone does nothing.

The full-width feature box on the Component Width page shows the combination: blue background color, white text color, rounded corners.

Background opacity (%)

Three copies of the same photo behind a section title: at opacity 100% and no blur; at opacity 50% where the page shows through and the photo looks washed out; and at 6px blur where the photo is soft and the text easier to read.
Opacity lets the page show through the background; blur softens it.
  • A whole number from 0 to 100. 100 is a solid color; 50 lets half of what is behind the container show through; 0 makes the color invisible.
  • Opacity applies to the Background color. It does not fade a background image or video, and it never affects the text.
  • Typical use: a light tint over a patterned page background (opacity 20–40) so the component stands out gently.

Background blur (px)

  • A whole number of pixels, 0 (default) for no blur. 2–4px softens a photo slightly; 8–12px turns it into an abstract wash.
  • With a Background media, the image or video itself is blurred (and enlarged a little so its edges stay covered). This is the usual way to keep a title readable over a busy photo.
  • Without media, and with a translucent or absent background color, the blur is applied to whatever lies behind the container (a “frosted glass” effect). On a plain page background this is not noticeable.
  • Blur never affects the text or the items.

Background media

The Background media field: No media items are selected, an Add media button, and the hint Optional image or video background for the container. One media item remaining.
The Background media field, below the Background group.
  1. Click Add media. The media library opens; pick an existing item or upload a new one.
  2. Three kinds of media are accepted: an Image, an uploaded Video file, or a Remote video (a YouTube or Vimeo link).
  3. Only one item can be selected. Use Remove next to it to choose another.

On the page:

  • The media is scaled to cover the whole container and is centered; parts of it are cropped when the container’s shape differs from the media’s. Give the container enough padding (top and bottom) so a reasonable part of the picture is visible.
  • Videos play automatically, muted and in a loop, without controls — they are decoration, not content. Keep them short and light; for anything the visitor should watch, use the Video component instead.
  • An image background can be given a scroll effect with Background Media Parallax.
  • Combine with Text color (white) and, if needed, Background blur for readability.

Recipes

LookSettings
Dark band with white headingBackground color #184D9B · Text color #FFFFFF · Exclude items · Padding 32px
Soft highlight behind a componentBackground color #F5F7FA (or a brand color at opacity 15) · Padding 24px · Border radius 8px
Photo hero with readable titleBackground media (image) · Text color #FFFFFF · Blur 4px · Padding 96px top/bottom
Ambient video behind a links gridBackground media (video) · Text color #FFFFFF · Include items · Padding 48px

Background Media Parallax

Background Media Parallax

Parallax makes a background image move a little more slowly than the page while the visitor scrolls, which gives the container a sense of depth. It is an optional effect for containers that have an image as Background media.

Before you start

  • The container must have a Background media of type Image. Parallax is not available for video backgrounds or for a plain background color.
  • The Background Media Parallax group (inside the Background group) only shows up once an image is selected. If you have just added the image and do not see the group, save the page and open the component again.
  • Give the container generous top and bottom padding (64px or more). The effect is invisible on a short container because there is not enough distance to scroll through.

The fields

The Background Media Parallax group with Enable parallax switched on, Parallax orientation set to Up, Parallax scale 1.4 and Parallax delay 1.
The parallax fields with their defaults, shown after switching Enable parallax on.
FieldDefaultMeaning
Enable parallax off Turns the effect on. The other three fields appear only when it is on.
Parallax orientation Up The direction the image drifts as the visitor scrolls down: Up (the classic effect), Down, Left or Right. Left and right give a subtle sideways slide.
Parallax scale 1.4 How much the image is enlarged so that it has room to move without showing empty edges. 1.0 means no enlargement (and almost no visible movement); 1.4 enlarges it by 40%; higher values move more but crop more of the picture. Stay between 1.2 and 1.8.
Parallax delay 1 How smoothly the image follows the scroll, in seconds. 0 makes it follow instantly; 1 adds a gentle easing; 2 or more feels floaty. Decimals are allowed (0.6).

How it behaves

  • The image is enlarged by the scale factor and shifted as the container moves through the viewport. When the container is in the middle of the screen the image is centered; at the top or bottom of the screen it is offset in the chosen orientation.
  • Because of the enlargement, the visible part of the picture is smaller than with a static background. Choose photos whose subject is near the center and avoid images that contain text.
  • Background blur and Text color work together with parallax. Background opacity does not affect the image.
  • If the visitor’s browser cannot run the effect, the image is shown as a normal static background — nothing breaks.
  • Parallax is decorative. Do not rely on it to convey information, and avoid stacking several parallax containers on one page; one hero at the top is usually enough.

Recipe: hero with parallax

SettingValue
ComponentLinks (two or three buttons) or Feature Box
Show Section TitleYes, with a short Intro Text
Padding120px top, 120px bottom, 32px left and right
Background mediaA wide landscape photo (at least 1920 pixels wide)
Text color#FFFFFF, Include items
Enable parallaxon; orientation Up; scale 1.4; delay 1
Target PlacementMain Content Top or Top region, to place it above the title