resources

In Rails, a resourceful route provides a mapping between HTTP verbs and URLs and controller actions. By convention, each action also maps to particular CRUD operations in a database. A single entry in the routing file, such as

creates seven different routes in your application, all mapping to the Photos controller:

Resources can also be nested infinitely by using this block syntax:

This generates the following comments routes:

Options

Takes same options as Base#match as well as:

:path_names

Allows you to change the segment component of the edit and new actions. Actions not specified are not changed.

1	resources :posts, path_names: { new: "brand_new" }

The above example will now change /posts/new to /posts/brand_new

:path

Allows you to change the path prefix for the resource.

1	resources :posts, path: 'postings'

The resource and all segments will now route to /postings instead of /posts

:only

Only generate routes for the given actions.

1 2	resources :cows, only: :show resources :cows, only: [:show, :index]

:except

Generate all routes except for the given actions.

1 2	resources :cows, except: :show resources :cows, except: [:show, :index]

:shallow

Generates shallow routes for nested resource(s). When placed on a parent resource, generates shallow routes for all nested resources.

1 2 3

resources :posts, shallow: true do   resources :comments end

Is the same as:

1 2 3 4

resources :posts do   resources :comments, except: [:show, :edit, :update, :destroy] end resources :comments, only: [:show, :edit, :update, :destroy]

This allows URLs for resources that otherwise would be deeply nested such as a comment on a blog post like /posts/a-long-permalink/comments/1234 to be shortened to just /comments/1234.

:shallow_path

Prefixes nested shallow routes with the specified path.

1 2 3 4 5

scope shallow_path: "sekret" do   resources :posts do     resources :comments, shallow: true   end end

The comments resource here will have the following routes generated for it:

1 2 3 4 5 6 7

post_comments    GET       /posts/:post_id/comments(.:format) post_comments    POST      /posts/:post_id/comments(.:format) new_post_comment GET       /posts/:post_id/comments/new(.:format) edit_comment     GET       /sekret/comments/:id/edit(.:format) comment          GET       /sekret/comments/:id(.:format) comment          PATCH/PUT /sekret/comments/:id(.:format) comment          DELETE    /sekret/comments/:id(.:format)

:shallow_prefix

Prefixes nested shallow route names with specified prefix.

1 2 3 4 5

scope shallow_prefix: "sekret" do   resources :posts do     resources :comments, shallow: true   end end

The comments resource here will have the following routes generated for it:

1 2 3 4 5 6 7

post_comments           GET       /posts/:post_id/comments(.:format) post_comments           POST      /posts/:post_id/comments(.:format) new_post_comment        GET       /posts/:post_id/comments/new(.:format) edit_sekret_comment     GET       /comments/:id/edit(.:format) sekret_comment          GET       /comments/:id(.:format) sekret_comment          PATCH/PUT /comments/:id(.:format) sekret_comment          DELETE    /comments/:id(.:format)

:format

Allows you to specify the default value for optional format segment or disable it by supplying false.

Examples