Home

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: [email protected]
2. ID: 6, login: barry, first name: Rosie, Last name: Barry, Display name: Rosie Barry, email: [email protected]

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