Table of contents

Change an organisation's slug

NOTE: for Worldwide Organisations, only Steps 1 and maybe 4 below need to be performed.

The organisation slug is used as a foreign key for organisations across lots of apps. Changing it can be complex and time consuming.

1) Change the organisation’s slug in Whitehall

Create a data migration that uses the DataHygiene::OrganisationReslugger class, see this PR for an example.

2) Update the organisation in Transition/transition-config:

The transition-config repo may contain slugs. Change any references to the old slug:

3) Update the organisation slug in Manuals Publisher


Find out if any manuals are published by this organisation.

Run the following in manuals-publisher Rails console:

ManualRecord.where(organisation_slug: "old-slug").exists?

If there are, create a migration to update the slugs. Republish all affected manuals after deploying your change.

4) Update any best-bet searches in Search Admin

This page is owned by #2ndline and needs to be reviewed