Margin Property

Markdown

Controls margin for elements. Supports scaled values, custom values, directional control, and negative margins.

<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Box m="4" className="border border-[rgb(var(--border-1))]">
    <Text>Margin of 4</Text>
  </Box>
</Flex>

Examples

Margin Scale

The m prop accepts scale values 0–8 and auto.

0
1
2
3
4
5
6
8
auto
<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Flex gap="2" align="center">
    {[0, 1, 2, 3, 4, 5, 6, 8, "auto"].map((num) => (
      <Box
        key={num}
        className="border border-[rgb(var(--border-1))] h-fit"
        m={`${num}`}
      >
        {num}
      </Box>
    ))}
  </Flex>
</Flex>

Negative Margins

Margin supports negative values for overlapping layouts.

-8
-6
-5
-4
-3
-2
-1
<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Flex gap="2" align="center">
    {[-8, -6, -5, -4, -3, -2, -1].map((num) => (
      <Box
        key={num}
        className="border border-[rgb(var(--border-1))] h-fit"
        mb={`${num}`}
      >
        {num}
      </Box>
    ))}
  </Flex>
</Flex>

Margin Directions

Use m, mt, mb, ml, mr, mx, and my for directional margin control.

m = 2
mt = 2
mb = 2
ml = 2
mr = 2
mx = 2
my = 2
<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Flex gap="2" align="center">
    <Box m="2" className="border border-[rgb(var(--border-1))]">
      m = 2
    </Box>
    <Box mt="2" className="border border-[rgb(var(--border-1))]">
      mt = 2
    </Box>
    <Box mb="2" className="border border-[rgb(var(--border-1))]">
      mb = 2
    </Box>
    <Box ml="2" className="border border-[rgb(var(--border-1))]">
      ml = 2
    </Box>
    <Box mr="2" className="border border-[rgb(var(--border-1))]">
      mr = 2
    </Box>
    <Box mx="2" className="border border-[rgb(var(--border-1))]">
      mx = 2
    </Box>
    <Box my="2" className="border border-[rgb(var(--border-1))]">
      my = 2
    </Box>
  </Flex>
</Flex>

Custom Margin

Margin also accepts custom CSS values.

m = 17px
<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Box className="border border-[rgb(var(--border-1))] w-fit" m="17px">
    m = 17px
  </Box>
</Flex>