Decidim Toggle

decidim-toggle rewrites System → Organizations in the Decidim admin. Instead of one long form, settings are grouped in tabs. The gem ships built-in tabs (name, OmniAuth, SMTP, language, authorizations, security, file upload) and exposes a small API so your decidim-* module can add its own tab.

With this gem you add a tab, plug in your form and command, and read or write configuration per organization through Decidim::Toggle.config_for — no extra tables .

Compare

	Decidim	Decidim Toggle
Update tenant name, host	✅	✅
Advanced configuration	✅	✅
Update SMTP credentials	✅	✅
Configure machine translation	❌	✅
Change locales	❌	✅
Can extend the /system	❌	✅

Get started

Use in your decidim-* gem

Add the dependency in your gemspec:

# decidim-my_module.gemspec
s.add_dependency "decidim-toggle"

Then register a tab in your engine — full steps in Add a settings tab.

Install in a Decidim app (optional)

Add to the Gemfile:

gem "decidim-toggle"

bundle install
rails decidim_toggle:install:migrations
rails db:migrate

Compatibility

Tested on Decidim 0.29. Works on 0.31 as well (same System organization surface and Form/Command contract).

See also

You are…	Read
Building a module tab	Integrate → Add a settings tab
Hacking decidim-toggle	Contribute
Something wrong	GitLab issues