diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/api/swagger.yaml | 16 | ||||
| -rw-r--r-- | docs/user_guide/settings.md | 20 |
2 files changed, 36 insertions, 0 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml index 8d11ba7da..07c939188 100644 --- a/docs/api/swagger.yaml +++ b/docs/api/swagger.yaml @@ -157,6 +157,14 @@ definitions: description: The default posting content type for new statuses. type: string x-go-name: StatusContentType + web_visibility: + description: |- + Visibility level(s) of posts to show for this account via the web api. + "public" = default, show only Public visibility posts on the web. + "unlisted" = show Public *and* Unlisted visibility posts on the web. + "none" = show no posts on the web, not even Public ones. + type: string + x-go-name: WebVisibility title: Source represents display or publishing preferences of user's own account. type: object x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model @@ -4400,6 +4408,14 @@ paths: in: formData name: hide_collections type: boolean + - description: |- + Posts to show on the web view of the account. + "public": default, show only Public visibility posts on the web. + "unlisted": show Public *and* Unlisted visibility posts on the web. + "none": show no posts on the web, not even Public ones. + in: formData + name: web_visibility + type: string - description: Name of 1st profile field to be added to this account's profile. (The index may be any string; add more indexes to send more fields.) in: formData name: fields_attributes[0][name] diff --git a/docs/user_guide/settings.md b/docs/user_guide/settings.md index ed069c19c..66452578d 100644 --- a/docs/user_guide/settings.md +++ b/docs/user_guide/settings.md @@ -76,6 +76,26 @@ Some examples: ### Visibility and Privacy +#### Visibility Level of Posts to Show on Your Profile + +Using this dropdown, you can choose what visibility level(s) of posts should be shown on the public web view of your profile, and served in your RSS feed (if you have enabled RSS). + +**By default, GoToSocial shows only Public visibility posts on the web view of your profile, not Unlisted.** You can adjust this setting to also show Unlisted visibility posts on your profile, which is similar to the default for other ActivityPub softwares like Mastodon etc. + +You can also choose to show no posts at all on the web view of your profile. This allows you to write posts without having to worry about scrapers, rubberneckers, and other nosy parkers visiting your web profile and looking at your posts. + +This setting does not affect visibility of your posts over the ActivityPub protocol, so even if you choose to show no posts on your public web profile, others will be able to see your posts in their client if they follow you, and/or have your posts boosted onto their timeline, use a link to search a post of yours, etc. + +!!! warning + Be aware that changes to this setting also apply retroactively. + + That is, if you previously made a post on Unlisted visibility, while set to show only Public posts on your profile, and you change this setting to show Public and Unlisted, then the Unlisted post you previously made will be visible on your profile alongside your Public posts. + + Likewise, if you change this setting to show no posts, then all your posts will be hidden from your profile, regardless of when you created them, and what this option was set to at the time. This will apply until you change this setting again. + +!!! tip + Alongside (domain-)blocking, this is a good "emergency" setting to use if you're facing harassment from people trawling through your public posts. It won't hide your posts from people who can see them in their clients, via ActivityPub, but it will at least prevent them from being able to click through your posts in their browser with no authentication, and easily share them with others with a URL. + #### Manually Approve Follow Requests (aka Lock Your Account) This checkbox allows you to decide whether or not you want to manually review follow requests to your account. |