Find your Site URL
The Site URL is the address visitors use to open your WordPress site.
- Sign in to your WordPress dashboard, usually at
https://{host}/wp-admin, and navigate to Settings > General. - Copy the Site Address (URL). On a site whose WordPress files sit in a sub-folder, this can differ from the WordPress Address (URL) above it, so use the Site Address (URL).
- Format:
https://{host}orhttps://{host}/{folder} - Example:
https://blog.example.com - A site served from a sub-folder keeps its folder, for example
https://example.com/blog. - On a multisite network, Settings > General shows no address. Navigate to My Sites > Network Admin > Sites, select Edit under the site this connection reads, and copy its Site Address (URL) from the Info tab.
- A trailing slash,
/wp-adminor/wp-jsonis ignored, and the connection always uses https. The connection works with any permalink setting. - The address must be a plain host name with a dot, an optional port and path, and no username, spaces or other characters, otherwise the connection fails.
- Paste it into the Site URL field in StackOne Hub.
Create the Application Password
An Application Password lets StackOne read your site’s users through the REST API without your real password. It carries the permissions of the Administrator who creates it.
Sign in to WordPress
Sign in to your WordPress dashboard, usually at https://{host}/wp-admin, as an Administrator, or as a Super Admin on a network.
- Navigate to Users > Profile.
- Scroll to Application Passwords.
- If the section shows “The application password feature requires HTTPS, which is not enabled on this site.”, the site is not served over https and cannot connect.
- If it shows “Your website appears to use Basic Authentication, which is not currently compatible with Application Passwords.”, the site sits behind a server password prompt, which blocks Application Passwords.
- If the section is missing, a security plugin or the site host has turned Application Passwords off.
Name the password
Type a name in New Application Password Name.
- New Application Password Name:
StackOne Integration
Add the password
Click Add Application Password.
- On WordPress versions before 6.8 the button reads Add New Application Password.
Copy the password
Copy the new password with the Copy button and store it securely for use later.
- The password is shown only once. WordPress says “Be sure to save this in a safe location. You will not be able to retrieve it.”
- On WordPress versions before 6.7 there is no Copy button. Select the password in the box and copy it.
- Paste it into the Application Password field in StackOne Hub, with or without the spaces.
Find your Username
The Username is the login of the Administrator who created the password. An email address also works.
- Navigate to Users > Profile and copy the Username at the top of the page.
- Paste it into the Username field in StackOne Hub.
Know what a smaller role breaks
StackOne reads every user on the site, including their roles and directly granted capabilities, and reads each user’s Application Password names and dates, never the passwords themselves. Only an Administrator can do that.
- A user with another role is refused, and the connection test fails with a message that names the Administrator requirement.
- On a multisite network a site Administrator sees only part of the user list. The connection test then fails and asks for a Super Admin’s Application Password.
- A wrong Username, a wrong password or a revoked password all fail with the same answer from WordPress. Check all three if the connection is refused.
Revoke the password
To stop StackOne from reading your site, revoke the Application Password. The connection then fails until you paste a new one into StackOne Hub.
- Navigate to Users > Profile and scroll to Application Passwords.
- Click Revoke next to the password named
StackOne Integration. The Last Used column shows when it was last used. - Revoke all application passwords removes every password for that user, including ones other tools use.
Linking the Account from the Hub
Navigate to the Hub
Fill out the fields
- Site URL
- Username
- Application Password
Connect
- Click Connect
- If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
- Once authorization is successful, you will see a confirmation popup
If the account linking is successful, you will see the newly linked account on your Accounts page.