I have a file called .aliases for bash and zsh, I put this line

# vim: set filetype=bash: 

but if I make

: echo &ft

I get conf

  • I've tried everything here and nothing has worked. I've been using vim for 18 years. This is the first time I've failed to get modeline to work. – Bruno Bronosky Feb 2 '17 at 3:16
  • Figured it out. Answer below. superuser.com/a/1174296/3376 – Bruno Bronosky Feb 2 '17 at 4:12

That should work. I tried that line myself and it worked. I could be that your 'modeline' option got set to 'nomodeline'. Try executing this and see what you get.

:verbose set modeline?

That will tell you the value of the 'modeline' option and if not the default, where it was last set.

Some Linux distributions set 'nomodeline' in /etc/vimrc or /usr/share/vim/vimrc as a security measure, even though the security problems with 'modeline' have long been fixed.

  • modeline Last set from ~/.vimrc – juanpablo Aug 16 '11 at 5:06
  • for security, I change the modeline to add this to my ~/.vimrc au BufNewFile,BufRead .*aliases set filetype=sh – juanpablo Aug 16 '11 at 5:24
  • Not all of them have been long fixed. github.com/numirias/security/blob/master/doc/… – duckbrain Jun 14 at 21:44
  • @duckbrain It is fundamentally impossible to guarantee that all security issues have ever been fixed so long as it is ever possible to include embedded instructions to be executed by the code looking at the data in the very data itself. This is why the documentation for Keith Bostic's nvi has always said of modelines that the option is UNimplemented and that it never will be. This is just like all the security bugs stemming from file-embedded commands or macro instructions to run in PDF, Word, Excel, &c&c&c. – tchrist Jun 17 at 19:16

I describe a full debug checklist in this other answer.

I was REALLY stumped on this one because the documentation is not entirely true.

It turns out that in version 8 (and maybe earlier) you cannot use the word set in your modeline. The documentation describes "the second form" as being /* vim: set ai tw=75: */ but this does not work. You have to use "the first form" // vim: ai tw=75

Note: You can use either of those kinds of comment indicators. Or none at all.

  • This is not necessarily true for all vim installs. The form with set works fine for me on vim 8.0 (although not on 7.4). Also worth noting that with the second form // vim: ai tw=75, there cannot be any other characters at the end of the line, or vim will complain and ignore the modeline. – Josh Apr 12 '17 at 15:56
  • This should be definitely reported as a bug (or as outdated documentations). I reproduced on VIM - Vi IMproved 7.4 (2013 Aug 10, compiled Nov 24 2016 16:44:48) Inklusive der Korrekturen: 1-1689 Extra-Patches: 8.0.0056 Verändert von pkg-vim-maintainers@lists.alioth.debian.org Übersetzt von pkg-vim-maintainers@lists.alioth.debian.org Riesige Version mit GTK2-GNOME GUI. (The last lines mean modified by ..., compiled by ..., huge version ...). – LittleByBlue Sep 10 '17 at 8:36
  • I tried to address it on the mailing list. They disagreed. – Bruno Bronosky Sep 11 '17 at 21:03
  • @BrunoBronosky do you have link to the mail thread? Would like to read their reasoning. – graywolf Sep 15 '17 at 12:37
  • Here is a link to the thread. groups.google.com/d/msg/vim_dev/aFh3X0etB7c/zl0Vi-MuFQAJ I didn't really take the time to understand their reasoning. – Bruno Bronosky Oct 30 '17 at 23:40

set modelines=1 (or any non-0 value) in my ~/.vimrc got it working for me.

  • 5
    This has no effect if modeline is not also set (which it is by default in Vim unless you're root) – kynan Sep 5 '13 at 12:10
  • Gentoo has a system-wide set nomodeline in /etc/vimrc due to all the vulnerabilities with modelines handling in vim. – MattBianco May 23 '14 at 13:43
  • In my case, I also had to set modelines to a non-zero value. The help says the default is 5, so that's what I set it to and that did the trick for me. The states that, If 'modeline' is on 'modelines' gives the number of lines that is checked for set commands. If 'modeline' is off or 'modelines' is zero no lines are checked. – Ben Jun 10 '16 at 15:59

in ~/.vimrc you need to set following:

set nocompatible 
filetype plugin on
set modeline 
  • Those lines work in Debian 9. Thank you! – caligari Jun 14 '18 at 7:13

Adding just the following to my ~/.vimrc worked for me on my Funtoo Linux box:

set modeline
  • Does not work in mac ! – shuva Jan 5 '18 at 14:59

Since this seems to come up in searches:

I had the same problem:

# vim: set filetype=sh:

didn't work, resulting in ft=conf as well. without the modeline in my ~/.bash_alias, ft is empty, so something changes.


# vim: filetype=sh:

worked. the last ":" presence seems to be irrelevant.

I'm on OSX with a Vim8 brewed version, for the records.

it's weird because from the modeline help both



[text]{white}{vi:|vim:|Vim:|ex:}[white]se[t] {options}:[text]

seem to be supported.

The output of

verbose set ft?

with "vim:filetype=sh" is

      Last set from modeline

without modeline:


with "vim:set filetype=sh"

     Last set from /usr/local/Cellar/vim/8.0.1350/share/vim/vim80/filetype.vim

There might be a side effect somewhere in my conf, but the non compatible modeline syntax is the only one that works as expected for me.


/usr/share/vim/vim80/debian.vim from vim-common on Debian-based distros disables modeline by default.

" modelines have historically been a source of security/resource
" vulnerabilities -- disable by default, even when 'nocompatible' is set
set nomodeline

You have to enable modeline explicitly in your .vimrc or ~/.vim/vimrc file.

set modeline

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.