Hello there - as a plugin used in our Discourse instance is no longer updates (Multilingual), and some of its features are supported in the newer versions of Discourse, we wished to use a migration script in order to move values in the database to new places. However, while researching the wiki articles from this site, or the git repository of Discourse, I haven’t found any documentation to write a migration script (what class to inherit, what methods to use…) Is there any documentation which I missed ? Aside from looking at migration code, is there any tips to acknowledge myself around migration scripts ? Ty in advance!

These are just standard Rails migrations. Take a look at: [image] Active Record Migrations — Ruby on Rails Guides Migrations are a feature of Active Record that allows you to evolve your database schema over time. Rather than write schema modifications in pure SQL, migrations allow you to use a Ruby Domain Specific Language (DSL) to describe changes to your... If you are going to add some, recommend you do this in a plugin, not fork core :slight_smile:

When I had content to migrate from a platform with no available Discourse script, I had no luck finding real documentation about these things. Existing scripts were beyond me to reverse-engineer. I ended up manually importing a topic at a time via the Rails console – not very scalable. If I’d had a bigger project (and a budget) I’d have probably have contracted @pfaffman for his migration service.

[image] Honeyxilia: Hello there - as a plugin used in our Discourse instance is no longer updates (Multilingual), and some of its features are supported in the newer versions of Discourse, we wished to use a migration script in order to move values in the database to new places. What are you trying to do? If you’re still by to use discourse then it’s not a migration. What do you want to move where? If you just want to move to an up to date discourse then you can likely just remove the plugin and upgrade. If you’re not using Discourse anymore then it’s not a Discourse migration script you want.

Honeyxilia, the way I read your question, it sounds like you did a bunch of work with the Pavilion Multilingual Plugin and would like to “migrate” that data to the newer Discourse Content Localization features. Is that right? (I’m not sure where I’d start with that either.)

What I mean by migration script is the database migration scripts ( db/migrate ) inheriting from ActiveRecord::Migration which are used to adapt the database to the Discourse changes. For instance, we have the SQL commands to transfer a Multilingual-plugin locale into a native Discourse locale. My question would be mostly about the database migrate scripts, in order to automate the SQL commands when migrating the database to a newer version

I changed the title of the topic to precise what I meant

Database migration script documentation

Development

merefield (Robert) October 23, 2025, 2:04pm 7

These are just standard Rails migrations. Take a look at:

If you are going to add some, recommend you do this in a plugin, not fork core

Topic		Replies	Views
How to create migration files? Development	6	2571	August 22, 2016
Database migrations and git flow Development	7	1977	February 21, 2018
Seeking help for migrating from Discuz 3.4 to Discourse Marketplace	2	559	December 6, 2023
How to properly alter the database? Development	7	2755	April 11, 2017
How to best bulk import posts if unable to use sample Ruby scripts? Migration	6	667	April 3, 2020

Database migration script documentation

Related topics