Change Frame Size with BX24.resizeWindow
Choose a tool for developing with an AI agent:
- use Alaio Vibecode to build an app for Bitrix24 from a task description without knowing any programming language. The agent writes the code and deploys the app to a server, with no manual hosting setup
- use the MCP server to develop a REST API integration in your own project. The agent refers to the official REST documentation
BX24.resizeWindow(width: integer | string, height: integer | string, callback?: callable): void;
The BX24.resizeWindow method sets the width and height of the frame in which Bitrix24 displays the application.
The method works only inside the application frame in Bitrix24. Call it after the library is initialized, in the BX24.init handler. The method requires no scope of its own: it controls the interface and does not call the REST API.
Method Parameters
Required parameters are marked with *
|
Name |
Description |
|
width* |
The frame width in pixels, greater than zero. You can also pass a string that starts with a number, for example |
|
height* |
The frame height in pixels, greater than zero. The library reads a string the same way as for |
|
callback |
Callback function. It receives an object with the new frame size (detailed description) |
The string '100%' does not stretch the frame: the library reads it as 100 pixels. To stretch the frame to the full width and fit the height to the content, use BX24.fitWindow.
Code Example
How to Use Examples in Documentation
BX24.init(function () {
BX24.resizeWindow(980, 700, function (size) {
console.log('New frame size:', size.width, size.height);
});
});
Response Handling
The method does not return data (void). When Bitrix24 resizes the frame, it calls callback and passes an object with the width and height it has set:
{
"width": 980,
"height": 700
}
Returned Data
|
Name |
Description |
|
width |
The frame width in pixels |
|
height |
The frame height in pixels. This is the height that Bitrix24 has set, not the one visible on the screen — see the warning below for details |
When the application is open on its own page in Bitrix24, the frame on the screen is never less than 600 pixels high. If you pass a smaller height, callback receives it, but the frame remains 600 pixels high.
Error Handling
The method does not return error codes. If Bitrix24 does not execute the command, callback is not called.
|
Situation |
What Happens |
What to Do |
|
The width or height does not yield a positive number: |
The frame size does not change, and |
Pass both sizes as positive numbers |
|
The method is called in the window opened by BX24.openApplication |
The window size does not change, and |
Do not change the size from inside the window. Bitrix24 sets the window height, and the width can be passed with the |