Skip to main content
Table of contents

Transition

Remove a site from the Transition tool

Sometimes we get requests to delete sites from the Transition tool.

1. Remove site config YAML files

Sites that appear in the Transition tool are configured in YAML in the alphagov/transition-config repo. To remove one, git rm it from the data/transition-sites directory. There's some prior art.

2. Run rake task

Once your changes have been merged, run the import:revert:sites[site_abbr] Rake on the Transition app with the site abbreviation that you want to delete. This task will only work for sites with zero mappings and zero hits - i.e. no associated data beyond that which was created by importing the site YAML file. It triggers the transition_load_site_config Jenkins job to update the Transition tool's loaded site config.

To remove a redirect with existing mappings or hits, use the import:revert_entirely_unsafe[site_abbr] Rake task.

3. Check that the site is no longer recognised by the Transition tool

When all caches have cleared, the host will not appear in hosts.json.

This page was last reviewed on 17 August 2020. It needs to be reviewed again on 17 August 2021 by the page owner #govuk-developers .
This page was set to be reviewed before 17 August 2021 by the page owner #govuk-developers. This might mean the content is out of date.