Payments are experiencing issues due to temporary restrictions in Russia. If your payment does not go through, please submit a support request.Our support team is available 24/7 — we are always here to help with hosting and server issues.We are now accepting requests for dedicated server rental and colocation services in our data center.Reminder: we recommend enabling backups for additional data protection.A new VPS/VDS lineup with NVMe storage and improved performance is now available.Maintenance work on some servers has been completed. All services are operating normally.

MODULE FOR 1C-BITRIX

Migrations for developers

Migrations for developers

The module simplifies transferring changes between project copies. All database structure modifications are recorded in migration files, which are stored in version control alongside the rest of the codebase. When updating a copy, developers apply these files to refresh the database. Management is available via both the command line and the administrative interface.

5.00/5 · 20 ratings

1C-Bitrix Marketplace: 5/5 · 20 ratings

Technical details

Published
3 March 2015
Updated
17 September 2026
Version
5.15.0
Installed
More than 1000 times
Compatible editions
First Site, Start, Standard, Small Business, Business, Corporate Portal, Enterprise
Responsive design
No
Composite support
No
Compatible with Sites24
No
Developer
Migrations for developers

What this solution does

The module simplifies transferring changes between project copies. All database structure modifications are recorded in migration files, which are stored in version control alongside the rest of the codebase. When updating a copy, developers apply these files to refresh the database. Management is available via both the command line and the administrative interface.

For “Migrations for developers”, General iT can perform integration, configuration and a final check after installation.

UPDATE HISTORY

What’s new

3 releases
5.15.0 (17.09.2026)Latest update

5.15.0

Config directory check (implemented by @karedum Dmitry Vorotyntsev)

Export of infoblock element properties depending on the section (implemented by @arinamirosha Arina)

Added support for files from Bitrix S3/cloud storage (implemented by @temi4 Artem)

Fixed check for the presence of a symbolic code for related elements (found by @zhenikhovs)

5.13.0 (08.07.2026)

5.13.0

Migration for languages and regional settings (implemented by @yanochka_dev)

Blog export (implemented by @temi4)

Blog post export (implemented by @temi4)

Blog user property export (implemented by @temi4)

Migration for removing infoblock properties (implemented by @temi4)

Migration for forums (implemented by @temi4)

Migration for polls (implemented by @temi4)

Migration for subscription categories (implemented by @temi4)

Migration for module settings (implemented by @KotkinRoman)

Added display of the relative path to the file in error output

Community tags for migration forms added by the community

Compatibility with PHP 8.5, fix nullable deprecation in HelperException

5.8.6 (12.06.2026)

5.8.6

Security audit fixes:

Detailed exception tracing that reveals sensitive data has been disabled.

The option ['allowed_classes' => false] has been added to methods using unserialize.

Variables in form fields have been escaped using htmlspecialcharsbx where previously missing.

The migration file name is validated against a strict regular expression compatible with PHP class naming rules.

5.6.4

The VersionTable::getCurrentUserLogin() method has been improved to prevent errors; suggested by Oleg Lukash.

5.6.1

The Locale::getMessage method has been fixed for older Bitrix versions; suggested by @KotkinRoman.

Form statuses now use the group symbolic code instead of the ID; suggested by @PapazovAnton.

Display of the migration builder header on the form.

"Current" migrations are now considered all those starting from the first uninstalled one, or those created no more than 8 hours ago.

5.6.0

Added the ability to migrate order properties; implemented by @ashirchkov - Alexey Shirchkov.

5.5.2

Export of user fields by type.

Export of infoblock properties by type.

Selection of a category for transferring infoblock elements (suggested by @yanochka_dev).

Transfer of SHOW_COUNTER and SHOW_COUNTER_START (suggested by @skeitol).

5.4.1

Installation of individual migrations via Sprint\Migration\Installer (suggested by Vyacheslav Mokin @v_mokin).

5.3.3

Fix for exporting email and SMS templates (suggested by @eirubtsov).

Fix for quote escaping errors when generating XML (suggested by @fortune1dev, @teleak, @AlexeyGfiProgrammer, @AndreyChursin).

Fix for types in iblockexchangehelper.php (suggested by @AndreyChursin).

Fix for exporting html\text properties (suggested by @SergeyGarnov).

Fix for exporting properties linked to categories (suggested by @SergeyGarnov).

Page header configuration in the admin panel via config.

More options for the highload block element transfer form.

Support for Bitrix CLI (author Alexey Shirchkov @ashirchkov)

Method saveSectionsFromTree updating categories by structure (author Sergei Bukov @sergey_from_riders)

Fix for exporting user fields of type enumeration (list) (author Timofey Guriev @timgur)

Version of composer/installer changed to "^1.0|^2.0" (author Alexey Shirchkov @ashirchkov)

Fix for a situation where the ORM in PostgreSQL converts table columns to uppercase (author Denis @zeeerd)

Export of extended rights for information blocks and highload blocks (suggested by @iamdrogalov, @kartovitskii)

Fix for exporting properties bound to elements (suggested by Sergei Zhenikhov @zhenikhovs)

Fix for exporting the media library (suggested by S.Ol @skeitol)

5.0.0

Minimum PHP version increased to 8.1

PostgreSQL compatibility added (idea by Yaroslav 3NV, Anton Sayants and others)

Support for windows-1251 encoding removed

Methods of the SQL query helper $helper->Sql() changed

Display of fatal errors in the admin panel during migration execution

Module performance increased, query optimization performed

Obsolete methods in helpers marked as deprecated removed

Confirmation required when deleting a migration via the admin panel (idea by Skeytar Victor)

Fix for displaying links in migration descriptions (idea by DronCity-)

Color tags in migration descriptions [red]red text[/] [label:yellow]yellow tag[/] and so on (idea by DronCity-)

Partial decoding of values added in user field migrations (idea by Artem Listikov)

Links in descriptions of migration creation forms

Loading icon added during migration execution (idea by @ildar_kkk)

SMS template migration (idea by Vladimir Yakimenko, Vladislav @Mvaice, Zlyuken @Zlyuken)

Methods for step-by-step migrations restartOnce(), restartWhile()

Data schemas section removed, project support section removed

Transfer of fields from the SEO tab during information block element migration (idea by @kegorka, @lutoOndrey)

Console interface for the migration list redesigned

4.18.4

Loading icon added during migration execution (author @ildar_kkk)

4.18.2

Partial value decoding added to user field migrations (author Artem Listikov)

Display of fatal errors in the migration execution log

4.18.1

Module performance accelerated by reducing database queries.

4.16.1

Installation of migrations in console via an arbitrary list: migrate up version2 version1 version5

Fixed HighloadBlockLangTable handling (authors @Nemial, @lugantsev_web)

Fixed handling of exporting a user field linked to an information block when the block is not found (author @SkeitOl)

4.15.1

Migration for deleting information blocks (author @Elnadrion)

4.12.6

Remembering the display state of the migrations list

Added search for migrations in the migrations list header

Added "Current" filter - shows all migrations starting from the first uninstalled one

Transfer of access rights for form statuses (arPERMISSION)

Accelerated installation and rollback of the migrations list in the admin panel

4.10.4

Agent migration without mandatory module binding

Filter for unknown migrations

Improved interface for agent and user field migrations

Migration for user fields (author @Cleverscript)

Deletion and transfer of migrations with content (author @GTAlexxx)

Reduced size of migration files for web forms

Display of migration author, creation date, and installation date (author Andrey Donetsk and others)

Exception handling during migration rollback (authors @w1cerg @pu6elozed)

Added saving of migration installation information

Web form migration now supports exporting individual fields

Horizontal scrolling for the migrations list

sprint.migration excluded from the module settings scheme (author @pu6elozed)

SQL helper for deleting tables (author @Elnadrion)

4.8.2

Search in dropdown lists (author @SatanaKonst)

Swapped migration of information block categories and elements (author @Mvaice)

Fixed property sorting when adding to an information block (author ildar_kkk)

Display of additional error information (author Sergey Prokhanov)

4.6.1

Support for configuring parameters for the smart filter (author Petr Lebedev @defast)

Field SERVER_NAME removed during infoblock export (author Andrey Chursin)

Error when creating a user group with the SECURITY_POLICY field (author @jasmanchik)

Hint in migrations regarding required fields (author @igord_sdk, @Hasanov_Evgeny)

Date format for creating migration files and regular expression for finding migrations moved to config (authors @Semyashkin, @ivan_milov, @LebedevPV, @ildar_kkk)

Support for configuring parameters for smart filter (author @defast)

Improved creation of migrations for highload blocks (author @defast)

4.2.4

Transfer of the Event Log tab for infoblock migration (author @SkeitOl)

Refinement of the mail event schema (author @jasmanchik)

Parameter in exchange_dir configuration overriding the directory for import files (xml and images) (author @casnerano)

Migration of custom column names in lists (custom_names) (author @Sinator)

Resumption of long-running migration, added button "Run Again" (author @Sinator)

Rollback of added elements in infoblocks and catalogs (author Vladimir Zasorin)

Correct transfer of mail templates for forms (list arMAIL_TEMPLATE) (author SergeyBeloglazovRL)

Strict mode for installing migrations: if an error occurs in one of the migrations, the process stops

Transfer of highload block elements by xml_id

Transfer of linked infoblock elements (author fenix63)

Added method $this->checkRequiredVersions([VersionName1]), which throws an exception if required migrations are not installed

Added property $requiredVersions=[VersionName1, VersionName2], which prevents installing the migration if specified versions are not installed

Removed parameter in config version_filter and method in migration class $this->isVersionEnabled(), which incorrectly filtered the list of migrations

Methods in migration class saveData, getSavedData, deleteSavedData moved inside object $this->getStorageManager()

4.1.3 (28.11.2022)

Previous versions of the module removed to allow installation of the module via marketplace with PHP 8.0 (author Elnadrion)

4.1.1 (17.07.2022)

Sorting when adding an agent (author @artemSmagin)

Archival migration configuration disabled; created via settings (author @zatrofeemranoutrom)

Interface locking (author Sinator)

Improved error interception (author Sinator)

OnSearchConfigFiles event for loading third-party configs (author Anton Sokolov)

Improved migration of elements to sections with identical names (author reygasai)

Compatibility with PHP 8.0 (author smilingcheater)

4.0.2 (12.12.2021)

PHP version increased to version 7

New interface for creating migration forms

Bug fixes in 4.0.0 (author Ramil' Yunaliev)

3.30.1 (24.10.2021)

Transfer of SEO infoblock settings (author SkeitOl)

3.29.5 (12.10.2021)

Compatibility of infoblock property parameters for older Bitrix versions (author James Foster)

3.29.3 (22.09.2021)

Expanded error messages (author Arkharis)

Transfer of infoblock property parameters (author AlexandrKhurs, w1cerg)

The infoblock property transfer checkbox does not stop migration creation if there are none (author Artem Pervushin)

Helper for working with settings redesigned; support for working with b_option_site (author AlexandrKhurs)

3.28.7 (05.05.2021)

Error texts corrected

3.28.3 (10.04.2021)

Transfer of media library images (author Andrey Pum-purum)

Transfer of element descriptions for text infoblock properties (author Mikhail akellaweb)

3.25.1 (25.02.2021)

Public method for installing migrations from other modules (author vahitovOM)

Improved sorting of migrations in the list if the migration name ends with a number

3.23.4 (02.12.2020)

Selection of multiple elements for transfer (author Andrey @icantstopthinkingofyou)

Transfer of infoblock properties with category binding type (author Andrey @icantstopthinkingofyou)

Button to delete all unknown migrations

An error in the migration class will not break the migration list display (works in PHP 7 and above)

3.22.2 (08.11.2020)

Selection of multiple elements for transfer (author Andrey @icantstopthinkingofyou)

3.21.3 (01.11.2020)

Console commands are also available via the Symfony console when the module is connected as a bundle

Sprint\Migration\SymfonyBundle\SprintMigrationBundle()

Settings for transferring infoblock elements (author Andrei @icantstopthinkingofyou)

3.19.1 (12.10.2020)

Fixed error output when a migration file is not found (author Igor Dolgopolov)

Fixed an error when transferring a non-existent file (author Pavel, Vor Kolpakov)

The method $helper->UserTypeEntity()->deleteUserTypeEntity() also deletes the user field by entity code

(author Sergey Gripinsky)

New methods in helpers: $helper->Iblock()->saveElement(), $helper->Iblock()->saveSection() (author Pavel, Vor

Kolpakov)

Authorization handlers in the console have been disabled

3.16.3 (28.07.2020)

The tracker_task_url parameter has been restored in the config (author @Oldfag)

Correct display of an error when attempting to create migration tables (author @oleg_slinko)

English language support has been added

3.14.6 (24.03.2020)

Text display of migration status in the admin panel (author Sergey Beloglazov)

3.14.4 (02.03.2020)

Code improvement for quality monitor checks (author Anton)

Parameter in the config to disable authorization handlers in the console (author Mikhail Starkov)

Fix for migration to transfer infoblock categories (author FOlegF)

3.13.4 (10.02.2020)

Transfer of migrations via the action menu in the admin panel

Exception handling in the EventHelper handler (author anloc)

3.13.1 (02.02.2020)

Improvement of migration for configuring form display (author Nikita Kurgalin)

Improvement of the admin panel interface, new actions, grouping of actions in the menu

3.12.17 (22.01.2020)

Improvement of migration for displaying the list of infoblock elements

Filter for unsupported and modified migrations in the admin panel and console

XML_ID check for non-empty strings (author leonid-chernyavskiy)

Transfer of the "Activity" field in migrations for transferring infoblock elements (author Suvdaltsev Viktor)

3.12.12 (10.01.2020)

Transfer of elements to infoblock categories

Migration compatibility check with the module version

3.12.10 (26.12.2019)

Improvement of "Edit Form Settings", migration, change of tab IDs

Improvement of user properties migration - binding to HL and binding to infoblock (author Igor Dolgopolov)

Migration of infoblock categories

Retrieving infoblock element categories in IblockHelper

Specifying the module version when creating a migration

3.10.1 (05.11.2019)

Mark migration as completed when creating via the constructor

Improvement of migration file search (author Igor Dolgopolov)

Search for migrations by tags

3.9.1 (15.10.2019)

Parameter in the config version_name_template allowing to set the migration file name (author Konstantin Karnaukhov)

3.8.6 (06.10.2019)

Improvement of migration templates (author Konstantin Karnaukhov)

3.8.5 (30.09.2019)

Improvement of localization

3.8.4 (30.09.2019)

Gadget "Migration Summary" for the desktop (author Konstantin Sumarokov)

Migration of form statuses (author Konstantin Sumarokov)

Creation of infoblock categories from a tree structure (example examples/Version20190606000013.php)

Improvements in mail event schemes (author Konstantin Sumarokov)

3.6.8 (22.09.2019)

Checking directory creation by the module (author Konstantin Sumarokov)

3.6.7 (22.09.2019)

Migration of infoblock signatures (author skDYLAN)

Fix when working with infoblock property schemes (author Konstantin Sumarokov)

3.6.2 (12.09.2019)

PHP version raised to 5.6

Migration of infoblock elements (author Evgeny Semashko)

Migration of highload-block elements (directories)

Assistant for transactions in migrations (author skDYLAN)

Migration of grid formatting settings for main.interface.grid

Removed parameter tracker_task_url from the config

3.4.6 (18.07.2019)

Fix of button encoding in schemes (author Pavel Tupikov)

3.4.5 (16.07.2019)

Improvements on the module settings page

3.4.3 (20.06.2019)

Telegram group

3.4.2 (20.06.2019)

Helper for the media library

3.3.7 (06.06.2019)

Export/import of edit form and list settings

Added methods for working with group rights to infoblocks and highload-blocks

3.1.2 (30.05.2019)

Added transfer of infoblock section field settings when creating a migration

Console command for deleting migrations (author @webarchitect609)

Migration tagging (author Dmitry Panichev, Sergey Pashkevich)

3.0.16 (29.03.2019)

Improved AdminIblockHelper::saveElementForm method for saving form settings in multiple infoblocks (author Aslanator)

3.0.15 (10.03.2010)

Accelerated infoblock schema import by updating properties in a single step

3.0.14 (10.03.2010)

Delivery services for the store (author Sergey Gripinsky)

Display of changes during schema import

phpdoc for helpers

3.0.9 (03.02.2010)

Check for the presence of the module in both bitrix and local (author Ilya Makeev)

Registration of custom helpers (author Dmitry Solovov)

Schema for importing mail events

Flag migration_dir_absolute for specifying the absolute path to the migrations directory (author Dmitry Solovov)

3.0.7 (28.12.2018)

Correct saving of infoblocks for different sites (author Sergey Volkov)

3.0.5 (25.12.2018)

When exporting a schema, it is marked as installed

3.0.4 (24.12.2018)

Data schemas, new approach to exchanging changes between project copies

Bitrix module autoloader connected, module classes moved to lib/

Increased minimum PHP version to 5.4

Creating migrations for module settings

Updating variants for "list" field types CIBlockPropertyEnum (author Alexandr Kuznetsov)

2.8.16 (06.11.2018)

Creating migrations for mail events

Migration for webforms (author Stepan Rodionov)

Grouping builders into 2 columns

Deleting configurations

Scrolling the list of migrations in the admin panel

2.8.12 (15.10.2018)

Migration of user groups (author Maxim Lyaptsev)

Migration for agents

Creating configurations in the admin panel and console

2.8.7 (11.10.2018)

Generation for transferring e-num list values of custom fields (author Oleg Matasov)

New configuration for archive migrations

Transferring migrations between configurations (author Alexander Gorbunov)

The save methods in helpers create or update entities, combining addIfNotExists and updateIfExists

2.8.5 (15.09.2018)

Improvement of the updatePropertyIfExists method, checking the related information block

Select All button for checkboxes in migration builders

2.8.1 (05.09.2018)

Creation of a migration for information blocks that have no properties (when the "Export information block properties" checkbox is enabled) (author Evgeny Ponomarev)

Saving the migration hash to check if it has changed after installation

Refusal of MSSQL

2.7.3 (30.08.2018)

Improvement of migration generation for binding to an information block element (author Maxim Lyaptsev)

The migration admin panel has been moved from Services to Settings

Builders improved: "Create migration for information block"

Create migration for highload block

Create migration for user fields

The isBuilderEnabled method has been added to migration builders, which determines whether the builder is available for launch or not

2.6.1 (06.08.2018)

Each configuration creates a menu item in the admin panel

Running migrations from the console installs the module if it was not installed

2.5.8 (12.07.2018)

Selection of an information block from a drop-down list (author Max Lyaptsev)

Migration of information block properties (author Max Lyaptsev)

2.5.5 (30.05.2018)

Methods added to IblockHelper

Typos fixed in descriptions (author ildar r. khasanshin)

2.5.3 (03.03.2018)

The isVersionEnabled() method has been added to the migration class, by which the list of migrations can be filtered and executed (author Igor Pinchuk)

A version_filter parameter has been added in the config - an array by which the list of migrations can be filtered and executed

2.5.2 (04.11.2017)

Fixed an error where the default directory for migrations was always created, even if another was specified

When creating a migration for an information block, list-type properties do not migrate values Issue #35

2.5.1 (30.07.2017)

Configuration setting to hide the service in the admin panel (author Vadim Mitin)

Creation of a migration for user fields

Authorization as admin in the console

Access check removed when retrieving the list of elements and sections in the IblockHelper

The limit for the up and down commands in the console has been removed; documentation added

2.4.4 (25.05.2017)

Creation of a migration for a highload block

The stop_on_errors parameter must accept true/false values, not yes/no (author: Web Architect)

Improved error output format, including code, message, and stack trace when exceptions occur (author: Web Architect)

If one migration fails while others execute successfully, the returned code must still be non-zero (author: Web Architect)

2.4.3 (20.05.2017)

After displaying an error in the console, exit with a non-zero status (author: Web Architect)

Improved table display in the console

Added a parameter to stop migration execution upon encountering errors

Removed the status command from the console as it was useless

2.4.2 (10.05.2017)

Improved interface in the admin panel and console

Aliases for commands: list - ls, create - add

Migration constructors based on templates

Creation of migrations from the current state of the information block #30 (author: Dmitriy Tretyakov)

2.4.1 (23.02.2017)

Added ability to add and remove multiple user fields (author: Andrew Kopylov)

Saved migration data for issue #28 (author: anton-citrus-soft NA)

Helper for sites issue #27 (author: Dmitriy Tretyakov)

2.3.9 (02.02.2017)

Extended functionality of the AdminIblock helper issue #26 (author: Dmitriy Tretyakov)

2.3.8 (10.01.2017)

Command to remove unknown migrations issue #25 (author: Marat Bakirov)

2.3.6 (25.12.2016)

Mark migration as installed without execution issue #23 (author: Egor Kovyazin)

Access rights management for the migration module issue #24 (author: Sergii Martynovych)

2.3.5 (09.11.2016)

Additional configurations for modules issue #20 (author: Nikita Morkovkin)

Added ability to work with highload blocks issue #21 (author: Sergey Polyakov)

2.3.4 (01.11.2016)

Error in IblockHelper::addProperty() issue #22 (author: Anatoly Soldatov)

2.3.3 (26.09.2016)

Search for migrations by name and description in the admin panel and console using the --search=text flag

Fix console output display for Bitrix in windows-1251 encoding

2.3.2 (12.09.2016)

Fix for adding pull-requests #5 infoblock type (author Anton Tuzlukov)

addSectionIfNotExists method pull-requests #4 (author Anton Tuzlukov)

Added helper for configuring element addition forms pull-requests #2 (author Anton Tuzlukov)

Removal of escaping slashes when viewing migration descriptions Issue #17 (author XOlegator)

Missing deleteIblockTypeIfExists function Issue #16 (author Anonymous)

Add methods for working with sections Issue #10

Added migration messages output to the admin panel (logging tab)

Helper classes grouped in a manager, example: $helper = new HelperManager(); $iblockId =

$helper->Iblock()->getIblockId('code');

2.3.1 (03.08.2016)

Safe display of migration description in the admin panel and console

Config option tracker_task_url - allows creating links to task tracker by template #number

Interface improvements in the admin panel and console

2.2.12 (26.07.2016)

Anton Tuzlukov: Migration file names (Issue #14), Check by infoblock type (Issue #15)

Alexandr Kuznecov: Add fallback for removed methods getSitesIfExists() getLangsIfExists()

Blocking buttons during migration execution in the admin panel

Interface improvements in the admin panel and console

2.2.11 (10.06.2016)

Improvements in UserGroupHelper (Issue #12, Issue #13)

2.2.9 (01.06.2016)

Fixes in UserTypeEntityHelper (Issue #11)

2.2.8 (02.04.2016)

Styles fixed and method for displaying progress bar added for old Bitrix admin panel version 10.0.4

2.2.7 (15.01.2016)

Fixes in helpers

2.2.6 (05.01.2016)

Language files fixed

2.2.5 (25.12.2015)

Simplification of migration code by removing exceptions in helpers

New documentation added to README

2.2.4 (12.11.2015)

Legend encoding in the admin panel

New documentation added to README

New commands added for console mode

2.2.3 (26.10.2015)

Integration with composer installers

New console commands

2.0.3 (11.05.2015)

Module publication, festive date :)

USER EXPERIENCE

Solution reviews

How does this solution work in a real project? Share your experience and help others choose.

Be the first to share your experience

There are no reviews of this solution on git.ru yet. Tell us what worked well and what could be improved.

Verified purchaseAdd a key if you wish. A verified review gets a badge, priority placement and more rating weight.

Open to every clientJust sign in to your account. A key is optional; all reviews are moderated.

YOUR EXPERIENCE MATTERS

Your review

YOUR PROJECT INFRASTRUCTURE

A home for your website

BEFORE YOU ORDER

Let’s go through the details.

Is installation free?
The solution itself is free. Installation, configuration and customisation services are agreed separately. A compatible platform and an appropriate platform licence are required.
How do I check compatibility?
Compare the supported editions and solution version in the technical details with your project. Before installing on a live website, we recommend making a backup and checking the solution in a test environment.
Can you help with implementation?
We can help install the module, check its settings and verify how it works in your project. Compatibility with other customisations and the scope of work are assessed before we begin.

GENERAL iT

Let’s discuss your project

Получатель: ООО «Дженерал Ай Ти Рус»

1C-BITRIX

Install solution

Enter a domain with or without https://. The installer will open in your website control panel in a new tab.

Solution screenshots

Solution screenshot