I created a custom form in Drupal 8. I remember we can redirect to custom path in Drupal 7 with $form_state['redirect'] = 'mycustompath'; in a submission handler.

How can I achieve the same in Drupal 8?

I know I should use submitForm().

public function submitForm (array &$form, FormStateInterface $form_state) {
   // Redirect users.

In your "submitForm" method write below code


where machine_name is the machine name mentioned in the routing file.

I hope this helps .. :)

  • not work. I try my custom route $form_state->setRedirect('/start');return; , let's suppose I want to redirect to home page. what is exact snippet?
    – Yuseferi
    May 26 '16 at 12:52
  • 1
    $form_state->setRedirect('<front>'); return;
    – parth.k
    May 26 '16 at 12:53
  • 1
    it shouldn't be '/start'. It is the alias mentioned in the routing file.
    – parth.k
    May 26 '16 at 12:54
  • '<front>' worked what you about path alias ? this is my route tcdev.content: path: '/start' defaults: _controller: 'Drupal\tcdev\Controller\TrainingCenterController::content' _title: 'Start Training Center' requirements: _permission: 'access content'
    – Yuseferi
    May 26 '16 at 12:58
  • 1
    It should be $form_state->setRedirect('tcdev.content');
    – parth.k
    May 26 '16 at 12:59

If you want to set at buildform you need to use some routing path like.

use Drupal\Core\Url;

$url = Url::fromRoute('route.path');
  • what is namespace of Url? Url' not found
    – Yuseferi
    May 26 '16 at 13:06
  • should be use Drupal\Core\Url; (without the preceding slash)
    – ummdorian
    Feb 24 '17 at 18:33
  • $form_state->setRedirectUrl($url); can also be used in submitForm(). May 5 '17 at 9:11
  • 1
    Check the API: api.drupal.org/api/drupal/…. setRedirect() just converts the route to a URL first then calls setRedirectUrl().
    – imclean
    Aug 7 '17 at 4:48

If you want to redirect user edit form to the home page or other page follow below code.

First, add-hook - hook_form_alter`

function yourmodulename_form_alter(&$form, FormStateInterface $form_state, $form_id) 
    if ($form_id === 'your form id') {
    $form['actions']['submit']['#submit'][] = 'modulename_user_edit_form_submit';

after adding hook add below function

function modulename_user_edit_form_submit($form,  FormStateInterface &$form_state) {
  global $base_url; //set base path
  $response = new Symfony\Component\HttpFoundation\RedirectResponse($base_url ."/xyz"); //set url

I hope this help.

  • Doesn't this bypass all the submit handlers that should fire after your handler?
    – joekers
    Dec 3 '19 at 13:35
  • 1
    You should have only $form_state->setRedirect() in the form submit so that all the other submit handlers can be processed.
    – joekers
    Dec 3 '19 at 14:09

use Drupal\Core\Url;

// url to redirect
$path = '/my-path';
// query string
$path_param = [
 'abc' => '123',
 'xyz' => '456'
// use below if you have to redirect on your known url
$url = Url::fromUserInput($path, ['query' => $path_param]);
use Drupal\Core\Url;
use Drupal\node\Entity\Node;
use Symfony\Component\HttpFoundation\RedirectResponse;

$redirect_to_thankyou = new RedirectResponse(Url::fromUserInput('/thankyou')->toString());

Works in Drupal 9 - 9.0.7, if you just want to direct to a URL on your site (haven't tested it on external URLs), rather than ponce about with routing.

Put it at the end of your submitForm function in your class that extends FormBase.


This took me a while to figure out, so I thought I'd share.

I wanted to redirect the user to /admin after a custom admin form submission. I could not find the admin route in Google searches.

I grepped all the routing ymls in core:

find -name \*.routing.yml -exec grep -l "path: '/admin'" {} \;

...and found it in ./modules/system/system.routing.yml

  path: '/admin'
    _controller: '\Drupal\system\Controller\SystemController::systemAdminMenuBlockPage'
    _title: 'Administration'
    _permission: 'access administration pages'

So my form redirect is:


Needed a cache clear before it worked.

New contributor
mmrtnt is a new contributor to this site. Take care in asking for clarification, commenting, and answering. Check out our Code of Conduct.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.