Your links & the snippet

Approve or dismiss

Open a place in Suggestions and decide on it:

• Approve keeps the link. It moves to Your links and, with the link snippet on your site, goes live on the source page.
• Dismiss drops it. The pair is never suggested again, unless you restore it.

A decision belongs to the project, not to one crawl: it is stored by the two pages' addresses, so later crawls know it. Decided links leave the suggestion list and take no place in it.

Your links

Your links sits under Improve in the views rail, with three lists:

Approved

The links you approved, and the ones your site now carries in its own HTML.

Needs a look

Approved links a newer crawl found a problem with: the sentence changed, or a page is gone, moved or set to noindex.

Dismissed

The links you dismissed. Restore one to have it suggested again.

A badge on each link says where it stands:

approved

Approved, waiting for the snippet to be seen on your site.

live via snippet

The snippet writes it into the source page.

add by hand

The anchor words are not in the page text, so the snippet cannot place it. Add it in your CMS.

in your HTML

The source page links to the target in its own HTML now. Nothing left to do.

needs a look

See below.

Remove takes an approved link back: the snippet stops writing it, and the pair can be suggested again.

The link snippet

The snippet is one script tag that writes your approved links into your pages, in the browser, so you do not edit the pages themselves. It works on any site, whatever it is built with.

1. Get the tag. A new project offers it right after it is created; later it is under Link snippet on the project page. It looks like this:<script src="https://cdn.linktaste.com/snippet.js" data-key="…" defer></script>
2. Add it to every page of the site, before </body>, for example in your theme's footer template.
3. Choose Test the connection. It reads one of your pages and says whether the tag is there and how many approved links it writes into that page. Every crawl looks for the tag as well.

On each page, for each link approved for it, the snippet:

• finds the sentence the link was approved for and links the first place the anchor words appear in it.
• never touches text inside a link, a button, a heading, the navigation, the header or the footer.
• adds nothing when the sentence is gone, or when the page already links to the target.
• marks each link it adds with a data-linktaste attribute.

A link you approve is published to the snippet shortly after, and a link you remove is taken out the same way. Once a crawl has seen the tag, the links it writes are counted in the analysis like links in your HTML.

After the next crawl

Each crawl checks your approved links against the site as it is now. A link the site carries itself moves to in your HTML. A link that cannot stay as approved moves to Needs a look, with the reason:

• The sentence is gone. When the source page still has a fitting place for the link, it is shown; Approve new placement takes it.
• The target moved. Link to the new address points the link at the page the old address redirects to.
• A page is gone, redirects, or the target is set to noindex. Remove the link, or keep it while you fix the page.

The crawl card on the project page lists what changed since the previous crawl: new suggestions, approved links that need a look or are in your HTML now, and new, changed and gone pages. The email at the end of a crawl says the same. In Suggestions, New since last crawl shows only the suggestions the previous crawl did not have.

Crawl on a schedule

Under Schedule on the project page, a project can crawl itself every week or every month, so your approved links stay checked and new pages get their suggestions. A scheduled crawl uses your page budget like one started by hand; when the budget is used up it is skipped and you get an email. See Plans & limits.