Kindly EditDocumentationTry the editor

Padding, margin, and gaps

Control space inside a box, outside it, and between its children.

Choose the kind of space#

Padding is inside the selected element, between its edges and content. Margin is outside it. Gap belongs to a flex or grid container and separates its children. A section’s designed Space choice is a theme preset; exact values are in Developer mode.

The spacing box#

Open Style → Spacing (in Advanced while Style is on Hover or Focus). Since 0.9.15 it is drawn like a browser's inspector: an orange Margin ring around a green Padding ring around the element. Each side's number sits on that side; type it in place. Pull a side of a ring outward to grow it or inward to shrink it; each drag is one Undo step. Each ring has its unit, a link that makes its four sides change together (it starts linked when the existing values match) and a reset. An empty value restores the theme or inherited value.

Before changing a section’s outer margin, consider whether the intended space is actually padding around its content. Before giving every card a right margin, consider the grid’s gap, which works across rows without leaving an extra edge on the last item.

Spacing on the page (Developer mode)#

In Developer mode the selected element shows its spacing on the page (0.9.15 and later). The first click on words, a button or a link selects it, so these can be used; a second click types (a double-click still types at once).

  • Green bars on its inner edges drag its padding; orange bars on its outer edges drag its margin. The band being changed is shaded and its size is shown as you drag. Each drag is one Undo step.
  • Double-click a bar to set that side to 0. Right-click it to make that side the same as the side across from it, keeping its unit. The band shows the new size for a moment.
  • A centered box has no orange bar on its sides: that margin is only the room left over, and dragging it would trade the centering for a fixed size. A negative margin's band runs back inside the box, and its size says minus.
  • A square on the bottom-right corner drags the element's width across and its minimum height down, with the size shown. A new width is a share (%) of the box it sits in, so it still fits smaller screens; a width that already has a unit keeps it. Shift snaps to 5% or 8px. The square is hidden on full-width sections and wherever the settings panel covers it.
  • When Max width holds a drag back, a dashed line shows where the box stops, labeled with its max width. The first time, a short note says so, with a link that highlights the Max width setting.

The bars and the band follow the page's zoom, so they line up with the element when the page is narrowed beside the settings panel.

Responsive adjustments#

A large Desktop spacing value can be excessive on a phone. Choose Phones and override only the sides that need to change. Resetting a phone value restores the tablet or desktop value rather than setting the side to zero.

Inspect the owner#

A section can contain an inner width-constrained box. Padding on the section and padding on that box are different layers. Use the breadcrumb and outline to identify which box creates the space. A row’s child also has its own margins, so a gap change may not explain all visible distance.

Verification#

Check adjacent backgrounds, first and last items, wrapped rows, and phone width. Save and reload. Avoid using a Spacer element to conceal a spacing problem that belongs to the container’s native controls.

About this page

Documents Kindly Edit 0.9.16. Source: assets/editor.js:developerAdvancedPanel, assets/editor.js:devEdges, includes/responsive.php. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.