Skip to main content
Version: 7.x

useLinkTo

The useLinkTo hook lets us navigate to a screen using a path instead of a screen name based on the linking options. It returns a function that receives the path to navigate to.

import { useLinkTo } from '@react-navigation/native';

// ...

function Home() {
const linkTo = useLinkTo();

return (
<Button onPress={() => linkTo('/profile/jane')}>
Go to Jane's profile
</Button>
);
}

This is a low-level hook used to build more complex behavior on top. We recommended using the useLinkProps hook to build your custom link components instead of using this hook directly. It will ensure that your component is properly accessible on the web.

warning

Navigating via href strings is not type-safe. If you want to navigate to a screen with type-safety, it's recommended to use screen names directly.

Using with class component‚Äč

You can wrap your class component in a function component to use the hook:

class Home extends React.Component {
render() {
// Get it from props
const { linkTo } = this.props;
}
}

// Wrap and export
export default function (props) {
const linkTo = useLinkTo();

return <Profile {...props} linkTo={linkTo} />;
}