place

Adds an existing group of objects to a card and sets the sharedBehavior property to true.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

place group onto card

# Params

- group : The group is any group in the current stack that is not contained (nested) in another group. - card : The card is any card in the current stack.

# Examples

place group "Navigation" onto card "Navy" -- group is on current card

place background 1 onto this card -- group may be on any card

# Description

Use the place command to add an existing group to a card.

Only top-level groups may be placed onto multiple cards; an attempt to place a nested group onto another card throws an error.

Placing a group onto another card automatically sets the sharedBehavior property of the group to true.

>*Warning:* If the group did not previously have the sharedBehavior > property set to true, placing a group will (in addition) set its > backgroundBehavior property to true. This is legacy behavior and > will be removed in version 5.0. Scripts that rely on place setting > backgroundBehavior to true for new groups should be updated to > explicitly do so after the place command.

>*Important:* The words "group" and "background" are not always > interchangeable. A group reference with the word "group" refers to a > group on the current card. To refer to a group that's not on the > current card, you must use the "background" form.

>*Tip:* To have a group automatically placed on newly created cards, > leave its backgroundBehavior property as true.

# Tags

objects,

# See

- **command:** create card, start editing, copy, insert script, remove - **keyword:** onto - **property:** groupNames, sharedBehavior, backgroundBehavior