Forms to raise Zendesk tickets to be used by Government personnel on GOV.UK
Ruby HTML CSS Other
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
app Change text for campaign support form Apr 10, 2018
config Remove deprecated ActiveSupport option Apr 17, 2018
lib Autocorrects by linter May 25, 2017
log Initial import Oct 16, 2012
public Remove an old copy of jquery from public/javascripts Mar 1, 2018
script adding cucumber test for the general request form Nov 16, 2012
spec Do not normalise whitespace Apr 16, 2018
.gitignore Bump to rails 5.0.2 May 24, 2017
.rspec Add rspec 3.0.1 Jun 10, 2014
.rubocop.yml Manually fix ruby linter issues not automaticaly fixed Sep 7, 2017
.ruby-version Update .ruby-version to 2.4.4 Apr 10, 2018
Gemfile Bump rails from 5.1.6 to 5.2.0 Apr 16, 2018
Gemfile.lock Bump rails from 5.1.6 to 5.2.0 Apr 16, 2018
Jenkinsfile Update Jenkinsfile to use external library Mar 2, 2018
LICENCE Add a LICENCE Jul 25, 2016
Procfile Add Procfile to allow using the govuk_procfile_worker Jun 23, 2014 Improve README Nov 21, 2017
Rakefile Remove ci_reporter_rspec gem Mar 1, 2018 Initial import Oct 16, 2012 Add May 23, 2014


Forms that create tickets for requests coming from government agencies or from GOV.UK contact forms.


  • Feedback: All the data received from contact forms is considered to be "feedback" of some form or other and relates to pages published on GOV.UK.
  • Anonymous Contact: Part of the feedback collected by this app is anonymous, when it's submitted via an anonymous contact form in the [feedback app][feedback].
  • Named Contact: In contrast with the Anonymous Contact feedback, this is submitted via a form that will require you to identify yourself. This data is sent directly to the support app.

Technical documentation

This is a Ruby on Rails application which collects feedback and creates tickets based on it. It collects data from two sources:

  • its own forms which can be accessed by [signon][signon] users
  • contact forms from the [feedback app][feedback]

The data collected from either the feedback app or its own forms is then used to create and submit Zendesk tickets.

Even though it is not public facing, the support app does receive data from the [feedback app][feedback], which collects data via contact forms rendered on GOV.UK.

Types of requests from the Support app forms

The support app lets people who use the GOV.UK publishing tools ask for specific help from the GOV.UK team.

The types of forms and their purpose are listed below:

  • "Content advice and help": Asking for help or advice on any content problems. Request short URLs, topical event pages, groups or manuals
  • "Content changes and new content requests": Request changes to GOV.UK content managed by GDS content designers
  • "Unpublish content": Request to unpublish content
  • "Changes to publishing applications or technical advice": Request for changes or new features for any publishing applications or ask for technical advice. Also used for transitioning new sites to GOV.UK.
  • "Report a technical fault to GDS": report something that is not working with any publishing application, eg Whitehall, finders or specialist publisher. Also used for urgent technical changes.
  • "Accounts, permissions and training": Request a new account, change an account or unlock an account
  • "Remove user": Request to remove user access
  • "Request a new campaign": Request GDS supoort for a new campaign
  • "Support for live campaign": Request GDS support for a live campaign
  • "Add a topic": For requesting new topics in the education or parenting and childcare taxonomies
  • "Change or remove a topic": For requesting changes to topics from the education or parenting and childcare taxonomies
  • "Analytics access, reports and help": Request access to Google Analytics or help with analytics and reports
  • "General": Report a problem, request GDS support, or make a suggestion
  • "Feedback explorer": GOV.UK Anonymous Feedback
  • "Emergency contact details": Contact GOV.UK in an emergency

Feedback explorer

At the bottom of every page on GOV.UK we ask: “Is there anything wrong with this page?”. Users can leave comments on what they were doing and what went wrong. Feedback is anonymous and is collected via the feedback app.

The Feedback explorer in the support app allows users to browse the feedback submitted from GOV.UK pages, and to export CSVs of the same for further analysis.


Currently we use Zendesk to register our support tickets, via the gds_zendesk gem which is a wrapper around the Zendesk API.


  • alphagov/support-api - provides an API for storing and fetching anonymous feedback about pages on GOV.UK.

Running the application

To start the app using bowler:

bowl support

To start the app directly:


This will start the app on port 3031.

Default url for development:, for production:

Running the test suite

To run the specs, execute:

bundle exec rake

Starting the background processing queues

Zendesk tickets are raised in the background using a redis-backed queue called sidekiq.

To start the background workers:

rake jobs:work