# Tips and Tricks

# Use command shorthands

PluralKit has a couple of useful command shorthands to reduce the typing:

Original Shorthand
pk;system pk;s
pk;system list pk;s l
pk;system list full pk;s l f
pk;system fronter pk;s f
pk;system fronthistory pk;s fh
pk;system frontpercent pk;s fp
pk;member pk;m
pk;member new pk;m n
pk;group pk;g
pk;group new pk;g n
pk;switch pk;sw
pk;message pk;msg
pk;autoproxy pk;ap
pk;edit pk;e
pk;edit -regex pk;x

# Member list flags

There are a number of option flags that can be added to the pk;system list command.

# Sorting options

Flag Aliases Lists Description
-by-name -bn Member, Group Sort by name (default)
-by-display-name -bdn Member, Group Sort by display name
-by-id -bid Member, Group Sort by ID
-by-message-count -bmc Member Sort by message count (members with the most messages will appear near the top)
-by-created -bc Member, Group Sort by creation date (least recently created will appear near the top)
-by-last-fronted -by-last-front, -by-last-switch, -blf, -bls Member Sort by most recently fronted
-by-last-message -blm, -blp Member Sort by last message time (members who most recently sent a proxied message will appear near the top)
-by-birthday -by-birthdate, -bbd Member Sort by birthday (members whose birthday is in January will appear near the top)
-reverse -rev, -r Member, Group Reverse previously chosen sorting order
-random Member, Group Sort randomly

# Filter options

Flag Aliases Lists Description
-all -a Member, Group Show all members/groups, including private members/groups
-private-only -po Member, Group Only show private members/groups

WARNING

You cannot look up private members or groups of another system.

# Additional fields to include in the search results

Flag Aliases Lists Description
-with-last-switch -with-last-fronted, -with-last-front, -wls, -wlf Member Show each member's last switch date
-with-last-message -with-last-proxy, -wlm, -wlp Member Show each member's last message date
-with-message-count -wmc Member Show each member's message count
-with-created -wc Member, Group Show each item's creation date
-with-avatar -wa, -wi, -ia, -ii, -img Member, Group Show each item's avatar URL
-with-pronouns -wp -wprns Member Show each member's pronouns in the short list (shown by default in full list)
-with-displayname -wdn Member, Group Show each item's displayname
-with-birthday -wbd, -wb Member Show each member's birthday in the short list (shown by default in full list)

# Miscellaneous flags

Command Flag Aliases Description
List commands -search-description -sd Search inside descriptions instead of member/group names
pk;system frontpercent -fronters-only -fo Show the system's frontpercent without the "no fronter" entry
pk;system frontpercent -flat Show "flat" frontpercent - percentages add up to 100%
pk;group <group> frontpercent -fronters-only -fo Show a group's frontpercent without the "no fronter" entry
pk;group <group> frontpercent -flat Show "flat" frontpercent - percentages add up to 100%
pk;group <group> <add/remove> -all -a Add or remove all members from a group.
pk;edit -append -a Append the new content to the old message instead of overwriting it
pk;edit -prepend -p Prepend the new content to the old message instead of overwriting it
pk;edit -nospace -ns Append/prepend without adding a space
pk;edit -clear-embed -ce Remove embeds from a message
pk;edit -clear-attachments -ca Remove attachments from a message
pk;edit -regex -x Edit using a C# Regex formatted like s|X|Y or s|X|Y|F, where | is any character, X is a Regex, Y is a substitution string, and F is a set of Regex flags
pk;switch edit and pk;switch add -append -a Append members to the current switch or make a new switch with members appended
pk;switch edit and pk;switch add -prepend -p Prepend members to the current switch or make a new switch with members prepended
pk;switch edit and pk;switch add -first -f Move member to the front of the current switch or make a new switch with the member at the front
pk;switch edit and pk;switch add -remove -r Remove members from the current switch or make a new switch with members removed
Most commands -all -a Show hidden/private information
Most commands -raw -r Show text with formatting, for easier copy-pasting
All commands -private -priv Show private information
All commands -public -pub Hide private information
All commands, except delete -y -yes Skip confirmation prompt