2.2.5 • Public • Published

    Redis Contentful npm license

    A tiny library to map Contentful ☁️ space into Redis ⚡️

    Why should I care?

    Say your marketing team loves to update content without you being involved? Great! That is why you should use Contentful CMS. But wait, there is a catch. Contentful API sometimes takes ~800ms. And this is really a hit when you're having fancy SSR implemented to boost the performance of your Node JS app. As the creator of Gmail, Paul Buchheit had said "Every interaction should be faster than 100ms. Why? Because 100ms is the threshold where interactions feel instantaneous".

    This is where redis will help you crunch the rendering speed. It's really, really fast! A few ms is all it needs to get your data. By few, I mean less than 100ms 🚀

    redis-contentful maps your Contentful space's content types and their published records into your Redis server. It also maintains the schema of your Contentful space. All content types are stored in Redis as hashes. Under a particular hash, the record is stored as a key value pair with id being the record's key.

    You can sync the data manually by calling the sync method on redis-contentful instance manually or you can add a webhook in Contentful by exposing an endpoint on your server which will internally call sync. In this way, you always have the latest content from Contentful right in your Redis. So let's get started!


    npm install redis-contentful --save


    Create an instance of redis-contentful by passing contentful space ID & access token.

    import RedisContentful from 'redis-contentful';
    const client = new RedisContentful({
      redis: {
        database: 0, // Optional param, default - 0
        host: '', // Optional param, default -
        port: '', // Optional param, default - 6379
      contentful: {
        space: '',
        accessToken: '',
        locale: '', // Optional param, default - en-US
        identifier: '', // Identifier for searching custom keys,
        environment: '', // contentful environment, default is master



    Syncs the latest space content from Contentful and dumps it in your Redis server 🎉

    await client.sync();

    Send an optional boolean param to sync if you want to reset your redis cache ♻️

    await client.sync(true);

    get - directly from Redis 🚀

    Gets all data

    await client.get();

    Pass specific content type. It's an optional parameter.

    await client.get('about');

    Pass an array specifying the required content types

    await client.get(['about', 'title']);

    Pass an object to narrow down search

    await client.get({
      // Content type, it can also be an array
      type: '',
      // This will search identifier key for specified value
      search: '',

    You'll get an object with your content type ID's as keys and their values as array of content objects. If you specify a specific key, only that key will be returned in the final object.

        "<a-key>": [{}, {}, {}],
        "<yet-another-key>": [{}, {}]

    Custom keys in Redis

    Set, get & delete your custom key - value pairs in Redis

    await client.setCustom('avengers', '🤯');
    /* can set expire time in seconds. Third parameter is optional */
    await client.setCustom('Hulk', "I'm Hulk!", 60);
    await client.getCustom('avengers'); // 🤯
    await client.deleteCustom('avengers');

    Changing Redis DB

    // Sets DB to specified value, default is 0
    await client.setDB();


    Closes the connection to redis client.

    await client.close();

    Redis Store

    In Redis, the keys (entries) will be prefixed with their respective content type 🤓


    MIT ❤


    npm i redis-contentful

    DownloadsWeekly Downloads






    Unpacked Size

    16 kB

    Total Files


    Last publish


    • shreyas-a