feedshift docsconfigure a feed
every feed has three tabs of settings: destination, filters, and display. for the dashboard walkthrough, see configure a feed in the dashboard.
destination is where posts land. text channels, announcement channels, threads, and forum posts are all valid. change at any time, future posts go to the new place.
filters
decides which posts get delivered.
- content types: post, reply, repost/retweet, quote. uncheck what you don't want.
- media types: image, video, gif. each row can be set to
require(only deliver posts containing it),block(drop posts containing it), or left alone. - require keywords: only post when at least one keyword matches the content.
- block keywords: drop posts containing any listed keyword.
require runs before block when both are set.
display
controls how the discord message looks.
- custom avatar and custom name override the message author. avatar is set per-server in server settings.
- text is the main message body. supports markdown and go-style templates (see below).
- header (simple display mode, premium or pro) is a line above the body; it uses a smaller template context than advanced mode (see below).
- append sends extras (links, media) as separate items below the main message.
- embeds controls the rich post embed. premium or pro can also build custom embeds.
- reactions auto-add like/repost/reply reactions to delivered messages.
- truncate content keeps long posts within discord's character limit instead of dropping them.
- resolve shortened urls expands
t.coand similar so previews look clean. - role ping mentions a role on every delivered post. premium or pro, fires on every post.
templates (display fields)
delivery uses go text/template syntax: a leading dot is the data root, field names are capitalized like in go (Author, not author). examples that work: {{.Post.Author.Name}}, {{.Post.Link}}. forms like {{Post.author}} or {user} are not supported.
where this applies
- advanced display (custom message + embeds): any string you can edit there (webhook name, message text, and embed title, description, url, author name/url/icon url, footer text/icon url, timestamp, image / thumbnail urls, and embed field name/value) can include templates.
- simple display, plus header only: a separate, smaller context (below). it does not use
.Post/.RefPost. - rss / youtube (feed) feeds in advanced mode: message content templates only get the rss-specific fields below (not
.Post). the simple header on rss is not wired to post data today.
x / twitter and bluesky (advanced mode)
these share the same path names for the main and referenced post. .RefPost is only present when the event has a referenced post (reply / quote / repost chain).
| path | meaning |
|---|---|
{{.Post.Title}} | label for the event (post vs repost vs quote vs reply wording from branding) |
{{.Post.Author.Name}} | display name |
{{.Post.Author.Handle}} | handle (without @) |
{{.Post.Author.AvatarURL}} | avatar image url |
{{.Post.Author.URL}} | profile url on the platform |
{{.Post.Author.Link}} | same as url in practice |
{{.Post.ID}} | post id (format varies by platform) |
{{.Post.Timestamp}} | time in rfc3339 |
{{.Post.PlainText}} | raw text |
{{.Post.Text}} | text after link expansion / rich formatting used for display |
{{.Post.Link}} | url of the post |
{{.Post.Media.Photos}} | space-separated image urls (also splittable with range; each entry is a url string) |
{{.Post.Media.Videos}} | video urls |
{{.Post.Media.GIFs}} | gif urls |
use {{.RefPost.…}} with the same suffixes for the referenced post when it exists.
root extras
| path | meaning |
|---|---|
{{.Custom.Name}} / {{.Custom.ImageURL}} | custom webhook author from server branding |
{{.Branding.IconURL}} | branding icon (often used in embed footers) |
{{.Branding.URL}} | site base url for the platform |
{{.Author.Name}}, {{.Author.Handle}}, {{.Author.Avatar}} | raw author object on x (parallel to post author; avatar field is Avatar here) |
bluesky only: {{.Event}} is a short event label (e.g. post vs repost).
simple mode header (x, premium or pro)
template data is flat: {{.Author.Name}}, {{.Author.Handle}}, {{.Author.Avatar}}, {{.ID}}, {{.Text}}, {{.Link}}, {{.RLink}} (referenced url when present), {{.Action}} (action line text).
rss / youtube (advanced message content only)
| path | meaning |
|---|---|
{{.Text}} | item body converted for discord markdown |
{{.Title}} | item title |
{{.Link}} | item link |
{{.Description}} | raw description |
{{.Published}} / {{.Updated}} | time.Time values from the feed item |
factory defaults sometimes show {{.Post.…}} or {{.Links}}; those match x-style workers. for rss, use the fields in this table so templates resolve when the item is delivered.
message interactions
premium and pro add buttons to delivered messages so anyone with a linked account can like, repost, or reply without leaving discord.