Shortcodes

Display Asana tasks on your website to improve work transparency and collaboration—while reducing users within your Asana workspace.

Table of Contents

1. [ptc_asana_project]
   1. Attributes
      1. Project Display
      2. Tasks Display
      3. Configuration
   2. Quick Copy (with default values)
2. [ptc_asana_project_list]
   1. Attributes
   2. Quick Copy (with default values)
3. [ptc_asana_task]
   1. Attributes
      1. Display
      2. Configuration
   2. Quick Copy (with default values)

---

[ptc_asana_project]

Displays Asana project information and tasks.

Only “list” layout is displayed in the free version of Completionist. Additional layouts such as “calendar” and “board” are available to Completionist Pro users only.

Attributes

Project Display

Attribute	Value Type	Required?	Description
src	URL	Required	The Asana project link. When viewing a project in Asana, copy the URL in the web browser address bar (eg. https://app.asana.com/0/12345729186/12345167991) or the URL from clicking “Copy project link” in the project’s detail dropdown.
include_sections	CSV (Comma-Separated Values)	Optional. Default “” (empty) to include all sections within the Asana project.	A comma-separated list of the names of the Asana project sections to include for display. All non-matching sections will be excluded. Included sections may be excluded by exclude_sections if specified. Note that HTML entities are encoded to keep compatibility with the WordPress Block Editor. For example, include_sections="Design & Development" will include project sections named Design & Development.
exclude_sections	CSV (Comma-Separated Values)	Optional. Default “” (empty) to display all sections within the Asana project.	A comma-separated list of the names of the Asana project sections to exclude from display. Applies after include_sections to guarantee the specified sections are excluded. Note that HTML entities are encoded to keep compatibility with the WordPress Block Editor. For example, exclude_sections="Design & Development" will exclude project sections named Design & Development.
show_name	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide the project’s name.
show_description	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide the project’s description.
show_status	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide the project’s current status update and completion status.
show_modified	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide the project’s last modified date and time.
show_due	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide the project’s due date.

Tasks Display

Attribute	Value Type	Required?	Description
layout	Choice of list, calendar, or board	Optional. Default “list”.	The layout for displaying tasks. Only “list” is supported for free users. ⭐️ Pro users can display an Asana project in calendar layout. ⭐️ Pro users can display an Asana project in board (aka Kanban) layout.
show_tasks_description	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ descriptions.
show_tasks_assignee	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ assignee.
show_tasks_subtasks	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ subtasks. Note that only the immediate subtasks are ever displayed. Subtasks of subtasks are never displayed.
show_tasks_completed	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide completed tasks. If enabled, completed tasks will be shown (if any) and all “checkmark bubbles” will be displayed.
show_tasks_due	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ due dates.
show_tasks_attachments	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ additional attachments. Inline attachments and embeds in the tasks’ descriptions are always displayed if show_tasks_description="true". The following image file extensions are supported: jpg, jpeg, png, bmp, gif The following video file extensions are supported: mp4 The following document file extensions are supported: pdf
show_tasks_tags	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ tags.
show_tasks_comments ⭐️ Pro users	Boolean (true/false)	Optional. Default “false”.	Set to “true” to display tasks’ comments. This feature is available to ⭐️ Pro users only.
sort_tasks_by	Any top-level string, number, or object Asana task field.	Optional. Default “” to use unsorted (manual) ordering.	Common sorting examples include: assignee - Sort tasks by their assignee’s name completed - Sort tasks by “completed” status and then alphabetically by their title completed_at - Sort tasks by when they were marked “completed” due_on - Sort tasks by their due date name - Sort tasks by their title

Configuration

Attribute	Value Type	Required?	Description
auth_user	WordPress user ID	Optional. Defaults to the Frontend Authentication User saved in Completionist’s settings.	A WordPress user’s ID to authenticate the Asana API requests. The WordPress user must be connected to Asana via Completionist in wp-admin, or you may see a 401 Unauthorized error on your website.

Quick Copy (with default values)

[ptc_asana_project src="<ASANA_PROJECT_URL>" layout="list" auth_user="" include_sections="" exclude_sections="" show_name="true" show_description="true" show_status="true" show_modified="true" show_due="true" show_tasks_description="true" show_tasks_assignee="true" show_tasks_subtasks="true" show_tasks_completed="true" show_tasks_due="true" show_tasks_attachments="true" show_tasks_tags="true" show_tasks_comments="false" sort_tasks_by="" /]

**Remember to change the src attribute value to the URL of the Asana project that you’d like to display!

[ptc_asana_project_list]

Displays a WordPress user’s associated Asana projects’ information and tasks.

To select which Asana projects to display, navigate to Users and click “Edit” to edit a WordPress user’s profile information. You can then find the “Asana Projects” setting to select which Asana projects the WordPress user is allowed to view. Note that you must have the edit_posts capability and connected your Asana account to update this setting.

⭐️ This shortcode is available to Completionist Pro users only.

Attributes

This shortcode shares the same attributes as the singular [ptc_asana_project] shortcode, plus the following:

Attribute	Value Type	Required?	Description
user	WordPress user ID	Optional. Default “” (empty) to use the currently logged-in user for dynamic, personalized display.	A WordPress user’s ID to determine which Asana projects to list. See the “Asana Projects” setting in the WordPress user’s profile to select which Asana projects the WordPress user is allowed to view.

Quick Copy (with default values)

[ptc_asana_project_list layout="list" user="" auth_user="" exclude_sections="" show_name="true" show_description="true" show_status="true" show_modified="true" show_due="true" show_tasks_description="true" show_tasks_assignee="true" show_tasks_subtasks="true" show_tasks_completed="true" show_tasks_due="true" show_tasks_attachments="true" show_tasks_tags="true" show_tasks_comments="false" sort_tasks_by="" /]

[ptc_asana_task]

Displays an Asana task.

Attributes

Display

Attribute	Value Type	Required?	Description
src	URL	Required	The Asana task link. When viewing a project in Asana, right-click the task and select “Copy task link” from the context menu. When viewing a task, click the chainlink in the top bar which says “Copy task link” on hover.
show_description	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ descriptions.
show_assignee	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ assignee.
show_subtasks	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ subtasks. Note that only the immediate subtasks are ever displayed. Subtasks of subtasks are never displayed.
show_completed	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide completed tasks. If enabled, completed tasks will be shown (if any) and all “checkmark bubbles” will be displayed.
show_due	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ due dates.
show_attachments	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ additional attachments. Inline attachments and embeds in the tasks’ descriptions are always displayed if show_tasks_description="true". The following image file extensions are supported: jpg, jpeg, png, bmp, gif The following video file extensions are supported: mp4 The following document file extensions are supported: pdf
show_tags	Boolean (true/false)	Optional. Default “true”.	Set to “false” to hide tasks’ tags.
sort_subtasks_by	Any top-level string, number, or object Asana task field.	Optional. Default “” to use unsorted (manual) ordering.	Common sorting examples include: assignee - Sort subtasks by their assignee’s name completed - Sort subtasks by “completed” status and then alphabetically by their title completed_at - Sort subtasks by when they were marked “completed” due_on - Sort subtasks by their due date name - Sort subtasks by their title

Configuration

Attribute	Value Type	Required?	Description
auth_user	WordPress user ID	Optional. Defaults to the Frontend Authentication User saved in Completionist’s settings.	A WordPress user’s ID to authenticate the Asana API requests. The WordPress user must be connected to Asana via Completionist in wp-admin, or you may see a 401 Unauthorized error on your website.

Quick Copy (with default values)

[ptc_asana_task src="<ASANA_TASK_LINK>" auth_user="" show_description="true" show_assignee="true" show_subtasks="true" show_completed="true" show_due="true" show_attachments="true" show_tags="true" sort_subtasks_by="" /]

**Remember to change the src attribute value to the URL of the Asana task that you’d like to display!