# \setupcolumns

## Syntax (autogenerated)

 \setupcolumns[...=...,...] ...=...,... inherits from \setupmixedcolumns

## Syntax

 \setupcolumns[...,...=...,...] n number ntop number rule on off – DEPRECATED - use "separator=rule" instead height dimension tolerance verystrict strict tolerant verytolerant stretch distance dimension balance yes no align yes no text blank fixed halfline line flexible big medium small option background direction left right [...,...=...,...] see \setupframed

## Description

Consider using paragraphs (\defineparagraphs or column sets (\startcolumnset instead of ‘simple’ columns.

 n Number of columns. Default is n=2. rule DEPRECATED: Draw a line between the columns. Default is off. separator=rule Add vertical line between columns. tolerance Affects spacing. Narrow columns should be set tolerant, verytolerant or stretch distance Size of the gap between the columns. balance Should the columns be balanced, i.e. should they get the same number of lines? align Left, right (raggedleft, raggedright). blank Amount of whitespace between paragraphs set in columns. Also accepts a dimension as an argument. Column equivalent of \setupwhitespace. option With option=background you can use everything that \setupframed offers. direction Default is right, i.e. the first column is on the left; 'left' means the first column is the rightmost. height height is unclear to me. ntop ntop contains the minimum number of lines a column should have. If, when a new set of columns starts (e.g. at the start of a page), there are 12 lines to distribute and `ntop=7`, then ConTeXt will produce one 12-line column rather than two 6-line columns. Note that `ntop=6` will result in one 7-line column and one 5-line column: ConTeXt seems to prefer that the last column be shorter, as long as its length is at least `ntop - n + 1`.

## Example

```\setupcolumns
[n=3,
rule=on, % DEPRECATED
separator=rule, % need newly instead "rule=on"
ntop=4,background=color,backgroundcolor=green,
]

\startcolumns