What %w Means in Ruby: Array of Strings Syntax Explained

By the end of this page, you will understand that %w(...) is Ruby shorthand for creating an array of strings. You will see how it works, why it is useful, how it differs from normal array syntax, and when to use %w versus other similar Ruby literals.

In Ruby, %w(...) is a special literal syntax for creating an array of strings.

This line:

%w(cgi.rb complex.rb date.rb)

is roughly the same as writing:

["cgi.rb", "complex.rb", "date.rb"]

Ruby splits the contents inside %w(...) by whitespace and turns each item into a string.

So this code:

FileUtils.cp %w(cgi.rb complex.rb date.rb), '/usr/lib/ruby/1.6'

means:

FileUtils.cp(["cgi.rb", "complex.rb", "date.rb"], '/usr/lib/ruby/1.6')

Why Ruby has this syntax

Ruby includes several literal shortcuts to make common code shorter and easier to read. %w is useful when:

• you need a list of simple strings
• the strings do not need interpolation
• you want to avoid typing lots of quotes and commas

For example, this:

Think of %w(...) as a quick packing list.

Instead of writing each label separately with quotes and commas:

["shirt", "shoes", "hat"]

you give Ruby one space-separated list:

%w(shirt shoes hat)

Ruby reads the list, splits it at spaces, and packs each word into its own string.

So %w(...) is like saying:

• "Here is a list of words"
• "Please turn each one into a string"
• "Put them all into an array"

Basic syntax

%w(item1 item2 item3)

This creates an array of strings:

["item1", "item2", "item3"]

Example 1: Simple list

files = %w(cgi.rb complex.rb date.rb)
p files

Output:

["cgi.rb", "complex.rb", "date.rb"]

Example 2: Equivalent normal syntax

files = ["cgi.rb", "complex.rb", "date.rb"]

This is functionally the same as:

files = %w(cgi.rb complex.rb date.rb)

Example 3: Different delimiters

Ruby lets you use delimiters other than parentheses.

%w[apple banana orange]
%w|apple banana orange|
%w{apple banana orange}

Consider this code:

files = %w(cgi.rb complex.rb date.rb)
p files

Here is what happens step by step:

1. Ruby sees %w(...) and recognizes it as an array-of-strings literal.
2. Ruby reads the contents inside the delimiters:
   • cgi.rb
   • complex.rb
   • date.rb
3. Ruby splits the contents on whitespace.
4. Each piece becomes a string.
5. Ruby builds the array:

["cgi.rb", "complex.rb", "date.rb"]

1. The variable files now refers to that array.
2. p files prints the array.

Now apply that to the original example:

FileUtils.cp %w(cgi.rb complex.rb date.rb), '/usr/lib/ruby/1.6'

Ruby evaluates %w(cgi.rb complex.rb date.rb) first, producing:

%w appears often in real Ruby code when developers need a short list of fixed strings.

Common examples

File names

files = %w(app.rb config.rb Gemfile)

Allowed values

VALID_STATUSES = %w(pending active archived)

Command-line options

flags = %w(--help --version --verbose)

Model attributes or keys

fields = %w(name email role)

Test data

users = %w(alice bob charlie)

Why developers use it

• less punctuation to type
• easier to scan visually
• good for fixed lists of simple string values
• common in configuration-style Ruby code

In real projects, %w is usually used for static lists that are known ahead of time.

Common patterns

Constants

ALLOWED_EXTENSIONS = %w(.jpg .png .gif)

This is common when validating user input.

Guard clauses

def valid_role?(role)
  return false unless %w(admin editor viewer).include?(role)

  true
end

A fixed list of allowed values is easy to read with %w.

Filtering

visible_columns = %w(name email created_at)
records.map { |record| record.slice(*visible_columns) }

Configuration

ignored_dirs = %w(tmp log node_modules)

Test suites

1. Expecting interpolation to work

Broken example:

name = "Ruby"
p %w(hello #{name})

This does not produce "Ruby".

Result:

["hello", "\#{name}"]

Use %W instead:

name = "Ruby"
p %W(hello #{name})

2. Forgetting that spaces split items

Broken example:

cities = %w(New York London)

Result:

["New", "York", "London"]

If you want "New York" as one item, escape the space:

cities = %w(New\ York London)

%w compared with related Ruby syntax

Quick reference

Create an array of strings

%w(a b c)
# => ["a", "b", "c"]

Equivalent syntax

["a", "b", "c"]

Different delimiters

%w(a b c)
%w[a b c]
%w{a b c}
%w|a b c|

Interpolation

%w(hello #{name})  # no interpolation
%W(hello #{name})  # interpolation works

Spaces inside one item

%w(New\ York Los\ Angeles)
# => ["New York", "Los Angeles"]

Best use case

• short, fixed lists of plain strings

Avoid when

• strings contain many spaces
• you need variables inside strings
• readability is better with explicit quotes

Where is %w documented in Ruby?

It is documented as part of Ruby's percent-literal syntax, often described under string and array literals. Search for Ruby %w or Ruby percent literals in the official syntax documentation.

Is %w the same as an array?

It creates an array, specifically an array of strings.

Can %w contain numbers?

Yes, but they become strings:

%w(1 2 3)
# => ["1", "2", "3"]

What is the difference between %w and %W in Ruby?

%w does not process interpolation. %W does.

Can I use commas inside %w?

You usually separate items with spaces, not commas. If you include commas, they become part of the strings.

%w(a,b,c)
# => ["a,b,c"]

Why do Ruby developers use %w?

Related Ruby concepts

• Array literals — %w is one way to create arrays.
• String literals — %w produces strings, so it is closely related to string syntax.
• Percent literals — Ruby uses %q, %Q, %w, %W, %i, and similar shortcuts.
• Symbols — %i(...) is similar to %w(...), but creates symbols instead of strings.
• Interpolation — important for understanding why %w and %W behave differently.
• FileUtils — the original example uses %w as an argument to FileUtils.cp.
• Method arguments in Ruby — helpful for understanding how the array is passed into FileUtils.cp.