View source for Capacity Exchange/User Guide

<languages/>__NOEDITSECTION__
{{Capacity Exchange/Header}}
{{Capacity Exchange/Header2}}
<big>'''<translate><!--T:1--> Welcome to the Capacity Exchange User Guide. Here, you'll find detailed instructions on how to log in, manage your profile, and make the most of your experience on the platform.</translate>'''</big>

<big><translate><!--T:88--> Access <tvar name="1">[[toolforge:capx|https://capx.toolforge.org]]</tvar>.</translate></big>

<big>'''<translate><!--T:647--> CapX How to Videos*</translate>'''</big>
<br>
<small>''<translate><!--T:648--> *Please note that the software is continuously being improved, so the interface shown in the video may differ from the version you are currently using online, although the logic is likely the same. Be sure to check the video’s creation date, and let us know if you need a more up-to-date version.</translate>''</small>
<gallery>
File:CapX How to videos - How to login and navigate the home page ‐ Feito com o Clipchamp.webm|[[:c:File:CapX How to videos - How to login and navigate the home page ‐ Feito com o Clipchamp.webm|<translate><!--T:649--> How to login and navigate the home page (Feb 2026)</translate>]]
File:CapX How to videos - How to Complete and Update the user profile.webm|[[:c:File:CapX How to videos - How to Complete and Update the user profile.webm|<translate><!--T:650--> How to Complete and Update the user profile (Feb 2026)</translate>]]
File:CapX How to Videos - How to Find and Connect to a CapX user profile.webm|[[:c:File:CapX How to Videos - How to Find and Connect to a CapX user profile.webm|<translate><!--T:651--> How to Find and Connect to a CapX user profile (Feb 2026)</translate>]]
File:CapX How to Videos - How to translate the CapX tool.webm|[[:c:File:CapX How to Videos - How to translate the CapX tool.webm|<translate><!--T:652--> How to translate the CapX tool (Dec 2025)</translate>]]
File:CapX How to Videos - How to translate the CapX userbox.webm|[[:c:File:CapX How to Videos - How to translate the CapX userbox.webm|<translate><!--T:653--> How to translate the CapX userbox on Meta-wiki (Dec 2025)</translate>]]
File:How to create an user profile on CapX.webm|[[:c:File:How to create an user profile on CapX.webm|<translate><!--T:654--> How to create an user profile on CapX (Aug 2025)</translate>]]
</gallery>

{|
|+ <big><translate><!--T:111--> '''Contents of the User Guide'''</translate></big>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:112--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to Log In</tvar>|How to Log in]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:113--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to edit the user profile</tvar>|How to edit the user profile]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:114--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to edit the organization profile</tvar>|How to edit the Organization profile]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:115--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to navigate the Capacity Directory</tvar>|How to navigate the Capacity Directory]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:116--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to use the Explore feed</tvar>|How to use the Explore feed]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:117--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to save profiles</tvar>|How to save profiles]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:118--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to report bugs</tvar>|How to report bugs]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:119--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to send messages</tvar>|How to send messages]]</translate>
|-
| [[File:CapX-icon.svg|frameless|20px]] [[#How to find an event|<translate><!--T:664--> How to find an event</translate>]]
|-
| [[File:CapX-icon.svg|frameless|20px]] [[Capacity_Exchange/User_Guide#How_to_join_a_Mentorship_program|<translate><!--T:665--> How to join a Mentorship program</translate>]]
|-
| [[File:CapX-icon.svg|frameless|20px]] [[Capacity_Exchange/User_Guide#How_to_navigate_the_Organization_List|<translate><!--T:666--> How to navigate the Organization List</translate>]]
|-
| [[File:CapX-icon.svg|frameless|20px]] [[Capacity_Exchange/User_Guide#How_to_navigate_Data_in_CapX|<translate><!--T:667--> How to navigate Data in CapX</translate>]]
|-
| [[File:CapX-icon.svg|frameless|20px]] <translate><!--T:120--> [[<tvar name="1">Special:MyLanguage/Capacity Exchange/User Guide#How to translate the tool</tvar>|How to translate the tool]]</translate>
|}
__TOC__
<translate>
== How to Log In == <!--T:2-->
</translate>
[[File:Gif login to CapX.gif|thumb|100px|<translate><!--T:89--> Visual guide on GIF format</translate>]]
<translate>
<!--T:65-->
To log in to the Capacity Exchange platform, you must have a Wikimedia User Account. You will be asked to access the tool through the [[<tvar name="1">Special:MyLanguage/Help:Unified login</tvar>|Unified Login]].

<!--T:3-->
On the landing page of [[<tvar name="capx">toolforge:capx</tvar>|capx.toolforge.org]], click on '''Join for the Exchange!''' or click on '''Login''' in the menu located at the top right of the page.

<!--T:86-->
You will see a pop-up window informing that you will be redirected to the unified login on Meta-Wiki through the [[<tvar name="1">mw:Special:MyLanguage/Help:OAuth</tvar>|OAuth]] extension. Click on the '''Continue''' button.
</translate>
{{Collapse top|1=<translate><!--T:668--> Details on CapX login</translate>}}
<translate>
<!--T:90-->
If you are already logged in, the extension will ask your permission to interact with pages and send emails through your Wikimedia account. If not, you will be asked to log in with your Wikimedia account.

<!--T:91-->
You can review Wikimedia's [[<tvar name="1">foundation:Special:MyLanguage/Policy:Privacy policy</tvar>|Privacy Policy]] by clicking on the '''blue link''' on the left side of the window. Click on '''Allow''' to continue the login process. Please note that your login data will not be stored in CapX's database.

<!--T:87-->
If you don’t have a Wikimedia account, you can create one by clicking on the button '''Create account''' at the end of CapX landing page.
</translate>
{{Collapse_bottom}}
<translate>
<!--T:92-->
You will then return to CapX at <tvar name="1">[[toolforge:capx/home|capx.toolforge.org/home]]</tvar>. Navigate the tool using the menu located at the top right of the page or the buttons displayed on the home page.

== How to edit the user profile == <!--T:93-->
</translate>
[[File:How to create an user profile on CapX.webm|thumbnail|left|200px|<translate><!--T:555--> Short video on how to create a CapX user profile</translate>]]
<translate>
<!--T:94-->
Once logged in, click on '''My profiles''' at the end of the menu located at the top right of the page or the button displayed on the top of the page. Select ‘’’User profile’’’ from the dropdown menu.
You can also access it at <tvar name="1">[[toolforge:capx/profile|capx.toolforge.org/profile]]</tvar>.

<!--T:669-->
It is important to fill in as much information as possible, especially your skills, as this will help you get the best experience using the tool and be found by your peers. 

<!--T:670-->
To share your profile, click '''Copy link''' next to your avatar, just below your username. You can also select '''Show QR code''' to generate a QR image that others can scan to access your profile. The QR code can be saved to your device and used offline.

=== Edit, save, and delete profile === <!--T:95-->

<!--T:96-->
Click on '''Edit user profile''' to start editing it. You can also access <tvar name="1">[[toolforge:capx/profile/edit|capx.toolforge.org/profile/edit]]</tvar>.

<!--T:97-->
Always click on '''Save profile''' to save the changes you made to it, either at the top of the user profile editing page or at the bottom of it. You can also click on '''Cancel edit''' to discard all changes.

<!--T:98-->
To delete your profile, click on the red button '''Delete profile''' at the top of the editing page. You might confirm your choice on a pop-up window before the profile is deleted from CapX's database. Following the GDPR principles, once you delete your profile, all data is erased and, therefore, cannot be recovered.

<!--T:99-->
The tool should be user-friendly and intuitive to navigate. So all you have to do to add information to your profile is follow the steps in the tooltip for each section and click '''Save profile''' when you're done. Your profile will instantly display the updated information.

<!--T:100-->
You can click on the link below to see more information about each section of the CapX user profile.
</translate>
{{Collapse top|1=<translate><!--T:489--> Details on CapX user profile</translate>}}
<translate>
=== Profile image === <!--T:101-->

<!--T:102-->
First, you can choose an avatar to be displayed on your user profile. Click on '''Choose avatar''' and pick an option by clicking on it – the selected one will have a red frame around it. Click on '''Update''' to save your choice and go back, or just close the tab.
</translate>
<br>
<br>
[[File:OOjs UI icon alert destructive black-darkred.svg|frameless|20px]]
<translate>
<!--T:103-->
You can share a personal picture on your profile, in case you have one linked to your username on Wikidata. If you check the box ''Display my Wikidata item photograph on profile'', the tool will automatically search on Wikidata for a QID related to the username you used to log in and will show the related image, if existent.

<!--T:546-->
To have an item on Wikidata, one has to meet [[<tvar name="1">d:Special:MyLanguage/Wikidata:Notability</tvar>|Wikidata's notability policy]]. CapX just automatically searches for a correspondence in the Wikidata's database.

<!--T:104-->
You can also leave your ''Profile image'' blank if you prefer.

=== Badges === <!--T:105-->

<!--T:106-->
Then, you can pick the badges you want to display on your user profile. Click on '''Edit your badges''' to access the selection tab. On the selection tab, you will be invited to ''Choose which badges to display in your profile'' – click once to select a badge and again to unselect it. The selected ones will have a green frame around them. Then, click on '''Update''' to save your preferences, or '''Close tab''' to leave it as it was.

<!--T:107-->
Once you go back to the profile, you must see the selected badges displayed on it.

<!--T:108-->
Click on '''View all badges''' to go <tvar name="1">[[toolforge:capx/profile/badges|capx.toolforge.org/profile/badges]]</tvar>, a page where you can see more information about each badge and see those you haven't earned yet. Click on '''Back to user profile''' to return. The '''Badges''' page is also listed in the menu located at the top right of the tool’s page.

=== Mini bio === <!--T:109-->

<!--T:490-->
On the Mini bio, you are invited to share essential information about your cultural background and your work as a Wikimedian. For an effective mini bio, you can highlight your current activity or interests across the Wikimedia Movement and mention experiences relevant to what you want to share or learn.

<!--T:671-->
First, you can choose to display the language of your text, helping others who may want to use automated translation to understand it. It is worth mentioning that user content in the CapX database is not available for translation on TranslateWiki.

<!--T:672-->
Click on the box that says ''Not specified'' to open the drop-down menu and search for the desired language. They are listed alphabetically.

<!--T:110-->
You are welcome to share everything you find relevant for your peers to know more about you. It's up to you to choose how much you want to share about your personal and Wikimedian life – as long as you keep it up to 2,000 characters.

<!--T:121-->
[[File:OOjs UI icon alert destructive black-darkred.svg|frameless|20px]] It is important to note that this is where there may be potentially sensitive information, together with the displaying of your Wikidata item. Therefore, be careful about what you write and how much you want to share before saving it into the CapX's database.

=== The capacities === <!--T:122-->

<!--T:491-->
[[File:CapX-icon.svg|frameless|20px]] The capacities (skills, knowledge and services) are the core feature of this tool. To ensure that you have a positive experience, it is crucial to select them carefully.

<!--T:123-->
Before picking the '''Known, Available and Wanted''' capacities you want to display on your profile, we recommend you navigate the Capacity Directory to understand them better. See [[<tvar name="1">Capacity Exchange/User Guide#How to navigate the Capacity Directory</tvar>|'''How to navigate the Capacity Directory''' section]] below, or access the Directory at [[toolforge:capx/capacity|capx.toolforge.org/capacity]].

<!--T:673-->
It is worth noting that users can also add skills to their profile through the carousel of suggestions on the '''Home''' page or via the '''Capacity Directory''' on each of the capacity cards.

==== Difference between capacities ==== <!--T:124-->

<!--T:492-->
'''Known, Available and Wanted''' capacities are chosen from the same Capacity Directory. They can be broad ones, like ''Communication'', or more specific ones, like ''press release''.

<!--T:125-->
'''Known''' capacities are those you already have. They can be skills, knowledge, or competencies. This selection can give your peers a summary of your talents.

<!--T:126-->
'''Available''' capacities are those you are willing to share with your peers. They must be listed on your '''Known capacities''' because you can only share and teach something you already know about. The tool will use this selection to show your profile to those who are looking for exactly what you are willing to share.

<!--T:127-->
'''Wanted capacities''' are those you want to learn. The tool will use this selection to show you profiles that match your needs.

<!--T:128-->
The Capacity Exchange encourages the sharing of capacities on a voluntary basis, but this must be decided through personal contact between the parties. Expectations, timescale, and dedication should be agreed upon parallel to the tool.

==== Selecting capacities ==== <!--T:129-->

<!--T:493-->
To select the '''Known, Available and Wanted''' capacities to be displayed, you may click on '''Add capacities''' to open a pop-up window. Click on the box and type the first few letters of the desired skill to make it easier to search a correspondent capacity. 

<!--T:674-->
As you type, matching results will be displayed in a list below the box. Click on the desired skill to add it to your profile.

<!--T:675-->
You must select one capacity at a time, except in the '''Available capacities''' section. In this case, you can click the '''Import known capacities''' button to copy all your selected skills into this section.

<!--T:548-->
Once you click on a name, the tool will return to the user editing page. 

<!--T:136-->
You might see the capacity added to your profile, under '''Known, Available or Wanted''' capacities. To delete it, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of the capacity.

<!--T:137-->
Remember that you can only add to your '''Available capacities''' those you also listed at '''Known capacities'''. If you add one that is not on that list, you will have trouble saving your profile's changes later.

<!--T:138-->
Remember that your selection will be saved once you save your profile. To do that, click on the purple button at the top or the bottom of the editing page. We recommend you do it a few times when you are selecting your capacities to make sure you do not lose your efforts.

=== Languages === <!--T:139-->

<!--T:495-->
You can choose to display on your profile the languages in which you feel comfortable connecting with peers.

<!--T:140-->
Click on '''Add language''' to open the drop-down menu and search for the desired language. If you are accessing the tool on a desktop, click on the box and type the first few letters of the desired language to make it easier to search.

<!--T:141-->
Once you select a language, it will be added to your profile at the bottom of your list of languages.

<!--T:142-->
The default proficiency for any language is ''Advanced'', so be sure to change it to match your proficiency level. You can do it on a drop-down menu that will be opened once you click on the arrow icon ([[File:Down arrow icon.svg|11px]]) to the right of the proficiency level.

<!--T:143-->
You can level your language proficiency as ''Not proficient, Basic, Intermediate, Advanced, Almost native, Professional proficiency, or Native''.

<!--T:144-->
To delete a language from the list, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of its proficiency level.

<!--T:145-->
You should find all languages in the drop-down menu, but if you believe a particular one is missing, let CapX's team know so they can add it to the database.

=== Alternative Wikimedia account === <!--T:146-->

<!--T:496-->
If you want to display your other Wikimedia username, you can type it in the box. Be careful not to make any typos.

<!--T:147-->
Not everyone has a second username. But this is common for staff members who keep their voluntary contributions separate from their institutionalized ones.

<!--T:148-->
It's up to you to share it or not.

=== Affiliation === <!--T:149-->

<!--T:497-->
You can choose to display your affiliation to Wikimedia user groups, initiatives, chapters, or projects.

<!--T:150-->
Click on '''Insert item''' to open the drop-down menu and search for the desired organization. If you are accessing from a desktop, you can type the name of the organization to help you find it. Once you click on a name, it will be added to your profile at the bottom of your list of affiliations. You can add as many organizations as you want to be displayed on your profile.

<!--T:151-->
To delete an organization from your list, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of it.

<!--T:152-->
We highly advise against including organizations with which you are not affiliated, as this may result in confusion among your peers.

<!--T:153-->
If you don't find your organization in the drop-down menu, let CapX's team know so they can add it to the database.

=== Territory === <!--T:154-->

<!--T:498-->
You can choose to display your geographic location by region or country on your profile. You can choose as many countries and regions as you need in order to show your peers your connections and roots.

<!--T:155-->
Click on '''Insert item''' to open the drop-down menu and search for the desired region or country. Once you click on a name, it will be added to your profile at the bottom of your list of territories.

<!--T:156-->
These territories will be used in the ''Explore'' feature to filter people from a specific region or country, in case your peers want to find people near them or in a specific region of the world.

<!--T:157-->
To delete a territory from your list, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of it.

<!--T:158-->
We recommend that you display a region instead of a country if you are not comfortable disclosing your location. This way, you can show your peers where you are and still connect with those closest to you without overexposing your location. For regions, we based them on the eight [[<tvar name="1">Special:MyLanguage/Wikimedia regions</tvar>|2022 Wikimedia Foundation divisions]], as they are recognized within the Wikimedia Movement.

<!--T:159-->
<small>They are: Sub-Saharan Africa; South Asia; Central & Eastern Europe & Central Asia; Latin America & Caribbean; Middle East & North Africa; East, Southeast Asia, & Pacific; Northern & Western Europe; North America.</small>

=== Wikidata Item === <!--T:160-->

<!--T:499-->
You can display your Wikidata item on your profile.

<!--T:161-->
If you check the box ''Display my Wikidata item on profile'', the tool will automatically search on Wikidata for a QID related to the username you used to log in to CapX, and will show it on your profile (if found).

<!--T:162-->
To have an item on Wikidata, one has to meet [[<tvar name="1">d:Special:MyLanguage/Wikidata:Notability</tvar>|Wikidata's notability policy]]. CapX just automatically searches for a correspondence in the Wikidata's database.

=== Wikimedia projects === <!--T:163-->

<!--T:500-->
You can display the Wikimedia Projects you have interest in on your profile.

<!--T:164-->
Click on '''Add projects''' button to open the drop-down menu and search for the desired Wikimedia Project. Once you click on a name, it will be added to your profile at the bottom of your list of Wikimedia projects.

<!--T:165-->
To delete a Wikimedia project from your list, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of it.

</translate>
{{Collapse bottom}}
<translate>
== How to edit the organization profile == <!--T:168-->
</translate>

[[File:CapX - Create an Organizational profile 2.png|thumbnail|<translate><!--T:552--> Card with info on how to create an Organization Profile on CapX</translate>]]

<translate>
<!--T:501-->
In order to have their profile available on Capacity Exchange, user groups, initiatives, projects, or chapters must inform the CapX team of all usernames that should have editing rights. This process is done manually by the CapX team to increase security and prevent malicious edits. 
</translate>
''<translate><!--T:678--> Please email the team at <tvar name="1">capx{{@}}wmnobrasil.org</tvar> with your information.</translate>''
<translate>
<!--T:169-->
To be added as admins, the indicated users must have already created their profiles on CapX because edits on the organization profile will be made using their individual logins.

<!--T:170-->
Once logged in, click on '''My profiles''' at the end of the menu located at the top right of the page or the button displayed on the top of the page. The authorized users should see two or more profile options. To edit an organization profile, click on '''[Your organization name]'''.

=== Edit, save, and delete profile === <!--T:171-->

<!--T:502-->
Click on '''Edit organization profile''' to start editing it. You can also access the profile in question by using its direct link. Only authorized users will see the editing button.

<!--T:172-->
Always click on '''Save profile''' to save the changes you made to it, either at the top of the organization profile editing page or at the bottom of it. You can also click on '''Cancel edit''' to discard all the changes.

<!--T:173-->
To delete your organization profile, you can contact the CapX team. If you have the rights to edit it, you can clear its data and leave all fields blank. Following the GDPR principles, once you delete the information, all data is erased and cannot be recovered.

<!--T:174-->
To be removed from the role of the organization profile's manager you can also email the team. Once there is no one linked as admin, the profile will no longer be displayed on the CapX list of organizations.

<!--T:175-->
The tool should be user-friendly and intuitive to navigate. So, all you have to do is follow the steps in the tooltip for each section and click on the '''Save profile''' button when you're done. Your organization profile will instantly display the updated information.

<!--T:176-->
You can click on the link below to see more information about each section of the CapX organization profile.
</translate>
{{Collapse top|1=<translate><!--T:503--> Details on CapX organization profile</translate>}}

<translate>
=== Organization logo === <!--T:177-->

<!--T:504-->
To insert your Organization's logo next to its profile, provide a Wikimedia Commons link of the image. We recommend you provide a .svg link, but it can be any image file.

<!--T:178-->
To save it to the profile, just click on '''Save profile''' button at the top or at the bottom of the page.

<!--T:179-->
Make sure you choose an image that shows your organization logo to avoid confusion within the Wikimedia Movement. We do not control the selections in the tool, but we may suggest that you change an image in the event of incorrect logo usage.

<!--T:180-->
You may encounter an error when saving the profile if the link provided does not follow the indicated format.

<!--T:181-->
If your organization doesn’t have a logo, or if you don’t want to share it, just leave this space blank.

=== Organization Names (Translations) === <!--T:679-->

<!--T:680-->
In this section, organizations can add their names in different languages. The name will be displayed based on the user's selected language. If a name is not available in the selected language, it will be displayed in English.

<!--T:681-->
The tool’s default language is English, as it is the lingua franca of the Wikimedia movement. Therefore, this option must always be available in profiles.

<!--T:682-->
To add a translation of your Organization name, click the '''Add Translation''' button. Click ''Select language'' to find the code of the desired language in a drop-down menu. Select the code language, then fill in the ''Organization name'' field with the translated name in that language. Click '''Add''' to store your changes, or '''Cancel''' to discard them.

<!--T:683-->
To delete a language from the list, click on the delete icon (<tvar name="1">[[File:Delete (89608) - The Noun Project.svg|10px]]</tvar>) on the right side of its box. You can also edit it by clicking the '''Edit''' button.

=== Report of activities === <!--T:182-->

<!--T:505-->
You can provide a direct link to your Organization’s reports to be displayed on its profile. Insert a Meta-wiki link in the field, in which you can see an example using Wikimedia Brasil's link.

<!--T:183-->
To save it to the profile, just click on '''Save profile''' button at the top or at the bottom of the page.

<!--T:184-->
You may encounter an error when saving the profile if the link provided does not follow the indicated format.

<!--T:185-->
If your organization doesn't have a report, or if you don't want to share it, just leave this space blank.

=== The Capacities === <!--T:186-->

<!--T:506-->
[[File:CapX-icon.svg|frameless|20px]] The capacities are the core feature of the CapX tool. It is through them that users can find your organization's profile and have a positive experience. Therefore, it is crucial to select them carefully to reflect your organization's real strengths.

<!--T:187-->
Before picking the '''Known, Available and Wanted''' capacities, we recommend you navigate the Capacity Directory to understand them better and see which reflect your organization work. See [[<tvar name="1">Capacity Exchange/User Guide#How to navigate the Capacity Directory</tvar>|'''How to navigate the Capacity Directory''' section]] below, or access the Directory at [[<tvar name="2">toolforge:capx/capacity</tvar>|capx.toolforge.org/capacity]].

<!--T:684-->
It is worth noting that organizations can only add skills to their profile through the profile editing page. The addition through the suggestions carousel on the '''Home''' page and the '''Capacity Directory''' on each capacity card are only available for user profiles.

==== Difference between capacities ==== <!--T:188-->

<!--T:507-->
'''Known, Available and Wanted''' capacities are chosen from the same Capacity Directory. They can be broad ones, like ''Communication'', or more specific ones, like ''press release''.

<!--T:189-->
'''Known''' capacities are those the organization already have. They can be skills, knowledge, or competencies that reflect their work. This selection will show Wikimedians a summary of your organization's expertise.

<!--T:190-->
'''Available''' capacities are those the organization is willing to share with others, be them institutional entities or individual Wikimedians. They must have been listed on the '''Known capacities''' because one should know something in order to share or teach it. The tool will use this selection to display the organization profile to possible matches.

<!--T:191-->
'''Wanted capacities''' are those the organization would like to have in the future. From this selection, the tool will match the profiles that can help each other.

<!--T:192-->
The Capacity Exchange encourages the sharing of capacities on a voluntary basis, but this must be decided through personal contact between the parties. Expectations, timescale, and dedication should be agreed upon parallel to the tool.

==== Selecting capacities ==== <!--T:193-->

<!--T:508-->
To select the '''Known, Available and Wanted''' capacities to be displayed, you may click on '''Add capacities''' to open a pop-up window. Click on the box and type the first few letters of the desired skill to make it easier to search a correspondent capacity. 

<!--T:685-->
As you type, matching results will be displayed in a list below the box. Click on the desired skill to add it to your profile.

<!--T:686-->
You must select one capacity at a time, except in the '''Available capacities''' section. In this case, you can click the '''Import known capacities''' button to copy all your selected skills into this section.

<!--T:687-->
Once you click on a name, the tool will return to the user editing page. 

<!--T:201-->
You might see the capacity added to your profile, under '''Known, Available or Wanted''' capacities. To delete it, click on the delete icon ([[<tvar name="1">File:Delete (89608) - The Noun Project.svg</tvar>|10px]]) on the right side of the capacity.

<!--T:202-->
Remember that it is only allowed to save '''Available capacities''' that are also listed at '''Known capacities'''. Even though you can add them, the tool will not allow you to save your profile's changes.

<!--T:203-->
Remember that your selection will be saved once you save your profile. To do that, click on the '''Save profile''' button at the top or at the bottom of the editing page. We recommend you do it a few times when selecting capacities to make sure you do not lose your efforts.

=== Territory === <!--T:688-->

<!--T:689-->
You can choose to display your organization geographic location by region or country on your profile. You can choose as many countries and regions as you need in order to show your peers your connections and roots.

<!--T:690-->
Click on '''Insert item''' to open the drop-down menu and search for the desired region or country. Once you click on a name, it will be added to your organization profile at the bottom of your list of territories.

<!--T:691-->
These territories will be used to filter people from a specific region or country, in case your peers want to find people near them or in a specific region of the world.

<!--T:692-->
To delete a territory from your list, click on the delete icon ([[<tvar name="1">File:Delete (89608) - The Noun Project.svg</tvar>|10px]]) on the right side of it.

<!--T:693-->
We recommend that you display a region instead of a country if you are not comfortable disclosing your organization location. This way, you can show your peers where you are and still connect with those closest to you without overexposing your organization location. For regions, we based them on the eight [[<tvar name="1">Special:MyLanguage/Wikimedia regions</tvar>|2022 Wikimedia Foundation divisions]], as they are recognized within the Wikimedia Movement.
</translate>
<small><translate><!--T:694--> They are: Sub-Saharan Africa; South Asia; Central & Eastern Europe & Central Asia; Latin America & Caribbean; Middle East & North Africa; East, Southeast Asia, & Pacific; Northern & Western Europe; North America.</translate></small>
<translate>
=== Main projects === <!--T:204-->

<!--T:510-->
You can display your Organization’s main projects on its profile. The idea is to publicize what your organization has been working on.

<!--T:205-->
To add a project to the profile, click on the button '''Add projects'''. It will open three fields to be filled with the project's information.

<!--T:206-->
In the first field, write the name of the project as you want it to appear on the profile. In the second, you can insert an image corresponding to the project by inserting a link to an image file on Wikimedia Commons. Then, insert the direct link to the project where people can find more information about it – such as a Meta-wiki link.

<!--T:207-->
To delete a project from the profile, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of the editting field.

<!--T:208-->
You can display up to four Main projects at the same time on the organization profile.

<!--T:209-->
To save the changes to the profile, just click on '''Save profile''' button at the top or at the bottom of the page.

<!--T:210-->
If your organization doesn’t have Main projects, or doesn’t want to share them, just leave this space blank.

=== Events === <!--T:211-->

<!--T:511-->
This functionality is directly linked to the [[<tvar name="1">toolforge:capx/events</tvar>|Events page (capx.toolforge.org/events)]]. Events created here will be displayed and filtered on the Events page.

<!--T:212-->
Currently, events within Capacity Exchange can only be created by organization profiles. The profile-editing area is where they can be created and/or edited.

<!--T:213-->
This is also where you can choose up to four main events from your organization to be displayed on its profile. To choose events, you must first create them.

<!--T:214-->
To create a new event, click on the '''Create a new event''' button. A pop-up window will open with a few fields to be filled in.

<!--T:215-->
The first field is the event's URL. It will be linked to the '''View event''' button on the Events page. The users will be redirected to this link to find more information about the event in question, so make sure you insert the right one. 

<!--T:739-->
When you enter a URL from a Meta-Wiki event page or a WikiLearn course, the tool automatically fills in the event details. Click on '''Search''' for that.

<!--T:216-->
Even if the tool automatically fills in the information, make sure to review the title, start date, and end date. It is not possible to change the event organizer, as this is linked to the profile that created the event. Then, select the event format from the drop-down menu: virtual, in-person, or hybrid.

<!--T:740-->
Don't forget to add the skills related to the event. These skills are used by the platform to recommend your event to users through the Carousel of Suggestions (on the home page) and to help users find it when filtering events based on their interests.

<!--T:741-->
To add a skill, click in the field '''Choose capacities''' and start typing. The tool will display related capacities in a drop-down menu. Click on the one you want to add, then clear the text to search for another. Repeat this process as many times as needed. To delete a skill from your list, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of its name.

<!--T:742-->
Finally, add an event description. Make sure to include as many details as possible to spark people's interest and encourage them to visit the event's Meta-Wiki page and register.

<!--T:743-->
To save the changes, click on '''Create event''' button at the bottom of the window.

<!--T:744-->
It will be displayed on your organization's editing page under the '''Events''' section. You can use the menu at the top of the event card to edit it, choose whether to display it on your organization's profile, or delete it.

<!--T:745-->
To display the event on your organization's profile, simply check the corresponding box. To hide it, uncheck the box. Regardless of this setting, the event will remain available on the [[<tvar name="1">toolforge:capx/events</tvar>|Events page (capx.toolforge.org/events)]].

=== News === <!--T:217-->

<!--T:512-->
This feature makes it possible to display news from [[<tvar name="1">DiffBlog:</tvar>|Diff]] on the Organization profile.

<!--T:218-->
To add news related to your organization, you must indicate the '''blog tags used on its blog posts'''. Click on the '''Add diff tags''' button and write the tags of your choice, one per field. To add more tags, click the button to open new fields. Click on the delete icon <tvar name="1">([[File:Delete (89608) - The Noun Project.svg|10px]])</tvar> on the right side of the editing field to delete a tag or an empty field.

<!--T:695-->
''It is important to note that this section does not support links, only tag names as used in the Wikimedia Diff.''

<!--T:219-->
The tool will look for new posts related to the indicated tags on the Diff blog and will display them on the Organization profile in chronological order, from the latest to the oldest.

<!--T:220-->
To save the changes to the profile, just click on '''Save profile''' button at the top or at the bottom of the page.

<!--T:221-->
If your organization doesn’t have posts on Diff, or doesn’t want to share them, just leave this space blank.

=== Documents === <!--T:222-->

<!--T:513-->
You can display your Organization’s main documents on its profile. The idea is to publicize what your organization has been working on.

<!--T:223-->
To add a document to the Organization profile, insert a URL of a document stored on Wikimedia Commons. This URL will be linked to the '''View document''' button, on the profile's visualization page, where users can click to access the document in question.

<!--T:224-->
The organization can share up to four Documents on its profile. Click on the button '''Add more links''' to open a new field where you can insert another document's Commons URL.

<!--T:225-->
To delete a document from the profile, click on the delete icon ([[File:Delete (89608) - The Noun Project.svg|10px]]) on the right side of the editting field.

<!--T:226-->
To save the changes to the profile, just click on '''Save profile''' button at the top or at the bottom of the page.

<!--T:227-->
If your organization doesn’t have documents or doesn’t want to share them, just leave this space blank.

=== Contacts === <!--T:228-->

<!--T:514-->
This section is for organizations to provide the community with their contact information.

<!--T:229-->
In the first field, insert the link to the organization's Meta-wiki page, if it has one. In the second field, select an email address that interested parties can use to get in touch with the organization. Finally, share the address of your organization's website, if it has one.

<!--T:230-->
To save the changes to the profile, just click on '''Save profile''' button at the top or at the bottom of the page.

<!--T:231-->
If your organization doesn’t have or doesn’t want to share any of these contacts, just leave the spaces blank.
</translate>
{{Collapse bottom}}

<translate>
== How to navigate the Capacity Directory == <!--T:232-->

<!--T:515-->
The Capacity Directory is the heart of the tool. It contains skills, knowledge, and abilities that are related to the Wikimedia Movement. The capacities are the main function of the tool because user profiles, organization profiles, and events are organized and filtered around them.

<!--T:233-->
To access it, click on the hamburger button in the upper right corner of the screen and select '''Capacity Directory''' or go directly to <tvar name="1">[[:toolforge:capx/capacity|capx.toolforge.org/capacity]]</tvar>.

<!--T:234-->
Before editing your user or organization profile, we recommend you look through the Capacity Directory to see which skills you already have and which ones you want to learn.

<!--T:235-->
''** You might be shocked at how many wiki-related skills you already have that you didn't even think of, and also how many amazing things Wikimedians are capable of that you never even knew about.**''

<!--T:236-->
You can explore skills in four simple ways: view them as themed cards, browse a tree view, navigate by thematic categories, or use the search bar to find what you need quickly. 

<!--T:696-->
Click the field and start typing to filter skills, or use the three tabs below the search bar to switch between browsing modes.

<!--T:237-->
The tool should be user-friendly and intuitive to navigate. If you want more information on the skills available or on how to navigate the Capacity Directory, click on the link below.
</translate>

{{Collapse top|1=<translate><!--T:516--> Details on the Capacity Directory</translate>}}
<translate>
<!--T:517-->
The Capacity Directory features a structure of skills organized in three ways.

<!--T:697-->
The first tab shows skills organized as themed cards. Each main skill is represented by a card with subcategories inside. There are currently seven main skills, each with a distinct color and a set of more specific capabilities within them.

<!--T:698-->
The second tab displays skills in a tree view. It follows the same hierarchy as the cards view, but highlights how skills are connected, making their relationships easier to understand at a glance.

<!--T:699-->
The third tab shows categories commonly used in volunteer work across three thematic areas: Linguistic Equity, Knowledge Gaps, and Open Education. It allows you to quickly select categories relevant to your work as a Wikimedian in a more direct and focused way.

=== Currently available capacities === <!--T:238-->

<!--T:239-->
Below you can see all the 134 items first available in the Capacity Directory by clicking on the ''Expand'' link of each Main Capacity. Please note that more options may have been added.
</translate>

{{Collapse top|1=<translate><!--T:240--> Organisational Skills</translate>}}
* <translate><!--T:241--> Finance</translate>
** <translate><!--T:242--> Budgeting</translate>
** <translate><!--T:243--> Financial Management</translate>
** <translate><!--T:244--> Financial Reporting</translate>
* <translate><!--T:245--> Governance</translate>
** <translate><!--T:246--> Accountability</translate>
** <translate><!--T:248--> Documentation</translate>
** <translate><!--T:249--> Legal obligations</translate>
** <translate><!--T:250--> Reporting</translate>
** <translate><!--T:655--> Delegation</translate>
** <translate><!--T:265--> Diversity, Equity and Inclusion (DEI)</translate>
* <translate><!--T:252--> Grant Proposal</translate>
** <translate><!--T:253--> Wikimedia Grant</translate>
* <translate><!--T:656--> Organizational Behavior</translate>
** <translate><!--T:255--> Change Management</translate>
** <translate><!--T:256--> Knowledge Management</translate>
** <translate><!--T:257--> Leadership</translate>
* <translate><!--T:258--> Plan & Strategy</translate>
** <translate><!--T:259--> Assessment</translate>
** <translate><!--T:260--> Evaluation</translate>
** <translate><!--T:657--> Wikimedia 2030</translate>
** <translate><!--T:263--> Theory of Change</translate>
* <translate><!--T:264--> Team Management</translate>
** <translate><!--T:266--> Performance Appraisal</translate>
** <translate><!--T:267--> Recruitment</translate>
** <translate><!--T:268--> Staff Development</translate>
** <translate><!--T:269--> Team-Building</translate>
{{Collapse bottom}}
{{Collapse top|1=<translate><!--T:270--> Communication</translate>}}
* <translate><!--T:271--> Administrative Communication</translate>
* <translate><!--T:272--> Community Engagement</translate>
* <translate><!--T:273--> Cultural Translation</translate>
* <translate><!--T:274--> Corrective Feedback</translate>
* <translate><!--T:275--> Datagraphic</translate>
* <translate><!--T:276--> Journalistic Interview</translate>
* <translate><!--T:277--> Media</translate>
* <translate><!--T:278--> Presentations</translate>
* <translate><!--T:279--> Press release</translate>
* <translate><!--T:280--> Public Speaking</translate>
* <translate><!--T:281--> Social Media</translate>
* <translate><!--T:282--> Storytelling</translate>
* <translate><!--T:283--> Target Audience</translate>
{{Collapse bottom}}
{{Collapse top|1=<translate><!--T:284--> Learning & Evaluation</translate>}}
* <translate><!--T:285--> Case Study</translate>
* <translate><!--T:286--> Assessment Method</translate>
* <translate><!--T:287--> Focus Groups</translate>
* <translate><!--T:288--> Survey</translate>
* <translate><!--T:289--> User Experience</translate>
* <translate><!--T:290--> Wikimedia Tools</translate>
** <translate><!--T:363--> Abuse Filter</translate>
** <translate><!--T:364--> AutoWikiBrowser</translate>
** <translate><!--T:658--> Wikimedia Bot</translate>
** <translate><!--T:366--> Central Notice</translate>
** <translate><!--T:367--> Event Metrics</translate>
** <translate><!--T:368--> Fountain</translate>
** <translate><!--T:659--> Wikimedia gadget</translate>
** <translate><!--T:370--> Hashtag search</translate>
** <translate><!--T:371--> HotCat</translate>
** <translate><!--T:660--> Lua</translate>
** <translate><!--T:373--> OpenRefine</translate>
** <translate><!--T:374--> Pattypan</translate>
** <translate><!--T:375--> PAWS</translate>
** <translate><!--T:376--> Programs & Events Dashboard</translate>
** <translate><!--T:377--> Pywikibot</translate>
** <translate><!--T:378--> Quarry</translate>
** <translate><!--T:379--> QuickStatements</translate>
** <translate><!--T:661--> MediaWiki userscript</translate>
** <translate><!--T:662--> Wikidata Query Service</translate>
{{Collapse bottom}}
{{Collapse top|1=<translate><!--T:291--> Community Health</translate>}}
* <translate><!--T:292--> Anti-harassment Tools</translate>
* <translate><!--T:293--> Community development</translate>
* <translate><!--T:294--> Conflict Management</translate>
* <translate><!--T:295--> Culture of Innovation</translate>
* <translate><!--T:297--> Experience Design</translate>
* <translate><!--T:298--> Non-Violent Communication Technique</translate>
* <translate><!--T:299--> Policy</translate>
{{Collapse bottom}}
{{Collapse top|1=<translate><!--T:300--> Social Skills</translate>}}
* <translate><!--T:301--> Adaptability</translate>
* <translate><!--T:302--> Assertiveness</translate>
* <translate><!--T:303--> Empathy</translate>
* <translate><!--T:305--> Mentorship</translate>
* <translate><!--T:306--> Peer Support</translate>
* <translate><!--T:307--> Problem-Solving</translate>
* <translate><!--T:308--> Self-Awareness</translate>
* <translate><!--T:304--> Facilitation</translate>
{{Collapse bottom}}
{{Collapse top|1=<translate><!--T:663--> Strategic Management Process</translate>}}
* <translate><!--T:311--> Advocacy</translate>
* <translate><!--T:312--> Education</translate>
** <translate><!--T:313--> Educational Programs</translate>
** <translate><!--T:314--> Youth Engagement</translate>
* <translate><!--T:315--> Event</translate>
** <translate><!--T:316--> Campaign</translate>
** <translate><!--T:317--> Conference</translate>
** <translate><!--T:318--> Competition</translate>
** <translate><!--T:319--> Computer Literacy</translate>
** <translate><!--T:320--> Edit-a-thons</translate>
** <translate><!--T:322--> Event Management</translate>
** <translate><!--T:324--> Meetup</translate>
** <translate><!--T:325--> Partnership</translate>
** <translate><!--T:326--> Stress Management</translate>
** <translate><!--T:327--> Corporate Travel Management</translate>
** <translate><!--T:328--> Workshop</translate>
* <translate><!--T:329--> GLAM</translate>
** <translate><!--T:330--> Digitization</translate>
** <translate><!--T:331--> GLAM-Wiki Project</translate>
** <translate><!--T:332--> Impact Assessment</translate>
** <translate><!--T:334--> Photo contest</translate>
** <translate><!--T:335--> Wikimedian in Residence</translate>
* <translate><!--T:336--> Research</translate>
** <translate><!--T:337--> Academic Skills</translate>
* <translate><!--T:338--> Training</translate>
** <translate><!--T:339--> Learning Analytics</translate>
** <translate><!--T:340--> Outreach</translate>
** <translate><!--T:341--> Technical Support</translate>
** <translate><!--T:342--> Training Method</translate>
** <translate><!--T:343--> Tutorial</translate>
{{Collapse bottom}}
{{Collapse top|1=<translate><!--T:344--> Technical Skills</translate>}}
* <translate><!--T:345--> Donation</translate>
** <translate><!--T:346--> Data Donations</translate>
* <translate><!--T:347--> Wikimedia Project</translate>
** <translate><!--T:348--> MediaWiki</translate>
** <translate><!--T:349--> Wikimedia Meta-Wikimedia</translate>
** <translate><!--T:350--> Wikibooks</translate>
** <translate><!--T:351--> Wikidata</translate>
** <translate><!--T:352--> Wikifunctions</translate>
** <translate><!--T:353--> Wikimedia Commons</translate>
** <translate><!--T:354--> Wikimedia Incubator</translate>
** <translate><!--T:355--> Wikinews</translate>
** <translate><!--T:356--> Wikipedia</translate>
** <translate><!--T:357--> Wikiquote</translate>
** <translate><!--T:358--> Wikisource</translate>
** <translate><!--T:359--> Wikispecies</translate>
** <translate><!--T:360--> Wikivoyage</translate>
** <translate><!--T:361--> Wiktionary</translate>
{{Collapse bottom}}

<translate>
=== Details on the navigation design === <!--T:382-->

<!--T:700-->
You can explore skills using the three tabs below the search bar. Switch between them to change the browsing mode. See details for each option below.

<!--T:701-->
All three views include a link at the bottom of the page: ''Can’t find a capacity? Suggest a new one!''. This lets you propose a new CapX capacity, which will be reviewed by the committee before being added to the database.

<!--T:702-->
Click the link to open the ''Suggest a new capacity'' window, where you can enter the skill title and description. Providing clear context on why it should be added improves the chances of approval. Click '''Submit''' to send your suggestion or '''Cancel''' to discard it.

==== Themed cards ==== <!--T:703-->

<!--T:518-->
The Capacity Directory is structured similarly to the categories in Wikimedia projects: a general capacity has more specific ones inside it, and so on.

<!--T:383-->
It's possible to find the seven main skills by scrolling down the page. Each of them has its own color and consists of an icon representing the main skill, its name, an information icon <tvar name="1">([[File:Information-icon.svg|13px]])</tvar>, and an arrow icon <tvar name="2">([[File:Down arrow icon.svg|11px]])</tvar>.

<!--T:384-->
By clicking on the capacity name, the tool will redirect you to the '''Explore''' page with the filter activated to display only the profiles that contain that skills in question.

<!--T:385-->
If you click on the information icon <tvar name="1">([[File:Information-icon.svg|13px]])</tvar>, a new tab will appear below the box with the capacity's clickable [<tvar name="3">https://metabase.wikibase.cloud/wiki/Main_Page</tvar> Metabase QID link], the [[<tvar name="2">:d:Special:MyLanguage/Wikidata:Introduction</tvar>|Wikidata QID]], its description (that can be pulled from Metabase or Wikidata), and two buttons: ''Add to Known'' and ''Add to Wanted''. These buttons let you quickly add a skill to your user profile as either a ''known'' or ''wanted capability''. This action is only available within the user profile context. Once selected, the button state updates to indicate success, becoming darker and changing its label to ''Added.''

<!--T:704-->
If the capacity information is not available in your selected language, you will also see a "call to action" box (see [[<tvar name="4">Special:MyLanguage/Capacity_Exchange/User_Guide#How_to_translate_the_tool</tvar>|the Translation section of this guide]] for more information on this box).

<!--T:386-->
Click on the Metabase QID link or on the Wikidata QID link to be redirected to its respective Wikidata page.

<!--T:387-->
Currently, capacities descriptions are pulled first from [<tvar name="1">https://metabase.wikibase.cloud/wiki/</tvar> Metabase] and, when they do not exist there, from the [[<tvar name="2">:d:</tvar>|Wikidata's database]]. The decision to prioritize descriptions from Metabase is due to the fact that they tend to be closely associated with the Wikimedia universe and, as a result, more accurately describe the capacities related to it.

<!--T:388-->
By clicking on the arrow icon <tvar name="1">([[File:Down arrow icon.svg|11px]])</tvar> on the right side of the capacity box, you can see all the capacities inside each of them. Within each main capacity, scroll sideways to access all the specific ones. You might notice that some of them have a third level with more specific capacities inside them; to see these, click on the arrow icon <tvar name="2">([[File:Down arrow icon.svg|11px]])</tvar> as well.

==== Tree view ==== <!--T:730-->

<!--T:731-->
In the tree view, skills follow the same hierarchy: a general capacity contains more specific ones, and so on. The difference is that they are organized as a graph. 

<!--T:732-->
In the initial view, you can see the seven main categories linked to the CapX logo, each with its corresponding color. Click on each one to view the skills it contains.

<!--T:733-->
In addition to expanding the related skills, clicking a node in the graph opens the corresponding skill card. As in the themed cards view, each card shows the skill title, its Metabase and Wikidata QIDs, a description, and a translation action if it is not available in the display language. You can also add skills directly to your user profile from using '''Add to Known''' or '''Add to Wanted''' buttons.

<!--T:734-->
Click the node again to collapse it, or use the '''Return to initial view''' button at the bottom of the page.

==== Thematic categories ==== <!--T:735-->

<!--T:736-->
The third view is organized by thematic categories. Initially, three categories were defined based on Wikimedia volunteer activities: ''Linguistic Equity, Knowledge Gaps, and Open Education''.

<!--T:737-->
Each category has a specific color and shows ten selected skills from the CapX Capacity Directory. These represent the most commonly associated skills for each thematic area. The selection was developed with CapX partners and is not exhaustive. It is intended to support and simplify initial profile setup based on a volunteer’s area of work.

<!--T:738-->
Use the side arrows to navigate the list and click on a skill name to open its card. As in the other views, each card includes the skill title, its Metabase and Wikidata QIDs, a description, and a translation action if it is not available in the display language. You can also add skills directly to your profile using '''Add to Known''' or '''Add to Wanted'''.
</translate>
{{Collapse bottom}}
<translate>
== How to use the Explore feed == <!--T:390-->

<!--T:519-->
It is through the '''Explore''' feed that you can find someone that matches your needs! If you are looking for Organization profiles, go to the [[<tvar name="1">:toolforge:capx/organization_list</tvar>|''Organization list'']] instead.

<!--T:391-->
Currently, it is possible to browse and filter user profiles by capacities; their status as “learner”, “sharer,” or "proficient"; their usernames; their informed territories, affiliations and languages.

<!--T:392-->
To access this feature, click on the hamburger button in the upper right corner of the screen and select '''Explore''' or go directly to <tvar name="1">[[:toolforge:capx/feed|capx.toolforge.org/feed]]</tvar>.

<!--T:393-->
On the Explore feed, profiles are displayed in cards that may include the following items, depending on their availability on each profile and on the options selected at the top of the page.
</translate>
* <translate><!--T:520--> an image (avatar or photo);</translate>
* <translate><!--T:521--> an indication of the nature of the wanted exchange (sharer, learner, or proficient);</translate>
* <translate><!--T:522--> the username;</translate>
* <translate><!--T:523--> the capacities wanted, available or known;</translate>
* <translate><!--T:524--> the languages indicated on the profile;</translate>
* <translate><!--T:525--> the territory indicated on the profile;</translate>
* <translate><!--T:526--> an icon that redirects to the profile in question;</translate>
* <translate><!--T:527--> and an icon to save the profile.</translate>
<translate>
<!--T:394-->
You can navigate the page by typing letters or keywords in the search field to filter the profiles, or by scrolling down to see all profiles that contain those letters/words. It’s worth noting that only user profiles with indicated skills appear on the '''Explore''' page.

<!--T:705-->
Choose what appears on each card by selecting the checkboxes for ''Wanted capacities, Available capacities,'' and ''Known capacities.'' The cards will update to show only the skills you’ve selected. By default, ''Wanted'' and ''Available capacities are displayed.

<!--T:396-->
Users can browse the feed to discover profiles they’re interested in, visit them, and save them to review later.

<!--T:397-->
The tool should be user-friendly and intuitive to navigate. If you want more information about how to navigate the '''Explore''' feed click on the link below.
</translate>

{{Collapse top|1=<translate><!--T:398--> Details on Explore feed design</translate>}}
<translate>
=== Details of the profile cards === <!--T:399-->

==== Image, name, languages and territory ==== <!--T:556-->

<!--T:557-->
The image, name, languages and territories shown on the cards are pulled from the profile in question.

==== Nature of the exchange ==== <!--T:400-->

<!--T:706-->
Cards display skills grouped into three categories: '''wanted, available, or known''', based on what the user has selected on their profile.

<!--T:401-->
'''Learner''' is a tag for profiles that have selected skills as '''Wanted.''' It indicates someone looking to connect with others who can share specific skills. These capacities appear in red on the right side of the card.

<!--T:402-->
'''Sharer''' is a tag for profiles that have selected skills as '''Available.''' It represents someone willing to teach or share those skills. These capacities appear in green on the right side of the card.

<!--T:707-->
'''Proficient''' is a tag for profiles that have selected skills as '''Known.''' It reflects the skills the user already has. These capacities appear in orange on the right side of the card.

==== Wanted, Available and Known capacities ==== <!--T:404-->

<!--T:559-->
The '''Wanted, Available and Known capacities''' shown on the cards are those indicated on the profile in question.

<!--T:708-->
These will be used to add the tags '''Sharer, Learner and/or Proficient''' to the profile card and filter profiles according to your needs.

==== Profile icon ==== <!--T:408-->

<!--T:528-->
Click the circular profile icon or the profile image to open that user’s profile page.

==== Save icon ==== <!--T:409-->

<!--T:529-->
Click the save icon to add a profile to your list: the icon will fill to confirm it’s saved. Click it again to remove the profile from your list, and the icon will return to its empty state.

<!--T:410-->
To view your saved profiles, open the hamburger menu and click '''Saved profiles,''' or navigate directly to the page: <tvar name="1">[[:toolforge:capx/feed/saved|capx.toolforge.org/feed/saved]]</tvar>. This page is private and can only be accessed by the user it belongs to.

=== Details on the filter === <!--T:411-->

<!--T:530-->
You can filter the profiles to look for those who match your needs.

==== Filter by username (search bar) ==== <!--T:412-->

<!--T:531-->
The first possible way is to filter by username.

<!--T:413-->
To do that, click on the search bar at the top of the '''Explore''' page. 

<!--T:709-->
Enter the username you’re looking for, and the tool will show matching results. If you’re not sure of the exact name, start typing a few letters to filter and display profiles that match your search.

==== Using the filter ==== <!--T:421-->

<!--T:532-->
Next to the search bar, there is a filter icon. Click on it to open a pop-up window with some selection options.

<!--T:710-->
In the first option, you can filter by '''Capacities.''' Start typing the first few letters of a skill in the search box to quickly find matching capacities.

<!--T:711-->
As you type, matching results will appear in a list below the box. Click on a skill to add it to your search.

<!--T:712-->
You can select one capacity at a time, but you can add multiple capacities within the same search. Just click each capacity to include it in your filters.

<!--T:423-->
In '''Exchange with''', you can choose to display profiles with '''Learner''', '''Sharers''', and/or '''Proficients''' tags. To select one of the options, click on the check box. To clear it, click once more. The selected option will be highlighted.

<!--T:713-->
Enter the desired '''username''', and the tool will display matching results. If you’re unsure of the exact name, type a few letters to filter and show profiles that match your search.

<!--T:424-->
You can also filter profiles by '''Territories''', '''Affiliation''' and '''Languages'''. To select your options, click on '''Add territory''', '''Add affiliation''' or '''Add language''' to open a drop-down menu. Search for the desired option by scrolling down the list. If you are browsing on the desktop, you can also type to help with the search.

<!--T:425-->
Once you click on a name, it will be added to your filter and be highlighted. To delete a territory, affiliation or language from your list, click on the delete icon <tvar name="1">([[File:Delete (89608) - The Noun Project.svg|10px]])</tvar> on the right side of it.

<!--T:426-->
It is worth noting that, if you choose to filter profiles by [[<tvar name="1">Special:MyLanguage/Wikimedia regions</tvar>|region]], the tool will show you all the profiles that have this specific region and those that have countries contained by the region, according to [[<tvar name="2">Special:MyLanguage/Wikimedia regions</tvar>|2022 Wikimedia Foundation divisions]]. If you select to filter by a specific country, the tool will show you only the profiles that indicated it on their territories.

<!--T:427-->
For example, if you choose to filter profiles in the ''Latin America and the Caribbean'' region, the tool will show you all the profiles that have LAC on their territories, and also all those that have any country contained by the region. So, if a profile has ''Brazil'' or ''Argentina'' on its territories, it will be displayed in this case – because both countries are in LAC region. But if you choose to filter profiles in ''Brazil'', only those that have this specific country on their territories will be shown.

<!--T:429-->
To display the profiles filtered according to your selection, click on '''Show results'''. If you want to clear your choices, click on '''Clear all'''. To close the pop-up window, click on the arrow located at the upper left side of it or on '''Show results'''.</translate>
{{Collapse bottom}}
<translate>
== How to save profiles == <!--T:430-->

<!--T:533-->
It is possible to save profiles that you wish to exchange with, so you can contact them later, for example. You can do this from the cards in the [[<tvar name="1">:toolforge:capx/feed</tvar>|'''Explore''' feed]], from the user’s profile, or from the suggestion carousels on the [[<tvar name="2">:toolforge:capx/home</tvar>|logged-in home page]].

<!--T:431-->
'''Saved profiles''' is a page related to one specific user profile. It is private and shows all the profiles that account has saved on the '''Explore''' feed.

<!--T:432-->
To access your list, click on the hamburger button in the upper right corner of the screen and select '''Saved profiles''', or go directly to [[:toolforge:capx/feed/saved|capx.toolforge.org/feed/saved]].

<!--T:433-->
Inside the page, each saved profile is displayed in a card containing the profile's related image (logo, avatar, or photo), the username or the organization name, and two buttons.

<!--T:714-->
Click on '''View profile''' to access the page of the profile in question. Click on '''Delete item''' to remove that profile from your list of saved profiles. Users and organizations cannot know that they have been saved by someone else.

<!--T:434-->
To save a profile to your list, locate its card in the '''Explore''' feed or in the suggestion carousel on the '''homepage'''. At the base of the profile card in question, there will be a save icon (a little flag). Once you click on the save icon, the tool adds it to your '''Saved profiles''' list.

<!--T:715-->
You can also save a profile by accessing it directly via the user’s link or QR code. On the profile page, just below the username, there is a '''Save profile''' button similar to the one shown on user cards.

<!--T:435-->
When a profile is saved to your '''Saved Profiles''' list, the save icon remains filled. Clicking the icon again removes it from the list, and the icon returns to its empty state.

== How to report bugs == <!--T:437-->

<!--T:534-->
Bug Reports is a page linked to the user profile where users can report issues and suggest new features or improvements to the CapX development team. 

<!--T:716-->
Note that since July 2025, CapX has been in volunteer maintenance mode. As a result, bug fixes and updates may take longer to be addressed.

<!--T:438-->
To access it, click on the hamburger button in the upper right corner of the screen and select '''Bug Reports''', or go directly to <tvar name="1">[[:toolforge:capx/report bug|capx.toolforge.org/report_bug]]</tvar>.

<!--T:439-->
It provides a simple form composed of a title, a description, and the type of issue to be reported.

<!--T:440-->
In the first field, write a title for your report. Then, provide a brief and objective description of the issue you are reporting. Keep in mind that the CapX team will only have this text to understand what you are reporting and what needs to be done in the tool. To select the type of report you are creating, click on the field to open a drop-down menu. It is possible to choose from "Error", "New feature", "Improvement", or "Test case" by clicking on the chosen option.

<!--T:441-->
To send it, click on the '''Submit bug report''' button. If you want to discard the report, click on the '''Cancel report''' button.

<!--T:442-->
After submitting your report, it is possible to follow up on its status on the tab “Submissions”, by clicking on it at the top of the page.

<!--T:443-->
Reports are visible only to their creators and the CapX development team. They are displayed in boxes showing their title and status and a '''View''' button. By clicking on the button, you can access the report's Description, its type, and the dates of submission and update. Click on the '''Hide''' button to hide its details.

<!--T:444-->
It is not possible to withdraw a submitted report; only the development team can make changes to reports after they have been submitted by the user.

== How to send messages == <!--T:445-->

<!--T:535-->
The Capacity Exchange tool offers a channel for exchange between peers: the messaging service. Messages are sent through Meta-Wiki and, therefore, provide the same privacy and options.

<!--T:446-->
To access the feature, click on the hamburger button in the upper right corner of the screen and select '''Messages''', or go directly to <tvar name="1">[[:toolforge:capx/message|capx.toolforge.org/message]]</tvar>.

<!--T:447-->
You can also access the page by clicking on the '''Let's Talk''' button located at the bottom of each user profile page.

<!--T:448-->
The tool should be user-friendly and intuitive to navigate. If you want more information about how to use the '''Messages''' feature click on the link below.
</translate>

{{Collapse top|1=<translate><!--T:536--> Details on Messages feature</translate>}}
<translate>
=== Details on messaging users === <!--T:449-->

<!--T:537-->
On the '''Messages''' page, there are two tabs: '''Write''' and '''Sent'''.

<!--T:450-->
On the first tab, there is a contact form with the same options offered by the [[<tvar name="1">:mw:Special:EmailUser</tvar>|MediaWiki Special:EmailUser]] service - a special page on which a user can email another user and that is used to send CapX's messages.

<!--T:451-->
The first field on the form is '''From''', which will be automatically filled with the username you used to loggin to CapX. This field cannot be altered.

<!--T:452-->
The second field is '''To'''. If you have accessed the '''Messages''' page via the '''Let's Talk''' button, this item will show the username in question. If you have accessed the page directly, you should fill in this field with the username of who you want to message. In this case, be careful not to make any typing mistakes.

<!--T:717-->
The tool automatically checks whether a profile is available. If the user exists in CapX, an ''Available'' label appears in green next to their name. If not, a red ''User not found'' label is shown - in this case, check for typos. It also indicates when the only contact option is the talk page (for users without an email address) with a orange ''email unavailable'' label.

<!--T:453-->
Next, there is the '''Contact Method''' field where you can choose between ''Email'' and ''Talkpage'' from the drop-down menu that opens when you click the arrow icon ([[File:Down arrow icon.svg|11px]]). If both users, the sender ('''From''') and the recipient ('''To'''), have email addresses linked to their Wikimedia unified account, then the tool will show you both options to choose from. But if one of the parties does not have an email linked to their account, then you will only have the option to send it via the recipient's Talkpage.

<!--T:454-->
After selecting the contact method, you can write a '''Subject''' and the '''Message'''. In the first field, write a title for your message. Then, provide a brief and objective text to start the conversation with your peer. You can start with a greeting and a brief introduction before getting to the topic.

<!--T:455-->
Click on the '''Send message''' button to send it or on '''Clear message''' to delete it.

<!--T:456-->
Before the message is sent, a pop-up window will appear to confirm your decision of sending the message. This action cannot be undone. On the pop-up window, you will see information about how the message will be send. After reading it, click on the '''Cancel''' button to go back to the edition page, or on '''Confirm/Send''' to confirm your choice and send the message to the intended user.

<!--T:457-->
After sending the message, you will see another pop-up window congratulating you and explaining that you can see it on the '''Sent''' tab. Click on '''Close tab''' or '''Continue''' to close the window and go back to the '''Messages''' feature.

=== Sent messages === <!--T:458-->

<!--T:538-->
In the case of a message sent by email, you will receive a copy of it on your email by default. If you published the message on the user talkpage, it will be publicly available for you to see it whenever you want.

<!--T:459-->
In both cases, the user who receives the message can decide where to reply to it. If (and only if) the user replies to it by email, then their address will be disclosed to the sender, as is the case in the Meta-Wiki. If the user decides to keep the conversation on Wiki, their privacy will be maintained. The user can also choose to ignore the message and have the possibility of blocking another user, as it happens on Wikimedia – for more information, access [[<tvar name="1">:mw:Special:EmailUser</tvar>|MediaWiki Special:EmailUser]].

<!--T:460-->
All message logs are displayed in the '''Sent''' tab, within the Messages feature. It means that the tool doesn't store any information shared between the users, either in the message's subject or content.

<!--T:461-->
Messages saved are only available to the user in question, and are displayed in boxes showing to whom they were sent and their status (sent or error). When clicking on the '''View''' button, the user can see the contact method that was used and the date the message was sent. This information can be hidden when clicking on the '''Hide''' button.

<!--T:462-->
You can click on the '''Send a new message''' button at the bottom of the page to go back to the '''Write''' tab.

=== How to email through CapX? === <!--T:463-->

<!--T:539-->
It is only possible to email a CapX user if both users, the sender ('''From''') and the recipient ('''To'''), have email addresses linked to their Wikimedia account.

<!--T:718-->
The tool automatically checks whether a profile is available and whether it has an email linked to it. If the user exists and has a connected email, an ''Available'' label appears in green next to their name. If no email is available, an ''Email unavailable'' label appears in orange.

<!--T:464-->
This means that if the user you want to email does not have an email address registered to their Wikimedia account, you will not be able to contact them in this way.

<!--T:465-->
This also means that you must have an email address registered to your Wikimedia account as well. See [[<tvar name="1">:mw:Special:MyLanguage/Help:Preferences#Email options</tvar>|MediaWiki Help:Preferences]] for more information on how to do this.

=== Messages privacy === <!--T:466-->

<!--T:540-->
As previously stated, we do not store the content of the '''Messages''': neither the title nor the text.

<!--T:467-->
We also do not have access to the emails of users involved in the exchange. Emails are accessed through the Wikimedia messaging service and are, therefore, not stored in the CapX database.
</translate>
{{Collapse bottom}}
<translate>
== How to find an event == <!--T:746-->

<!--T:747-->
Events on CapX are listed on the '''Events''' page. It page can be accessed through the hamburger menu in the top-right corner of the screen or via the page’s direct link: <tvar name="1">[[toolforge:capx/events|capx.toolforge.org/events]]</tvar>.

<!--T:748-->
Currently, they can only be created by organization profiles. To learn how to create an event, see Section [[<tvar name="1">Capacity Exchange/User Guide#How to edit the organization profile</tvar>|How to edit the organization profile]] of this user guide.

<!--T:749-->
You can navigate the page by typing letters or keywords in the search field to filter the events, or by scrolling down to see all profiles that contain those letters/words.

<!--T:750-->
You can also filter events to find those that best match your interests and needs. To do so, click the filter icon located on the right side of the search bar.

<!--T:751-->
In the window that opens, select the '''Event format''' you want to view by checking the corresponding boxes. You can also search for '''Capacities''' by typing in the search field. As you type, matching skills will appear in a drop-down menu. Select the skills you want to include, then clear the search field to look for another skill. Repeat this process as many times as needed. Don't forget to click the '''Show Results''' button to view the events that match your interests and needs.

<!--T:752-->
If an event catches your attention, click the '''View Event''' button to be taken to its Meta-Wiki registration page, where you can learn more and sign up.

== How to join a Mentorship program == <!--T:753-->

<!--T:754-->
The '''Mentorship Programs''' page can be accessed through the hamburger menu in the top-right corner of the screen or via the page’s direct link: [[:toolforge:capx/mentorship|capx.toolforge.org/mentorship]].

<!--T:755-->
The pilot version of this feature is being developed in partnership with the Language Diversity Hub, the EduWiki Hub, the African Wiki Women initiative, and the Wikimedia Brazil chapter. To have your mentorship program included in CapX, please contact <tvar name="1">capx{{@}}wmnobrasil.org</tvar> to check the possibility.

<!--T:756-->
Each of the four programs is shown as a card with the initiative’s logo, key details, and a '''Subscribe''' button. At the top, you’ll see the program’s location, followed by the ''Registration period'', which sets its status as ''open, upcoming, or closed''. Each card shows a short description, the format (in-person, online, or hybrid), key ''Capacities'', available ''Languages'', and the number of ''subscribers''.

<!--T:757-->
Click the '''Subscribe''' button, then select your role as '''Mentor''' or '''Mentee'''. To close the window, click '''Close tab.'''

<!--T:758-->
Each program has its own application form with questions tailored to its needs. Questions marked with a red asterisk (*) are required to submit your application. The form language is set by the organizing initiative and unfortunately cannot be translated by CapX translation tools.

<!--T:759-->
When you finish, click '''Subscribe''' to submit your application, or '''Close''' to close the window and discard your changes. The information you provide is stored in the CapX database in encrypted form and can only be accessed using a public key held by the partner. The mentorship program coordinator will then contact you using the details provided in the form.

== How to navigate the Organization List == <!--T:760-->

<!--T:761-->
The list of organizations, along with the events page and the policy page, makes up the set of CapX information available to non-logged-in users. However, to access the organization profile, you need to be logged in.

<!--T:762-->
To access this feature, click on '''Organization list''' button at the top of the logged-out homepage, or in the menu on the right side of the tool after logging in. It is also possible to access it directly via the link: [[:toolforge:capx/organization list|capx.toolforge.org/organization_list]].

<!--T:763-->
It contains cards for the organizations that have requested the creation of their profiles. In the absence of a responsible administrator for a profile, it will not be visible in the list. Access the item [[Capacity Exchange/User Guide#How to edit the organization profile|''How to edit the organization profile'']] in this user guide for more information on how to request and edit your organization’s profile.

<!--T:764-->
Currently, users can browse and filter organization profiles by their names, skills, by their status as ''learner'' or ''Sharers'' and by their informed territories.

<!--T:765-->
Organization profiles are displayed in cards that may contain the following items, depending of their availability on the profile in question:</translate>
* <translate><!--T:766--> an image of the organization logo;</translate>
* <translate><!--T:767--> an indication of the nature of the wanted exchange (sharer; learner);</translate>
* <translate><!--T:768--> the organization name (in English or your preferred language);</translate>
* <translate><!--T:769--> the skills;</translate>
* <translate><!--T:770--> the territory indicated on the profile;</translate>
* <translate><!--T:771--> an icon that redirects to the profile in question;</translate>
<translate>
<!--T:772-->
You can navigate the page by typing letters in the search field to filter the profiles by their names or by scrolling down to see all profiles existent in CapX.

<!--T:773-->
The tool should be user-friendly and intuitive to navigate. If you want more information about how to navigate the '''Organization list''' click on the link below.
</translate>
{{Collapse top|1=<translate><!--T:774--> Details on Organization list design</translate>}}
<translate>
=== Details of the profile cards === <!--T:775-->

==== Image, name, languages and territory ==== <!--T:776-->

<!--T:777-->
The image, name, languages and territories shown on the cards are pulled from the profile in question.

==== Nature of the exchange ==== <!--T:778-->

<!--T:779-->
Cards display skills grouped into two categories: '''wanted or available''', based on what the organization has selected on their profile.

<!--T:780-->
'''Learner''' is a tag for profiles that have selected skills as '''Wanted.''' It indicates a organization that is looking to connect with others who can share specific skills. These capacities appear in red on the right side of the card.

<!--T:781-->
'''Sharer''' is a tag for profiles that have selected skills as '''Available.''' It represents a organization that is willing to teach or share those skills. These capacities appear in green on the right side of the card.

==== Wanted, Available and Known capacities ==== <!--T:782-->

<!--T:783-->
The '''Wanted and Available capacities''' shown on the cards are those indicated on the organization profile in question.

<!--T:784-->
These will be used to add the tags '''Sharer and/or Learner''' to the organization profile card and filter those according to your needs.

==== Profile icon ==== <!--T:785-->

<!--T:786-->
Click the circular profile icon or the profile image to open that organization profile page.

=== Details on the filter === <!--T:787-->

<!--T:788-->
You can filter the organization profiles to look for those who match your needs.

==== Filter by name (search bar) ==== <!--T:789-->

<!--T:790-->
The first possible way is to filter by the organization name.

<!--T:791-->
To do that, click on the search bar at the top of the '''Organization list''' page. 

<!--T:792-->
Enter the organization name you’re looking for, and the tool will show matching results. If you’re not sure of the exact name, start typing a few letters to filter and display profiles that match your search.

==== Using the filter ==== <!--T:793-->

<!--T:794-->
Next to the search bar, there is a filter icon. Click on it to open a pop-up window with some selection options.

<!--T:795-->
In the first option, you can filter by '''Capacities.''' Start typing the first few letters of a skill in the search box to quickly find matching capacities.

<!--T:796-->
As you type, matching results will appear in a list below the box. Click on a skill to add it to your search.

<!--T:797-->
You can select one capacity at a time, but you can add multiple capacities within the same search. Just click each capacity to include it in your filters.

<!--T:798-->
In '''Exchange with''', you can choose to display profiles with '''Learner''' and/or '''Sharers''' tags. To select one of the options, click on the check box. To clear it, click once more. The selected option will be highlighted.

<!--T:799-->
You can also filter profiles by '''Territories'''. To select your options click on '''Add territory''' to open a drop-down menu. Search for the desired option by scrolling down the list. If you are browsing on the desktop, you can also type to help with the search.

<!--T:800-->
Once you click on a territory name, it will be added to your filter and be highlighted. To delete it from your list, click on the delete icon <tvar name="1">([[File:Delete (89608) - The Noun Project.svg|10px]])</tvar> on the right side of it.

<!--T:801-->
To display the profiles filtered according to your selection, click on '''Show results'''. If you want to clear your choices, click on '''Clear all'''. To close the pop-up window, click on the arrow located at the upper left side of it or on '''Show results'''.</translate>
{{Collapse bottom}}
<translate>
== How to navigate Data in CapX == <!--T:802-->

<!--T:803-->
You can explore CapX data on the homepage or in the '''Data Analytics''' page. To access it, go to the hamburger menu in the top-right corner, select '''View statistics''' button on the homepage, or use the direct link: [[:toolforge:capx/data_analytics_dashboard|capx.toolforge.org/data_analytics_dashboard]].

<!--T:804-->
The '''Data analytics''' page displays real-time data from the tool’s database. At the top, you can see the ''Total number of users'', how many ''New users'' have joined in the last 30 days, and the total ''number of messages exchanged'' since the feature’s creation.

<!--T:805-->
Below this data, you will find a map visualization: the interactive map '''Wikimedians through the globe''', colored according to data density. It is possible to explore the CapX database by filtering the number of ''Wikimedians, Languages, and Capacities'' across each of the eight Wikimedia territories. 

<!--T:806-->
If you want more information about how to navigate the '''Wikimedians through the globe''' click on the link below.
</translate>
{{Collapse top|1=<translate><!--T:807--> Details on Density Map design</translate>}}
<translate>
<!--T:808-->
It’s important to note that the data reflects CapX’s database. For the map to accurately represent ''Wikimedians across all territories'', community participation is essential. Encouraging users to complete their profiles helps improve coverage and accuracy. And, with more complete data, the map becomes a valuable tool for strategic planning and for understanding capacity-building needs across the movement.

<!--T:809-->
The map '''Wikimedians through the globe''' is based on an updated SVG from Wikimedia Commons, designed to better reflect territorial proportions according to community consensus. It also includes an option to flip the map orientation (north or south up), reflecting decolonial perspectives and inspired by Joaquín Torres García’s 1943 work América Invertida.

<!--T:810-->
The default tab is '''Wikimedians''', which shows ''Wikimedian Density by Territory''. Clicking on the map opens a card with details for the selected region, and you can also access these cards by clicking the region name below the map.

<!--T:811-->
The card shows the number of countries in the territory and how many CapX Wikimedians have declared they are located there. It also includes the five ''Most Spoken Languages'', with the number in parentheses indicating how many users speak each language in that region, followed by the five ''Top Capacities''', including data on known and wanted skills. The density legend shows the region with the highest number of declared users.

<!--T:812-->
Click the '''Languages''' tab above the map to open the ''Languages by Territory'' view. Use ''Select a language'' to open the dropdown menu and choose a language. The map will then show the distribution of speakers across regions. Click a region to open its card with detailed language information. The density legend shows the region with the highest number of declared speakers.

<!--T:813-->
Click the '''Capacities''' tab above the map to open the ''Capacities by Territory'' view. Use ''Select a capacity'' to open the dropdown menu and choose a skill. When you select a skill, the map will display color density based on the location of users who have that skill in each region. On the right side of the selection, you can choose the view ''Type'' ('''All capacities, Known, Available or Wanted''') to see specific information. Click a region to open its card with detailed skill information.

<!--T:814-->
Note that when you switch between the map tabs, the page data is also filtered to show only the information related to languages or capacities. To view all data again, return to the first tab on the map, '''Wikimedians'''.</translate>
{{Collapse bottom}}
<translate>
<!--T:815-->
Below the map, you can access data on '''Languages, Territory''', and '''Capacities''' as declared by CapX users. Click the arrow icon ([[File:Down arrow icon.svg|11px]]) next to the topic name to expand and view the related information.

<!--T:816-->
In '''Languages''', you’ll see a list of the most spoken languages and the number of Wikimedians who have declared them. To view more languages, click the '''Load more results +''' button.

<!--T:817-->
In '''Territory''', you’ll see a list of territories ranked by Wikimedian concentration. Next to each of the eight territories, you can see how many users have declared being located there.

<!--T:818-->
In '''Capacities''', you can see the number of users who have marked skills as either ''Available'' or ''Wanted'', grouped into the seven main categories. ''Learners'' are users who have marked skills in that category as ''Wanted'', while ''Sharers'' are users who have marked skills as ''Available''.

<!--T:819-->
You can also have access to the full database by establishing a partnership with CapX. For more information, please contact capx{{@}}wmnobrasil.org.
</translate>
<translate>
== How to translate the tool == <!--T:468-->

<!--T:541-->
Being integrated with [<tvar name="1">https://translatewiki.net/wiki/Translating:CapacityExchange</tvar> TranslateWiki], Metabase and Wikidata the tool can be easily translated into any language. 

<!--T:469-->
It is worth noting that translations may take a few days to be available in the tool, especially on the software interface, so take that into consideration if you’re planning a community event, for example.

<!--T:470-->
Another important information is that data pulled from Wikimedia Projects must be translated from the source - Metabase and Wikidata. The TranslateWiki platform allows the translation of the software, but not contents pulled from Wikimedia Projects such as the organization profile's Documents and Main Projects, or the name of the languages displayed on the CapX's profiles. You can translate the names and descriptions in the Capacity Directory using the [[:<tvar name="1">toolforge:capx/translation</tvar>|'''Translate!''']] page, available in the top-right hamburger menu. More details on how to translate skills and their descriptions are provided below.

<!--T:563-->
You are also invited to translate Capacity Exchange Meta-wiki {{tl|CapacityExchange}} user template by clicking on the call for action '''Help translate this section''' at the top of the box on a user profile.

<!--T:471-->
Every wikimedian is welcomed to translate the tool, either on its software level (through [https://translatewiki.net/wiki/Translating:CapacityExchange TranslateWiki]), and on the data pulled from Wikimedia Projects (translating its Metabase, Wikidata and Wikimedia Commons items). This means that, to make Capacity Exchange available in multiple languages, wikimedians are also contributing to the translation of other instances of the Movement.

<!--T:472-->
If you don't know how to translate it, click on the link below for a step-by-step tutorial.
</translate>

{{Collapse_top|1=<translate><!--T:542--> Details on how to translate the CapX</translate>}}
<translate>
=== How to translate the software on TranslateWiki === <!--T:473-->

<!--T:543-->
Go to the [<tvar name="1">https://translatewiki.net/wiki/Translating:CapacityExchange</tvar> Capacity Exchange page on TranslateWiki] and click on the '''Translate this project''' button on the upper left side of the page.

<!--T:474-->
Remember to log in with your Wikimedia account to register your contributions.

<!--T:475-->
By clicking on the button, you will have access to the tool for translating the original content (in English) into the default language of your Wikimedia account.

<!--T:476-->
If your default language is English, you will see the following message: ''The source language of this group is English. Please select another language to translate into.'' Then, click on the arrow icon ([[File:Down arrow icon.svg|11px]]) in the upper right corner of the screen, next to the text '''Translate to'''. Change the language from English to the language you want to translate by choosing from the drop-down list. You can type the name to make it easier to search. When you find the language you want, click on it.

<!--T:477-->
You will be redirected to the page for the translation to the language in question. At the top of the screen, there are four tabs: '''All, Untranslated, Outdated and Translated'''. Click on '''Untranslated''' to start your contributions.

<!--T:478-->
The translation tool is quite intuitive, so just follow the instructions on the screen. The messages to be translated are always separated by sentences or small paragraphs. At the end of each translation, don't forget to click on '''Publish translation''' to publish your contribution. It is worth noting that translations take a few days to be available in the tool.

<!--T:479-->
You may want to access [[<tvar name="1">:mw:Special:MyLanguage/Help:Extension:Translate</tvar>|the translation help page on MediaWiki]] or [<tvar name="2">https://translatewiki.net/wiki/Localisation_guidelines</tvar> TranslateWiki Localisation Guidelines] for more information.

=== How to translate the capacities from the Capacity Directory === <!--T:480-->

<!--T:544-->
The names and descriptions of the Capacity Directory are pulled from [<tvar name="1">https://metabase.wikibase.cloud/wiki/Main_Page></tvar> Metabase] and [[<tvar name="2">:d:Special:MyLanguage/Wikidata:Introduction</tvar>|Wikidata]]. Therefore, in order to pull the translated content, it must exist translated in the respective databases.

<!--T:564-->
If you click on the information icon (<tvar name="1">[[File:Information-icon.svg|13px]]</tvar>) of a capacity, a new tab will appear below the box with the capacity's clickable [<tvar name="2">https://metabase.wikibase.cloud/wiki/Main_Page</tvar> Metabase QID link], the [[<tvar name="3">:d:Special:MyLanguage/Wikidata:Introduction</tvar>|Wikidata QID link]], its description (that can be pulled from Metabase or Wikidata), and an two '''Add''' buttons. 

<!--T:565-->
If the capacity information is not available in your selected language, you will also see a "call to action" box saying '''Translation needed'''. Then, a message: "Don't see this capacity in your selected language? Help us translate it on Metabase!" followed by a clickable link '''Contribute'''. Click to open a window where you can add information in your profile’s display language. 

<!--T:719-->
You can also connect your Metabase account at the top of the window to associate edits with your username by clicking the '''Connect Metabase''' button.

<!--T:720-->
The ''Add translation'' window shows the skill name in English at the top, followed by the target language code. Enter the translated title and description in the fields provided. The original English text is displayed below for reference.

<!--T:721-->
To save your changes, click '''Save translation'''. To discard them, click '''Cancel'''.

<!--T:481-->
You can also access each item and translate them manually on Metabase and Wikidata by clicking on their respective QID links. Or you can translate all capacities at a time at the [[<tvar name="1">:toolforge:capx/translation</tvar>|CapX '''Translate!''']] page.

=== How to use the Translate! page=== <!--T:722-->

<!--T:723-->
You can translate all skills into a specific language at once using the [[<tvar name="1">:toolforge:capx/translation</tvar>|CapX '''Translate!''']] page.

<!--T:724-->
You can access the resource page either from the hamburger menu in the top-right corner of the page or via the direct link [[<tvar name="1">:toolforge:capx/translation</tvar>|https://capx.toolforge.org/translation]].

<!--T:725-->
On this page, changes are automatically applied to Metabase using a dedicated bot. To associate translations with your Metabase username, click '''Connect Metabase''' button to link your account. A pop-up will open where you can sign in to Metabase and grant permission for the tool to make changes on your behalf. Click '''Allow''' to proceed, and than '''Close window''', or '''Cancel''' to stop.

<!--T:726-->
If your account is connected, the box will turn green and show: ''Connected to Metabase as USERNAME. Edits will be attributed to you.'' To disconnect, click '''Disconnect''' in the right corner of the box.

<!--T:727-->
In the top bar, select the ''target language'' from the dropdown menu. You can also ''search'' for a specific skill by typing keywords, ''sort'' results alphabetically (A–Z or Z–A), and choose to ''show first'' translated or untranslated items. Click '''Refresh''' to apply your selected filters.

<!--T:728-->
The skills are displayed as cards. On the left side, each card shows the corresponding Metabase QID, the reference language (English), and the ''label'' and ''description'' in that reference language. On the right side of each card, you can enter the ''translation'' for the ''label'' and ''description'' in the target language. When finished, click '''Save''' to store your changes.

<!--T:729-->
Cards with unsaved changes will show a purple ''Edited'' tag in the top-left corner as a reminder. The counter in the top-right corner tracks your progress, showing how many skills have been translated and how many changes are still unsaved.

===How to translate Meta-wiki userbox?=== <!--T:571-->

<!--T:572-->
Users on Meta-wiki that have inserted the userbox module <nowiki>{{CapacityExchange}}</nowiki> in their pages will see a special userbox on it. 

<!--T:573-->
At the top of this userbox, one can read, '''"Help translate this section"'''. Click on each link to contribute to the CapX translation through Meta-wiki.

<!--T:576-->
By clicking on the link, you will have access to the tool for translating the original content (in English) into the default language of your Wikimedia account through the translation tool of the Meta-wiki project. Remember to log in with your Wikimedia account to register your contributions.

<!--T:577-->
If your default language is English, you will see the following message: The source language of this group is English. Please select another language to translate into. Then, click on the arrow icon ([[File:Down arrow icon.svg|11px]]) in the upper right corner of the screen, next to the text "Translate to". Change the language from English to the language you want to translate by choosing from the drop-down list. You can type the name to make it easier to search. When you find the language you want, click on it.

<!--T:578-->
You will be redirected to the page for the translation to the language in question. At the top of the screen, there are four tabs: '''All''', '''Untranslated''', '''Outdated''' and '''Translated'''. Click on '''Untranslated''' to start your contributions.

<!--T:579-->
The translation tool is quite intuitive, so just follow the instructions on the screen. The messages to be translated are always separated by sentences or small paragraphs. At the end of each translation, don't forget to click on the '''Publish translation''' button to publish your contribution.
</translate>
{{Collapse bottom}}

[[Category:The Capacity Exchange{{#translation:}}]]