Object Blocks: Overview of Methods

Blocks are the fundamental elements of a website page in Bitrix24. For instance, a block can contain text, an image, a feedback form, or a news list.

The methods landing.block.* manage the content of already placed blocks and work with templates from the repository. You can change text, images, styles, add cards, and upload files.

Quick navigation: all methods

User documentation: Create and configure your Bitrix24 site

How to Work with BlocksHow to Work with Blocks

1. Retrieve the list of blocks on the page using the landing.block.getlist method. You will need the page identifier lid.
2. Select the desired block and obtain its data using the landing.block.getbyid or landing.block.getcontent methods.
3. Make changes. Use point methods (updatenodes, updateattrs) for partial updates or updatecontent for a complete content replacement.
4. If you need to add or modify cards, such as list items, use the methods from the Block Cards group.
5. Publish the page using the landing.landing.publication method to make the changes visible to visitors.

Interaction with Other ObjectsInteraction with Other Objects

Page. The page identifier lid is mandatory for all operations. You can obtain it using the landing.landing.getList method.

Page Methods. The methods in the Blocks on Page section add, move, hide, and delete blocks on the page. The landing.block.* methods modify the content and configure a specific block.

Manifest. The structure of the block, available fields, and settings are described in the manifest. You can obtain the manifest of a placed block using the landing.block.getmanifest method, and the template from the repository using the landing.block.getmanifestfile method.

Features of OperationFeatures of Operation

Drafts. Most modification methods work with the draft of the page. For published pages, use the block identifiers from the edit mode edit_mode.

Publication. Changes in the draft are not visible on the site until the page is published using the landing.landing.publication method.

Files. The landing.block.uploadfile method only uploads a file and associates it with the block. To display the file in the content, additionally call landing.block.updatenodes.

Point Update. To modify individual elements, use updatenodes, updateattrs, or updateStyles. A complete replacement via updatecontent requires passing the entire content of the block.

Overview of MethodsOverview of Methods

Scope: landing

Who can perform methods: depending on the method

Block CardsBlock Cards

Method	Description
landing.block.addcard	Adds a card to the block
landing.block.clonecard	Clones a block card
landing.block.updateCards	Massively updates block cards
landing.block.removecard	Removes a card from the block

Content and Parameters of the BlockContent and Parameters of the Block

Method	Description
landing.block.updatenodes	Modifies the content of the block nodes
landing.block.updateattrs	Changes the attributes of the block nodes
landing.block.updateStyles	Modifies the styles of the block
landing.block.updatecontent	Completely replaces the content of the block
landing.block.changeNodeName	Changes the node tag
landing.block.changeAnchor	Modifies the anchor link of the block
landing.block.uploadfile	Uploads and associates a file with the block

Retrieving Block DataRetrieving Block Data

Method	Description
landing.block.getlist	Returns the list of blocks on the page
landing.block.getbyid	Returns block data by ID
landing.block.getcontent	Returns the content of the block
landing.block.getmanifest	Returns the manifest of the placed block

Block RepositoryBlock Repository

Method	Description
landing.block.getrepository	Returns the list of templates from the repository
landing.block.getmanifestfile	Returns the manifest of a template from the repository
landing.block.getContentFromRepository	Returns the content of a template before adding it to the page