# 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 |
← FAQ