# Hyperref + \url: long URL with dashes won't break

I've discovered a rather weird behaviour of PdfLaTeX. In this example

\documentclass{article}
\begin{document}
\url{http://www.emarketer.com/blog/index.php/quick-stat-smartphone-users-account-38-mobile-phone-users/}
\end{document}


PdfLaTeX won't break the URL and create a too long line. However, if I replace \url with \href like this:

\documentclass{article}
\usepackage{hyperref}
\begin{document}
\href{http://www.emarketer.com/blog/index.php/quick-stat-smartphone-users-account-38-mobile-phone-users/}{http://www.emarketer.com/blog/index.php/quick-stat-smartphone-users-account-38-mobile-phone-users/}
\end{document}


I get the line broken, but the font of the link is not right any more of course (normal instead of texttt). Why doesn't URL break the line at dashes and what could I do to get a nicely typeset line-broken link?

Load the url package explicitly with the hyphens option:

\usepackage[hyphens]{url}
\usepackage{hyperref}


By default, the url package does not consider hyphens as legal break points.

• Incidentally, there's a good reason for the default: if a URI gets broken at a hyphen, the user may not know whether the hyphen is a part of the URI or an artifact of an intrusive H&J routine. Obviously that doesn't apply in the present case of a news story where the URI has lots of hyphens, but I would caution against using the [hyphens] option as a matter of course. – Peter Flynn Oct 5 '15 at 20:46
• @PeterFlynn H&J = HTML & Javascript? For printing, purposes this wouldn't matter then? – mxmlnkn Apr 10 '18 at 6:43
• Hyphenation and Justification, sorry, I should have explained. – Peter Flynn May 1 '18 at 21:48
• my cls already had \RequirePackage{hyperref}, so right before that i added \RequirePackage[hyphens]{url} – Michael Jun 29 '18 at 14:14
• @Michael - For users who aren't allowed to modify the .cls file, a useful recommendation would be to execute \RequirePackage[hyphens]{url} before \documentclass. – Mico Dec 30 '18 at 11:07

The above answer by mhp may not provide a solution when PDFLaTeX complains with "Option clash for package url."

The cause of this may be because of the package hyperref, which also loads the package. If hyperref is loaded before the url package it gives this error, because the url package is then loaded twice with different options: one without and one with hyphens option (this always causes a clash).

If you must load url after hyperref, you can first specify the hyphens option with the PassOptionsToPackage command:

\PassOptionsToPackage{hyphens}{url}
\usepackage{hyperref}
\usepackage{url}


Note that you do not need to provide the hyphens option a second time when loading the url package (or load url explicitly at all).

I noticed that the biblatex package apparently also clashes with url. Therefore, the same goes for biblatex as for hyperref: load url before it or use PassOptionsToPackage.

To moewe and Heilo; I know, I'm sorry and I would have, but as you said, I cannot make comments until a I have a certain 'reputation'. So I will edit my 'answer' to turn it into a real answer. Maybe I shall now collect enough reputation ;-)

Strange, my other post is deleted, and it still advised me to edit that one rather than making a new one! (It also was still visible, in red!)

• This did not work for me I received a different error though: Undefined control sequence. \loadpackage{hyperref} – Whitecat Mar 9 '16 at 21:42
• This no longer works. Hyperref complains about the clash of options with url while it is loading (immediately after loading hyperref.cfg) so the document will never get to the \loadpackage{url} anyway. – Peter Flynn Jan 18 '18 at 22:55
• Did you mean to write \usepackage instead of \loadpackage? – Mico Dec 30 '18 at 11:05
• Aside: It's worth pointing out that the error message "Option clash for package url" does not arise if @mhp's solution is implemented properly. This error message arises only if \usepackage[hyphens]{url} is run after \usepackage{hyperref} -- which is clearly not what mhp recommended. – Mico Dec 30 '18 at 11:11
• A reason for hyperref being already loaded without being obviously notices (and erring out with the option clash message: beamer loads it at \documentclass time! Use the \PassOptionsToPackage command before that and you are fine. – stefanct Jul 11 at 14:08