dev
Viewing docs for dev branch, not the latest release. View latest
Index Query Param

Index Query Param

You may find a wild ?index appear in the URL of your app when submitting forms.

Because of nested routes, multiple routes in your route hierarchy can match the URL. Unlike navigations where all matching route loaders are called to build up the UI, when a form is submitted only one action is called.

Because index routes share the same URL as their parent, the ?index param lets you disambiguate between the two.

For example, consider the following forms:

<Form method="post" action="/projects" />;
<Form method="post" action="/projects?index" />;

The ?index param will submit to the index route, the action without the index param will submit to the parent route.

When a <Form> is rendered in an index route without an action, the ?index param will automatically be appended so that the form posts to the index route. The following form, when submitted, will post to /projects?index because it is rendered in the context of the projects index route:

function ProjectsIndex() {
  return <Form method="post" />;
}

If you moved the code to the ProjectsLayout route, it would instead post to /projects.

This applies to <Form> and all of its cousins:

function Component() {
  const submit = useSubmit();
  submit({}, { action: "/projects" });
  submit({}, { action: "/projects?index" });
}
function Component() {
  const fetcher = useFetcher();
  fetcher.submit({}, { action: "/projects" });
  fetcher.submit({}, { action: "/projects?index" });
  <fetcher.Form action="/projects" />;
  <fetcher.Form action="/projects?index" />;
  <fetcher.Form />; // defaults to the route in context
}
Docs and examples licensed under MIT