Back to Tag-guidelines

CSS ComponentThe latest version of this package is: 16.0.28, Opens in new window

Use tags to label, categorize, or organize items using keywords that describe them.

This component provides .css, .styl, .less and .scss -files.

To be able to install this component, please refer to the Project Setup documentation.

$ npm i @ids-core/tag@16.0.28

Table of Contents

Edit this section, Opens in new window


Default markup

Here is the default tag implementation code for HTML. Features implementation code is listed next to each feature element.

<ul class="if tags">
  <li class="if">
    <button class="if tag" aria-label="Remove Orwell from the list">


Tags can have different, predefined, colors to emphasize:

<a href="/sadsd" class="if tag [aquamarine|mint|yellow|pink]">

Category tag

Filter tag

Input tag

Status tag


A status tag is a tag that is put by itself in another context, for example to label the status of an invoice etc. You should not wrap it in a list, since it is only natural to have one occurence of this tag.

  • Error
  • Success
<ul class="if tags">
  <li class="if">
    <span class="if tag status error">
  <li class="if">
    <span class="if tag status error">

Do not put status tags in a list

<span class="if tag status error">
Place a status tag as a standalone element in the context.
Edit this section, Opens in new window


All of the tokens can be used as preprocessor and CSS variables

Tag tokens

Name Value Is aliased in
url("data:image/svg+xml,%3Csvg xmlns=%27 viewBox=%270 0 32 32%27%3E%3Ctitle%3Ee remove%3C/title%3E%3Cg class=%27nc-icon-wrapper%27 stroke-linecap=%27square%27 stroke-linejoin=%27miter%27 stroke-width=%275%27 fill=%27%23faf9f7%27 stroke=%27%23faf9f7%27%3E%3Cline fill=%27none%27 stroke=%27%23faf9f7%27 stroke-miterlimit=%2710%27 x1=%2727%27 y1=%275%27 x2=%275%27 y2=%2727%27/%3E%3Cline fill=%27none%27 stroke=%27%23faf9f7%27 stroke-miterlimit=%2710%27 x1=%2727%27 y1=%2727%27 x2=%275%27 y2=%275%27/%3E%3C/g%3E%3C/svg%3E")
0 1rem
0 2.5rem 0 1rem
rgb(51, 30, 17)
rgb(232, 224, 217)
rgb(151, 226, 247)
rgb(181, 237, 232)
rgb(255, 224, 130)
rgb(255, 201, 166)
rgb(252, 199, 79)
rgb(187, 50, 12)
rgb(33, 115, 49)
rgb(110, 98, 94)
rgb(0, 84, 240)
rgb(51, 30, 17)
rgb(51, 30, 17)
rgb(250, 249, 247)
rgb(250, 249, 247)
rgb(110, 98, 94)
rgb(250, 249, 247)
rgb(0, 64, 128)
Edit this section, Opens in new window


Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

14.22.2 (2022-05-03)

Miscellaneous chores

  • package locks: update package locks (813eac7)
  • update deps: package locks updates (38e7a90)

14.21.0 (2022-04-19)


Miscellaneous chores

  • ๐Ÿค– Convert examples to MDX for Tag (9689f80) , closes #584025

14.20.1 (2022-04-19)

Miscellaneous chores

  • changelog: regenerate all files (64ab385) , closes #586342
  • changelog: regenerate all changelogs after updating changelog generation (70789c9) , closes #587270

14.18.3 (2022-04-13)

Bug Fixes

  • changelog: generate new files for root and packages (349fda4) , closes #586063 . We regenerate the files to include all relevant commits and to use conventional-commits at 100%

14.16.0 (2022-04-07)

Bug Fixes

  • ๐Ÿ› Add missing imports for global CSS Variables (fbf6f06) , closes #582437

14.9.0 (2022-03-03)

Miscellaneous chores

14.8.1 (2022-02-23)

Bug Fixes

  • ๐Ÿ› Add missing imports of typography CSS variables (e716c65) , closes #559412

reinstall (d425056)

bootstrap (9a713df)

merge (2b1c5f1)

reinstall (5221600)

reinstall (147df55)

  • use correct versions (f1b5deb)

  • Add engines for all packages (e95dfff)

reinstall (afce1f2)

reinstall (67f3140)

  • Add to files (3338314)

Reinstall (a2abf51)

14.2.2 (2021-12-10)

Code Refactoring

  • ๐Ÿ’ก Change focus styles, remove whatinput (75fd31b) , closes #505205

  • rebuild and reinstall (f9fb687)

reinstall (885c74b)

  • fix changelogs manually (b1232b4)

reinstall (545a069)

reinstall (e149c2c)

13.12.3 (2021-11-09)


  • ๐Ÿงจ The scope for If Design System npm packages has now changed from @if-design-system to @ids-core. We have also renamed the repository from if-design-system to ids-core
  • ๐Ÿงจ Util is now renamed to Utils
  • ๐Ÿงจ We have now changed the navigation structure for the documentation site. Please update any saved links!
  • ๐Ÿงจ Navigation structure has now changed. Please see release notes!
  • ๐Ÿงจ The JS for the Tag Component is now in a separate scope: @ids-js/tag

Documentation Updates

  • โœ๏ธ Make variations tables more condensed (4344a3a)

  • โœ๏ธ Move position of the quick links (5cb0897)

  • โœ๏ธ Remove unneeded margins for shortcuts (36c7e8d)

  • โœ๏ธ Separate out CSS and JS documentation (1922124) , closes #467386

  • โœ๏ธ Update links and change navigation structure (0bfd27d) , closes #490579

Code Refactoring

  • ๐Ÿ’ก Categorize components (9965266) , closes #490579

  • ๐Ÿ’ก Reduce spacing tokens, use correct size tokens (97aa461)

  • ๐Ÿ’ก Rename scope and repository (3ea5423)

  • ๐Ÿ’ก Use new navigation structure for documentation (415aee5) , closes #490579

  • another change in the structure (38a0d2e)

Miscellaneous chores

  • ๐Ÿค– Prune changelogs (2c660c2)

  • ๐Ÿค– Rename util to utils (f78721f)

bootstrap (6fc1ed8)

  • fix all old references to util (d57bf17)

  • prepare for merge (0184490)

reinstall (da80dba)

  • Rename scope and repo (257684e)

  • use correct version for utils (49e72d9)

13.12.0 (2021-10-22)


13.11.0 (2021-10-19)


  • ๐ŸŽธ Input field hot reload (eac76b7)

13.9.2 (2021-09-30)

Bug Fixes

  • ๐Ÿ› Complete the pseudo-element fix (1dcee2c)

13.7.0 (2021-09-22)

Documentation Updates

  • โœ๏ธ Update linking layout and naming (15c383b)

13.6.3 (2021-09-17)

Bug Fixes

  • ๐Ÿ› Update repository urls (3dae3a3) , closes #465976

  • ๐Ÿค– Remove .gitignore, no longer needed (0a5a426)

  • ๐Ÿค– Use node v14 (4009973)

bootstrap (d23e139)

  • ๐Ÿค– Replace node-sass with dart-sass (078262c) , closes #434376

  • ๐Ÿค– Use correct order for diff (cc6a4fd)

12.14.1 (2021-08-12)

Miscellaneous chores

  • ๐Ÿค– Add ci task to package.json without tests (21222e0) , closes #457627

12.13.1 (2021-08-11)

Bug Fixes

  • ๐Ÿ› Whitelist docs dir for npm packaging (1a5cfd0) , closes #457621

  • ๐Ÿค– Remove .gitignore, use npm package.json files instead, ignore zip files for npm pack (49f0269) , closes #412081 . This will whitelist files to be used in "npm pack"

  • ๐Ÿค– Reinstall (e660696)

  • ๐Ÿค– Update published date (61e7ccf)

12.6.0 (2021-05-27)

Bug Fixes

  • ๐Ÿ› Manually set firstPublished and lastModified (e83af7d)

  • ๐Ÿ› We don't need lastModified (e458a12)

12.5.0 (2021-05-25)

Documentation Updates

  • โœ๏ธ Update documentation for supporting libs (180e161)

12.3.0 (2021-05-19)

Documentation Updates

  • โœ๏ธ Documentation fixes (ad1882a)

12.0.0 (2021-05-05)


  • ๐Ÿงจ All of the mixins have now been renamed
  • ๐Ÿงจ Notification is now renamed to Alert Banner
  • ๐Ÿงจ This extracts the Hero variation with no image into a separate, design updated component named Header
  • ๐Ÿงจ Footer is now renamed to Global Footer


  • ๐ŸŽธ Rename and extract and update hero with no image to (384eb77) , closes #336508 . Header component

Bug Fixes

  • ๐Ÿ› Update references (c08f107)

Code Refactoring

  • ๐Ÿ’ก Rename and consolidate mixins (67cf470) , closes #268081

  • ๐Ÿ’ก Rename Footer to Global Footer (7cb7239) , closes #336508

  • ๐Ÿ’ก Rename Notification to Alert Banner (8b4e48d) , closes #336508

Miscellaneous chores

  • ๐Ÿค– Convert util tokens from theo to style-dictionary (99fb4f5)

  • ๐Ÿค– Finalize breakpoint token conversion (f50ea0d)

  • ๐Ÿค– Reinstall (2c763ea)

  • ๐Ÿค– Reinstall (69e1a5b)

  • ๐Ÿค– Update all design token references (c640d15)

  • ๐Ÿค– Update references to util variables (b79ec36)

  • ๐Ÿค– Updating links (70f166e)

rebuild (7edb430)

  • ๐Ÿค– Rename Change Log to Changelog (d412e63)

10.0.1 (2021-02-17)

Miscellaneous chores

  • ๐Ÿค– ADd missing production build (0f1b8b3)

  • ๐Ÿค– Remove all references to sketch (35fc554) , closes #339203

  • ๐Ÿค– Update package fields (200c0af)

  • reinstall packages (fcfacf4)

7.1.0 (2020-11-16)


  • ๐ŸŽธ Add support for auto generation of components index (9444600) , closes #309650

6.43.3 (2020-11-03)

Miscellaneous chores

  • ๐Ÿค– Manually set version (e4d9ca6)

  • ๐Ÿค– Rename repository from guybrush to if-design-system (c18bccd)

reinstall (2cefe15)

6.36.0 (2020-10-12)


  • ๐ŸŽธ Add updated focus styling for tag (42f6e58)

  • ๐Ÿค– Rename focus style mixins (e18b688)

6.35.0 (2020-09-29)


  • ๐ŸŽธ Add input tags, update documentation (fa45ab8)

  • ๐Ÿค– Update preprocessor files for tag component (3324673)

6.33.0 (2020-09-28)


  • ๐ŸŽธ Add new component tag (b8aa099)
Edit this section, Opens in new window
Contact us, Opens in new window