Skip to content
Piotr Pelczar edited this page Aug 25, 2018 · 2 revisions

Supported ACF Fields

Examples below assumes that field name is Some field.

Text fields

Case Situation Result
Simple value Value: Some value
Permalink structure: /%field_some_field%/
/some-value/

Checkbox

Case Situation Result
Single value selected Selected values: Red
Permalink structure: /%field_some_field%/
/red/
Multiple values selected Selected values: Red, Light blue
Permalink structure: /%field_some_field%/
/red-light-blue/
Custom values separator Selected values: Red, Light blue
Permalink structure: /%field_some_field(separator='-and-')%/
/red-and-light-blue/
Use choices labels Selected values: color1 (label: Red), color2 (label: Light blue)
Permalink structure: /%field_some_field%/
/red-light-blue/

Radio

Case Situation Result
Single value selected Selected value: Red
Permalink structure: /%field_some_field%/
/red/
Use choices labels Selected value: color1 (label: Red)
Permalink structure: /%field_some_field%/
/red/

Date Picker

Case Situation Result
Default format Selected value: 3/1/2018
Permalink structure: /%field_some_field%/
/2018-03-01/
Custom date format Selected value: 3/1/2018
Permalink structure: /%field_some_field(format=d-m-y)%/
Date format documentation: http://php.net/manual/en/function.date.php
/01-03-2018/
Year only Selected value: 3/1/2018
Permalink structure: /%field_some_field(year)%/
/2018/
Month only Selected value: 3/1/2018
Permalink structure: /%field_some_field(month)%/
/03/
Day only Selected value: 3/1/2018
Permalink structure: /%field_some_field(day)%/
/01/

Post Object, Page Link

Case Situation Result
Single value selected Selected post: ID: 5, Post title: Some referenced post title
Permalink structure: /%field_some_field%/
/some-referenced-post-title/
Multiple values selected Selected posts: ID: 5, 6, Post titles: First page, Second Page
Permalink structure: /%field_some_field%/
/first-page-second-page/
Custom values separator Selected posts: ID: 5, 6, Post titles: First page, Second Page
Permalink structure: /%field_some_field(separator='-and-')%/
/first-page-and-second-page/

Note: Always post title is displayed.

User

Given two users:

  1. ID: 5, login: tgiovani, first name: Tom, Last name: Giovani, Display name: Tom Giovani, email: tom.giovani@example.com
  2. ID: 6, login: barry, first name: Rosie, Last name: Barry, Display name: Rosie Barry, email: rossie.barry@example.com
Case Situation Result
Single value selected Selected user: ID: 5
Permalink structure: /%field_some_field%/
/tgiovani/
Multiple values selected Selected users: ID: 5, 6
Permalink structure: /%field_some_field%/
/tgiovani-barry/
Custom values separator Selected users: ID: 5, 6, User names: user5, user6
Permalink structure: /%field_some_field%/
/tgiovani-and-barry/
Custom format - Display name Selected user: ID: 5
Permalink structure: /%field_some_field(format=displayname)%/
/tom-giovani/
Custom format - First name Selected user: ID: 5
Permalink structure: /%field_some_field(format=firstname)%/
/tom/
Custom format - Last name Selected user: ID: 5
Permalink structure: /%field_some_field(format=lastname)%/
/giovani/
Custom format - First name and Last name Selected user: ID: 5
Permalink structure: /%field_some_field(format=firstname-lastname)%/
/tom-giovani/
Custom format - Email Selected user: ID: 5
Permalink structure: /%field_some_field(format=email)%/
/tom-giovani-at-example-com/

Custom format tokens:

  • login
  • nicename
  • firstname
  • lastname
  • displayname
  • email
Clone this wiki locally